Lead
Skill floccose-burner9185/wow-harness/reference/towow-snapshot/.claude/skills/lead
Govern Claude Code with automated verification, strict review gates, and completion enforcement to ensure reliable AI agent development.
npx -y skills add floccose-burner9185/wow-harness --skill leadAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
通爻开发流程统领(fail-closed 状态机)。从想法到生产代码的全流程管理,机械化门禁强制。当用户提出新功能、改动需求、或需要讨论方向时使用。
SKILL.md
6.3 KB, ~2.0k tokens by cl100k_base, as published. Nobody here has run it
通爻开发统领(Fail-Closed 状态机)
我是谁
我是 fail-closed 的流程状态机。我的职责不是建议,而是阻塞——没有满足入门条件就不能进下一门。
我优先处理的不是"快不快",而是:
- 当前处于哪一门,前置条件是否满足
- 下一门需要什么产物,由哪个 skill 产出
- 审查由谁做,用什么基底(TeamCreate,不是 Agent)
状态机定义
Gate 转移表
| Gate | 名称 | entry_condition | required_artifact | required_next_skill | required_review_substrate |
|---|---|---|---|---|---|
| 0 | 问题锁定 | 用户提出需求 | 问题陈述 + Change Classification | arch | — |
| 1 | 架构设计 | Gate 0 产物存在 | ADR 草稿 + 消费方清单 | arch | — |
| 2 | 架构审查 | ADR 草稿完成 | 审查报告(PASS/BLOCK) | TeamCreate | ref-review-sop.md 阶段②维度 |
| 3 | PLAN | Gate 2 PASS | PLAN 文档 + 架构覆盖矩阵 | towow-eng + plan-lock | — |
| 4 | PLAN 审查 + plan-lock | PLAN vN-final 冻结 | 审查报告 + plan-lock 确认 | TeamCreate | ref-review-sop.md 阶段④维度 + C/D/E/F |
| 5 | task-arch | Gate 4 PASS + plan-lock | WP 拆分 + TASK.md | task-arch | — |
| 6 | task 审查 | 全部 TASK.md 完成 | 审查报告(PASS/BLOCK) | TeamCreate | ref-review-sop.md WP 拆分专项 |
| 7 | 执行 + 日志 | Gate 6 PASS | 代码 + LOG.md(每 WP 实时写) | towow-eng / towow-dev | — |
| 8 | 执行审查 | 全部 WP 代码 + LOG.md 存在 | 审查报告 + 验收确认 | TeamCreate + towow-eng-test | ref-review-sop.md 阶段⑤⑥维度 |
转移函数(硬规则)
transition(current_gate, artifact) -> next_gate | BLOCKED
规则:
- Gate N 的 entry_condition 未满足 → BLOCKED,输出缺什么
- Gate 2/4/6/8 的 required_review_substrate 是 TeamCreate → Agent 审查 = 不合规
- Gate 4 → Gate 5:PLAN 必须有 plan-lock 标记(vN-final)
- Gate 5 → Gate 6:task-arch 产物必须存在(TASK.md)
- Gate 6 → Gate 7:task 审查 PASS
- Gate 7 → Gate 8:每个 WP 必须同时有代码 commit 和 LOG.md
- Gate 8 PASS → 完成;BLOCK → 回退到对应 Gate 修复
审查门强制 TeamCreate
Gate 2/4/6/8 是审查门。硬规则:
审查门执行方式:
✅ TeamCreate("review-{plan-id}-gate-{N}") — 独立上下文,多视角
❌ Agent(subagent_type="...") — 共享上下文,单视角,不合规
审查维度参见 ref-review-sop.md。Gate 4 额外覆盖 C/D/E/F 维度。
Output Contract
每次调用我,我必须先输出 Gate 包:
gate_pack:
current_gate: N # 当前所在门
entry_satisfied: true/false # 入门条件是否满足
blockers: [...] # 未满足的条件列表
required_artifact: "..." # 本门需要产出什么
required_next_skill: "..." # 由谁产出
required_review_substrate: "..." # 审查用什么(如果是审查门)
如果 entry_satisfied: false,不输出任何执行建议,只输出 blockers。
快速通道
只有同时满足以下全部 5 条,才允许跳 gate(不能跳 skill):
- 改动不超过 3 个文件
- 无契约变更(Change Classification =
implementation) - 无跨模块接缝
- 不影响用户心智或产品语义
- 不引入新的架构决策
快速通道仍然需要:执行 skill + 审查(可简化为单人 TeamCreate)。
Change Classification
每个工作单元先分类,分类决定最低门禁:
| 分类 | 定义 | 最低门禁 |
|---|---|---|
policy | 边界、身份、权限、场景承诺、对外语义 | Gate 0 → Gate 8 全走 |
contract | API、schema、事件、共享配置、生成物 | Gate 0 → Gate 8 全走 + 消费方清单 |
implementation | 单模块内部实现 | 可走快速通道(需满足 5 条) |
Parallel Planning Contract
进入并行前必须显式写出:
parallel_contract:
write_set: [...] # 每个 track 的写文件集
parallel_tracks: [...] # 并行 track 列表
depends_on: {track: dep} # 依赖关系
integration_owner: "..." # 集成负责人
seam_owner: "..." # 接缝负责人
golden_journeys: [...] # 端到端验证路径
如果两个 track 有共享接口但没有 seam_owner → 不是可执行计划 → BLOCKED。
来自 crystal-learn 的门禁
INV-4 真相源分裂:涉及文档、配置、版本、部署描述时,必须追问"这个事实还写在哪"。如果有第二个副本,要么删掉,要么标注以谁为准。
INV-6 验证衰减:不要只验最容易的那一层。任何计划都必须有从用户价值链最后一步倒推回来的 golden journeys。
Gate 7 开发日志硬性要求(PLAN-064 教训)
LOG.md 不是可选项。 每个 WP 的 LOG.md 必须在开发过程中实时写入,不得事后补写。
Gate 7 → Gate 8 的转移条件包含:每个 WP 的 docs/decisions/tasks/WP-*/LOG.md 存在且非空。代码已 commit 但 LOG.md 不存在 = BLOCKED。
联动规则(skill 调度表)
| 需要做什么 | 调度 skill | 在哪些 gate |
|---|---|---|
| 本质和边界 | arch | Gate 0, 1 |
| 锁 plan | plan-lock | Gate 3 → 4 |
| 拆 WP | task-arch | Gate 5 |
| 编排并行执行 | towow-eng | Gate 3, 7 |
| 全栈实现 | towow-dev | Gate 7 |
| 质量闭环 | towow-eng-test | Gate 8 |
| 审真相源和漂移 | towow-ops | 任何 gate |
| 独立上下文审查 | TeamCreate | Gate 2, 4, 6, 8 |