计划撰写
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-02qudk26/plan-writing。
技能介绍
要解决什么问题
复杂需求、新功能或跨文件重构时,常见计划要么堆成几十条微步骤、要么写成「搭建项目」「加认证」这类无法验收的条目。Agent 或人类执行时缺少可验证的完成标准,计划还容易塞进 .claude/、docs/ 等临时目录,和代码库脱节。
技能如何工作
本技能来自 obra/superpowers 思路:用原则约束计划形态,而不是固定模板。核心是四条拆解规则:
- 小而聚焦:单任务约 2–5 分钟,一个清晰结果,可独立验证
- 清晰验证:写清「怎么算完成」——可检查什么、期望输出是什么
- 合理排序:识别依赖、能并行则并行;验证步骤放在阶段末尾
- 动态命名:计划文件放在项目根目录,命名为
{task-slug}.md(如add auth→auth-feature.md),不要放进.claude/或临时文件夹
写作上强调:计划控制在 5–10 个任务、一页以内;任务要具体(如 运行 npx create-next-app),而非笼统描述;内容随新项目 / 功能 / Bug 类型变化;验证步骤要可执行(如 curl localhost:3000/api/users 返回 200)。若项目有审计脚本,只列与本次改动相关的脚本,不要每份计划粘贴全套命令。
适用边界
适合从零立项、加功能、复杂 Bug、多文件重构。简单单行修复不必强行写计划。技能明确:没有固定模板,计划应随任务唯一;完成时可把条目标为 [x] 并随进度更新。
使用场景
- 从零启动项目时,先确定技术栈与 MVP,再在仓库根目录写 `{task-slug}.md`,把立项拆成可独立验证的小步。
- 为现有代码库新增功能(如 next-auth),把安装、改哪些文件、如何点测或 curl 写成 5–10 条具体任务。
- 复杂 Bug 涉及多文件时,在计划里写清根因、目标文件/行与回归方式,验证步骤放在列表最后。
- 多文件重构前,列出依赖与并行项,避免 50 条微步骤,保持一页内可执行计划并随进度勾选 `[x]`。
适合人员
- 要把 Epic 拆成 Agent 能逐步执行、且每条都能自证完成的全栈或 feature 负责人
- 习惯在仓库根用 Markdown 留计划、不愿把文档丢进 `.claude/` 或临时目录的仓库维护者
- 修 API 或后端问题时,需要在计划里写具体命令(如 curl 期望状态码)而非「测一下接口」的后端开发
- 接新功能或重构前,希望控制任务粒度在 2–5 分钟、总数不超过 10 条的一线开发