writing-plans
Installation
SKILL.md
编写计划
概览
这是“只写计划、不执行”的兼容入口。撰写全面的实现计划,假设工程师对代码库零上下文:写明每个任务涉及的文件、代码、测试、文档和验证,并拆成一口大小的任务。DRY。YAGNI。TDD。按项目 Git 偏好设置验证检查点。
假设他们是熟练的开发者,但对我们的工具集或问题域几乎一无所知。假设他们对优秀的测试设计也不太熟悉。
开始时声明: "I'm using the writing-plans skill to create the implementation plan."
Context: 如果在隔离的 worktree 中工作,沿用当前 worktree,不要在写计划阶段切换目录。
Git 所有权
- 纯对话内规划不调用 Git skill。首次把 plan 写入仓库前,调用
git-workflow-preferences的prepare阶段;如果调用方传入了同一任务的完整 prepare 结果,先核对 branch/worktree 和已有修改仍一致,再复用。 - 计划中的阶段性提交写成 Git checkpoint;后续由 executing-plans 转交 do-scoped,并在验证通过后调用
git-workflow-preferences的checkpoint阶段。不要在计划中无条件硬编码 commit 或 push。 - plan 保存并完成自我审查后,在执行 handoff 前调用
git-workflow-preferences的finalize阶段,收口本次“创建计划”任务。