企业官网建设流程全解析

Validation Report

【免费下载链接】claude-code-hooks-masteryMaster Claude Code Hooks项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-hooks-mastery

Task: [task name/description]Status: ✅ PASS | ❌ FAIL

Checks Performed:

• [check 1] - passed
• [check 2] - passed
• [check 3] - FAILED: [reason]

Files Inspected:

• [file1.ts] - [status]
• [file2.ts] - [status]

Commands Run:

• [command]- [result]

Summary: [1-2 sentence summary of validation result]

Issues Found(if any):

• [issue 1]
• [issue 2]

这个模板的每一节都有明确的工程意图： - **Status**：最顶层的二元结论，`✅ PASS` / `❌ FAIL`，让 team lead 无需阅读全文即可判断该任务是否达标； - **Checks Performed**：以 checkbox 形式逐条列出检查项与结果，失败的检查项必须附 `FAILED: [reason]` 原因； - **Files Inspected**：列出检查过的文件及其状态，形成可追溯的审查足迹； - **Commands Run**：记录执行过的验证命令与结果，便于复现与排障； - **Summary**：1～2 句话的结论摘要； - **Issues Found**：失败场景下的问题清单，供 team lead 决定是重新派发 Builder 修复还是调整任务。 ## Validator 与 Builder 的配对机制 要真正理解 Validator，必须同时看它的搭档 [builder.md](https://link.gitcode.com/i/696f3946131677a3cd54f713df337967)。两个代理形成完整的"构建—验证"闭环： | 维度 | Builder | Validator | | --- | --- | --- | | 职责 | 执行：写代码、建文件、实现功能 | 检查：核对验收标准、运行只读验证 | | 工具 | 全部工具（可写可改） | 只读（`disallowedTools: Write, Edit, NotebookEdit`） | | 模型 | `opus` | `opus` | | 终端颜色 | `cyan` | `yellow` | | 收尾动作 | `TaskUpdate` 标记 `completed` + 实现摘要 | `TaskUpdate` 标记 `completed` + 验证报告 | 一个非常关键的细节在 Builder 的 frontmatter 中——**Builder 自身也挂载了自动化代码质量钩子**： ```yaml hooks: PostToolUse: - matcher: "Write|Edit" hooks: - type: command command: >- uv run $CLAUDE_PROJECT_DIR/.claude/hooks/validators/ruff_validator.py - type: command command: >- uv run $CLAUDE_PROJECT_DIR/.claude/hooks/validators/ty_validator.py ``` 也就是说，质量保障是**两层**的： 1. **自动化层（Builder 自校验）**：Builder 每次 Write/Edit 后，[ruff_validator.py](https://link.gitcode.com/i/807e068e247fc45a6923f46506f34f66) 与 [ty_validator.py](https://link.gitcode.com/i/06afc43bae3e260f8139a1ad0e93f3f1) 立即运行。以 [ruff_validator.py](https://link.gitcode.com/i/807e068e247fc45a6923f46506f34f66) 为例，它从 PostToolUse 的 stdin JSON 中取出 `tool_input.file_path`，仅对 `.py` 文件执行 `uvx ruff check`，失败时输出 `{"decision": "block", "reason": "..."}` 阻止继续（详见 README 的 Code Quality Validators 一节）； 2. **人工层（Validator 验证）**：构建完成、自动化钩子放行之后，Validator 再做一次聚焦验收，确认任务真正满足验收标准。 这种双层设计把"低级的语法/类型错误"交给确定性钩子拦截，把"任务是否达成目标"的判断留给只读验证代理，各司其职。 ## 在团队编排中部署 Validator Validator 不是孤立存在的，它在团队化工作流中被成对批量部署。[plan_w_team.md](https://link.gitcode.com/i/9cdd46f99a68164a83119fb7104dbf96) 是这套编排的入口——它是一个"模板元提示词"，接收用户需求后生成包含 Team Members、Step by Step Tasks、Acceptance Criteria、Validation Commands 的完整实施计划，并保存到 `specs/` 目录（其自校验由 `validate_new_file.py` 和 `validate_file_contains.py` 两个 Stop 钩子保证计划文件格式达标）。 [specs/hooks-update-with-team.md](https://link.gitcode.com/i/830d77a26bfa572f93105fa3d05434b9) 是这套编排的真实产物，展示了典型的部署模式： ```yaml - Builder (SessionEnd Hook) - Name: session-end-builder - Agent Type: builder - Resume: true - Validator (SessionEnd Hook) - Name: session-end-validator - Role: Validate SessionEnd hook works correctly using `claude -p` and log verification - Agent Type: validator - Resume: true ``` 其中蕴含三条编排规则： 1. **一构建一验证**：每个功能模块都部署一对 builder/validator，例如 session-end、permission-request、post-tool-use-failure、subagent-start、setup 各有独立配对； 2. **依赖关系串行化**：验证任务的 `Depends On` 指向对应的构建任务（例如 `validate-session-end` 依赖 `build-session-end`），`Parallel: false`；而互不依赖的构建任务可以 `Parallel: true` 并行推进； 3. **收尾聚合验证**：最终由 validator 承担 `integration-test` 与 `validate-all` 两个总验证任务——用 `claude -p 'echo hello'` 触发全部钩子、核对 `logs/` 下所有 JSON 日志、确认验收标准全部达成后输出最终报告。 ``` <img src="images/cctask.png" alt="Claude Code Task 系统：Builder/Validator 团队化任务编排界面" style="max-width: 800px; width: 100%;" /> ``` 上图展示了 Claude Code 的 Task 系统界面，team lead 通过 `TaskCreate`/`TaskUpdate`/`TaskList`/`TaskGet` 与 `Task` 工具调度这些 builder/validator 成员：创建任务、设置 `addBlockedBy` 依赖、指定 `owner`、部署 `subagent_type` 并可用 `resume` 保留上下文续做，任务完成时受阻塞的任务会自动解锁（详见 [plan_w_team.md](https://link.gitcode.com/i/9cdd46f99a68164a83119fb7104dbf96) 的 Orchestration Workflow）。 ## 实际运行与验证示例 结合 [hooks-update-with-team.md](https://link.gitcode.com/i/830d77a26bfa572f93105fa3d05434b9)，一个完整的 Validator 验证流程在实战中长这样： **场景**：验证 SessionEnd 钩子构建是否达标。 1. 通过 `TaskGet` 读取 `build-session-end` 任务的验收标准（钩子文件存在、覆盖全部 reason 类型、日志落盘）； 2. 检查文件：确认 `.claude/hooks/session_end.py` 存在，符合 `#!/usr/bin/env -S uv run --script` 的 uv 单文件脚本模式（README 的 UV Single-File Scripts Architecture 一节说明了这种架构的隔离性与可移植性）； 3. 运行验证命令： ```bash uv run python -m py_compile .claude/hooks/session_end.py

【免费下载链接】claude-code-hooks-masteryMaster Claude Code Hooks项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-hooks-mastery