Agent Skills
返回列表
🏢

写实现计划

企业运营 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/nic-yuan-superpowers-writing-plans-yuan-102。

技能介绍

问题:规格有了,执行者却仍在猜

很多团队把需求写进规格或 issue,真正动手的人仍要反复问「改哪个文件」「测试放哪」「这一步算不算做完」。若执行者是外包、新人,或只是很久没碰该仓库的资深开发,零代码库上下文会把计划变成口头传达,遗漏测试与文档,最后在同一文件上堆出难以 review 的巨型 diff。

技能在做什么

本技能按 Superpowers Writing Plans 流程产出一份可逐条执行的实现计划,默认读者「技术过关、品味与领域不熟、测试设计薄弱」。开写前会声明使用 writing-plans,并建议放在 brainstorming 建好的工作目录;成品保存到 docs/superpowers/plans/YYYY-MM-DD-*.md。

核心步骤包括:范围检查(多子系统则拆成多份独立可测计划)、文件结构映射(先定创建/修改哪些文件及职责,再拆任务)、小粒度任务(2–5 分钟一步:写失败测试 → 跑失败 → 最少实现 → 跑通过 → git commit),以及计划头部的固定任务结构示例(测试/实现/提交三段)。

硬性约束是 无占位符:禁止 TBD、TODO、「添加适当错误处理」「类似于任务 N」等;每步须带真实代码块与可执行的 bash。写完计划后做 自审:对照规格查缺口、扫占位符、核对类型/方法名跨任务一致。OpenClaw 场景下用特性分支替代 worktree;保存后可选子 Agent 逐任务执行或本会话顺序执行。

边界与注意

它产出的是实现计划文档,不代替 brainstorming 拆规格,也不自动写业务代码。若规格仍涵盖多个未拆子系统,应先回到 brainstorming 再写计划。计划质量取决于规格是否可逐条映射到任务;执行路径若选子 Agent,需配合 superpowers-subagent-dev 等配套技能。

使用场景

  • 把已有功能规格交给几乎没看过仓库的同事,需要列出每步改动的文件与对应测试
  • 多模块需求已在 brainstorming 拆成子规格,要为单一子系统写一份可独立交付的实现计划
  • 准备按 TDD 交付新接口,需要把「写失败测试—实现—提交」拆成 2–5 分钟可验收的小步清单
  • 计划写完后要自检是否存在 TBD 或与前面任务不一致的方法名,再交给他人或 subagent 执行

适合人员

  • 负责把产品/issue 规格落成工程任务的技术 lead,讨厌执行方来回问改哪些文件
  • 带外包或实习生改老项目,需要计划里直接给出测试代码块而非「补测试」一句带过
  • 采用 Superpowers 工作流、在 OpenClaw 上用特性分支隔离开发的维护者
  • 写完后要选「子 Agent 逐任务」或「本会话顺序执行」并衔接 finishing-branch 的交付负责人