用途
Create Plan 用于把产品需求文档(PRD)转化为一份或多份自包含的执行计划(ExecPlan)。PRD 定义要构建什么以及为什么,而 ExecPlan 定义如何构建——即文件编辑、要运行的命令和要观察的输出的确切顺序。该技能的目标是让一个无状态的智能体仅阅读 ExecPlan 文件(没有先前对话记忆、无法访问 PRD、没有外部文档)就能产出可运行、可观察的结果。
主要能力
- 从 PRD 文件生成自包含、可由智能体执行的 ExecPlan。
- 支持根据范围生成单个 ExecPlan 或多个 ExecPlan(默认每个 epic 一个计划)。
- 在编写计划前调研代码库,识别确切的文件路径、函数名、模块边界和现有模式。
- 按骨架模板填充 ExecPlan 的各个必需部分,包括标题、活文档声明、目的/大局、进度、意外与发现、决策日志、结果与回顾、上下文与定位、工作计划、具体步骤、验证与验收、幂等性与恢复、产物与笔记、接口与依赖。
- 提供自审清单,确保计划自包含、新手可访问、以结果为导向、幂等、经过验证且具备活文档结构。
- 按命名约定保存 ExecPlan 文件,并向用户总结。
使用方式
该技能按以下步骤运行:
- 定位并阅读 PRD:向用户询问 PRD 文件路径(若未提供),通读全文,特别关注 epic 与阶段计划、验收标准、技术栈决策、构建/运行/验证命令、架构与仓库边界、非目标与禁止方法。若 PRD 存在未解决的歧义日志,先向用户标记。
- 决定计划结构:根据范围选择每个 epic 一个 ExecPlan,或整个 PRD 一个 ExecPlan。若不明显,询问用户偏好。生成多个 ExecPlan 时,每个都必须完全自包含。
- 调研代码库:阅读相关源文件,识别确切文件路径、函数名、模块边界,记录代码库遵循的模式,检查现有测试。
- 编写 ExecPlan:使用 references/exec-plan-guidelines.md 中的骨架作为结构主干,填充每个必需部分。
- 自审 ExecPlan:对照自包含、新手可访问、以结果为导向、幂等、经过验证、活文档就绪等标准检查,不通过则修正。
- 写入文件:保存为 .md 文件。单个计划保存为项目根目录的 PLAN.md(或用户指定位置);多个计划保存为 plans/PLAN-E<N>-<short-name>.md。写入时省略外层三反引号围栏,内部命令、记录或代码片段使用缩进块。
- 向用户总结:说明创建了多少 ExecPlan、保存位置、每个计划的里程碑、需要用户验证的假设,以及执行前需要解决的 PRD 歧义。
适用场景
- 用户希望“创建计划”“生成执行计划”或把 PRD 转化为可执行步骤时。
- 需要让编码智能体或新手在没有先前上下文的情况下端到端执行开发任务时。
- 需要把 PRD 中的验收标准转化为具体、可运行的检查时。
- 需要为多个独立可交付的 epic 分别生成自包含计划时。
限制
- 该技能依赖 PRD 文件作为输入;若 PRD 存在未解决的歧义,需先向用户标记,否则会在 ExecPlan 中变成危险的猜测。
- ExecPlan 必须自包含,不能引用“PRD”“架构文档”或“如前所述”等外部内容。
- 计划步骤必须具体、可复制粘贴、可验证且幂等;模糊步骤或仅内部验收不被接受。
- 活文档部分(进度、意外与发现、决策日志、结果与回顾)不是可选的,必须在工作推进过程中保持更新。
- 关于收费、价格、平台支持等具体信息暂未提供。