Agent Skills
返回列表
✍️

实施计划撰写

内容创作 更新于 2026.08.30

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/shipshitdev-skills-writing-plans。

技能介绍

要解决什么问题

当你把需求交给零代码上下文的执行者(人或另一个 Agent)时,常见的交付物是一份含糊的「改这几个模块」或充满 TBD、implement later 的草案。执行端要么猜路径、要么跳过失败确认,计划与 Issue/PRD 也容易分家,CI 循环读不到「怎么做」。

技能如何工作

本技能把「写计划」当成可验收的文档工程,而不是头脑风暴纪要。

  • 范围切分(Scope Check):多个可独立部署的子系统应拆成多份计划,每份都能单独跑出可测软件;强耦合工作可共用一份。
  • 先映射文件(File Mapping):在列任务前写清将创建/修改哪些文件、各自单一职责;优先小文件、变更一起的文件放在一起,并尊重既有仓库分层习惯。
  • bite 级任务:一步只做一件事(写失败测试 → 跑失败 → 最小实现 → 跑绿 → git commit),严禁合并步骤或跳过失败确认。
  • 零占位符:路径完整、每步带完整代码块与精确命令及预期输出;测试必须先于实现;每任务以提交结束;遵守 DRY/YAGNI。
  • 自检清单:对照 spec 查漏、扫占位符、核对类型与命名跨任务一致。
  • 落库方式:计划以 Issue 评论发布,标题固定为 ## Implementation Plan,与 PRD 同在一条 Issue;超长则分 (n/m) 评论,不写入易脱节的 docs/plans/*.md。

交接时通过看板 gate(dispatch:claude / dispatch:codex)或会话内「每任务子 Agent / 顺序执行」两种路径,并强制逐任务勾选完成。

适用边界

适合「规格已定、需要可机械执行步骤」的工程交付;不适合只需高层路线图、或执行者已深度熟悉代码库且不需要 TDD 粒度的情况。无连接追踪器时,需先与用户约定计划唯一存放位置。

使用场景

  • PRD 已定,需要把需求拆成可在 Issue 上逐条勾选的 TDD 任务交给 Codex/Claude 循环执行
  • 多子系统需求要判断拆成几份独立计划,避免一份计划里混杂无法单独验收的模块
  • 修订现有仓库功能时,要先列出将改动的文件路径与职责,再写带完整代码的失败测试步骤
  • 计划写完后需按占位符扫描与命名一致性自检,再获批发布到 GitHub Issue 评论

适合人员

  • 负责把产品规格转成可派发工单的 Tech Lead,且执行端不共享你的仓库上下文
  • 在 GitHub Issue + 看板 gate 上驱动自动执行循环的维护者,需要计划与 PRD 同址可读
  • 写 Agent/子任务提示时希望每步含精确命令与预期输出、禁止 TODO 的实施规范维护者
  • 接手他人规格、测试习惯薄弱,需要按 2–5 分钟粒度逐步提交的实施工程师