实施计划撰写
将以下提示词粘贴到你的 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 分钟粒度逐步提交的实施工程师