SuperAPI AI 工具集

dev-plan

编程与开发

查看项目

更新于 10-15 19:56

技能介绍

用途:为待开发的新功能编写结构化 PRD 文档。唯一交付物是写入 $PROJECT_ROOT/.dev/$FEATURE_NAME/ 的 PRD 文件,不写代码,每次会话都必须落盘文件。它与 /dev-checkpoint、/dev-resume 组成三技能工作流,另两个技能依赖 PRD 中的状态标记、阶段门、文件变更摘要与子 PRD 链接来解析进度。

主要流程:Step 0 运行 bash "$DISCOVER" root 发现项目根目录,存为 $PROJECT_ROOT;每条命令需给出完整脚本路径,路径用 $HOME 而非字面家目录,复用输出值时逐字复制,非零退出须停下报告。随后校验功能名:bash "$VALIDATE" normalize "<candidate-name>" 生成 $FEATURE_NAME,失败即停。Phase 1 理解需求,回答三个问题(要建什么功能、解决什么问题、有无参考实现);有参数则自行推断并直接进入 Phase 2,无参数则提问并等用户确认。可选 Phase 1.8 查看 $HOME/.dev-wiki/index.md 中是否有可复用先例。Phase 2 并行启动 2-3 个 prd-researcher 代理(subagent_type=dev-workflow:prd-researcher)调研可复用模式、架构约束与依赖、需修改文件,汇总后等用户确认。Phase 3 启动 1 个 prd-planner 代理设计实现阶段,确认架构后创建文件:必有 00-master-plan.md,复杂功能另建 01-sub-prd-[name].md,模板见 prd-templates.md。步骤用 ⬜ 标记待办,其他 emoji 会被视为未识别状态。步骤只在一处跟踪,不要主计划与子 PRD 重复列同一批步骤。最后运行 node "$CLI" feature-show --json --dir "$PROJECT_ROOT/.dev/$FEATURE_NAME" 校验可解析。

限制:遵循一轮调研即写作,不无限调研;调研结论并入主计划的 Research Findings 段,不另建 findings.md。PRD 中禁止出现含用户名的绝对路径、密钥令牌凭据与个人信息,改用相对路径和占位符(如 <API_KEY>、$ENV_VAR)。