ARTICLE DETAIL

资讯详情

深耕网站视觉设计与运营推广的一线实战洞察。

从需求到实施路线图:用 `/create-plan` 命令构建 AI 编码工作流中的可执行实现计划

从需求到实施路线图:用 `/create-plan` 命令构建 AI 编码工作流中的可执行实现计划 文档教程提示工程人工智能【免费下载链接】context-engineering-introContext engineering is the new vibe coding - its the way to actually make AI coding assistants work. Claude Code is the best for this so thats what this repo is centered around, but you can apply this strategy with any AI coding assistant!项目地址https://gitcode.com/gh_mirrors/co/context-engineering-intro点击查看免费下载导读在 AI 编码工作流中最危险的时刻往往不是写代码而是想清楚要做什么。/create-plan是 ai-coding-workflows-foundation 框架中位于规划阶段Phase 1: Planning末端的斜杠命令它接收一份需求文档通常是 INITIAL.md 形式的 PRD通过系统化的研究、分析与设计产出一份结构完整、可直接交给/execute-plan执行的实现计划Implementation Plan。阅读本文后你将掌握该命令的完整执行协议、PRP 计划文档的规范结构以及如何用codebase-analyst子代理和 Archon RAG 为计划注入源码级证据。命令定位/create-plan在三阶段框架中的角色ai-coding-workflows-foundation将 AI 辅助开发组织为Planning规划→ Implementation实施→ Validation验证三阶段闭环。其中规划阶段依次包含/primer开启氛围规划Vibe Planning面向新项目做线上资料调研或面向既有项目做代码库摸底编写 INITIAL.md沉淀为产品需求文档PRDINITIAL.md 给出了该文档的模板骨架FEATURE / EXAMPLES / DOCUMENTATION / OTHER CONSIDERATIONS上下文工程组件准备RAG、任务管理、记忆系统、提示词工程/create-plan把需求转化为结构化实施策略Plan of Attack。/create-plan是规划阶段的收口动作其输出直接作为/execute-plan的输入——两个命令通过PRPs/[feature-name].md文件完成交接。该命令的元信息见 create-plan.md 头部声明了description从需求文档出发通过广泛研究生成一份全面实现计划argument-hint[requirements-file-path]即调用时需传入需求文档路径。五步执行协议从需求文档到计划产出/create-plan将整个规划过程拆解为 5 个步骤每一步都对应明确的可交付物。Step 1阅读并分析需求Read and Analyze Requirements读取$ARGUMENTS指定的需求文档并提取以下维度核心功能请求与目标Core feature requests and objectives技术需求与约束Technical requirements and constraints预期结果与成功标准Expected outcomes and success criteria与现有系统的集成点Integration points with existing systems性能与可扩展性要求Performance and scalability requirements提到的具体技术栈或框架。这一步是后续所有工作的基准需求理解不完整计划就必然失真。命令要求提取并理解而非简单摘抄意味着需要在计划中显式复述需求摘要供执行阶段校验。Step 2研究阶段Research Phase研究阶段分为三条并行线索2.1 Web 研究适用时搜索目标功能的最佳实践、查阅涉及技术的官方文档、寻找相似实现或案例、研究常见模式与架构、考察可用的库或工具。2.2 知识库检索如配置了 Archon RAG当 Archon RAG 可用且相关时依次调用mcp__archon__rag_get_available_sources()查看可用的文档源mcp__archon__rag_search_knowledge_base(query...)检索相关模式mcp__archon__rag_search_code_examples(query...)查找代码示例。研究焦点应落在实现模式、最佳实践与相似功能上而不是泛泛浏览。2.3 既有代码库分析针对存量项目命令明确要求——优先使用codebase-analyst子代理进行深度模式分析通过 Task 工具启动该代理让其分析架构模式、编码约定、测试方法、相似实现。对于快速检索也可以直接使用 Grep 查找具体特性、识别项目结构与约定、定位相关模块、理解既有架构与设计模式、寻找新功能的集成点、检查可复用的工具函数。Step 3规划与设计Planning and Design基于研究结果计划必须包含三个层次3.1 任务分解Task Breakdown创建按优先级排序的实现任务清单要求每个任务具体、可操作任务粒度适当不要过大也不要过碎标注任务间依赖按实现流程逻辑排序。3.2 技术架构Technical Architecture定义技术方案包括组件结构与组织、数据流与状态管理、API 设计如适用、数据库 schema 变更如需要、与既有代码的集成点。3.3 实现参考Implementation References记录关键实现资源——可参考或需修改的既有代码文件、所用技术的文档链接、研究得到的代码示例、代码库中应遵循的模式、需新增的库与依赖。Step 4生成计划文档Create the Plan Document将完整计划写入PRPs/[feature-name].mdPRPs 即 Product Requirements Plans 目录模板见 prp_base.md完整示例见 EXAMPLE_multi_agent_prp.md。文档结构规范详见下一节。Step 5校验Validation定稿前完成五重自检所有需求均已覆盖任务排序正确集成点已识别研究结论能支撑技术方案计划可执行、清晰。计划文档规范结构PRPs 文件的骨架解剖/create-plan要求产出文档遵循固定骨架下面逐节说明n 表示任意数量# Implementation Plan: [Feature Name] ## Overview [将要实现内容的简述] ## Requirements Summary - [关键需求 1] ... [关键需求 n] ## Research Findings ### Best Practices # 研究结论最佳实践清单 ### Reference Implementations # 参考实现含链接/位置 ### Technology Decisions # 技术选型与理由 ## Implementation Tasks # 按 Phase 分组每组内含编号任务 ### Phase 1: Foundation 1. **Task Name** - Description: [做什么] - Files to modify/create: [涉及文件] - Dependencies: [前置条件] - Estimated effort: [时间估算] ### Phase 2: Core Implementation ### Phase 3: Integration Testing ## Codebase Integration Points ### Files to Modify # 需修改文件及改动说明 ### New Files to Create # 需新建文件及用途 ### Existing Patterns to Follow # 应遵循的既有模式 ## Technical Design ### Architecture Diagram (if applicable) # ASCII 图 ### Data Flow # 数据流描述 ### API Endpoints (if applicable) ## Dependencies and Libraries ## Testing Strategy # 单元/集成/边界用例 ## Success Criteria # 勾选式验收清单 ## Notes and Considerations # 备注、潜在挑战、未来增强文档末尾固定以*This plan is ready for execution with \/execute-plan* 收尾与执行命令形成交接契约。值得注意的是这一结构与 prp_base.md 的 Implementation Blueprint / Validation Loop 理念一致PRP 模板强调上下文为王、验证闭环、信息密集、渐进成功而计划文档中的 Testing Strategy 与 Success Criteria 正是验证闭环的落点。实战注意从模板到真实计划的三个要点结合仓库中 EXAMPLE_multi_agent_prp.md 的实际写法可以提炼出高质量计划的共同特征1. 用文件级任务替代抽象描述。示例中的每个任务都形如CREATE agents/research_agent.py: - PATTERN: Follow examples/agent/agent.py structure即任务不仅说明做什么还指明参考哪个既有文件、遵循哪种模式。这与codebase-analyst的输出风格Be specific - point to exact files and line numbers一脉相承。2. 显式记录 Gotchas已知坑。示例计划在 Known Gotchas Library Quirks 中列出诸如 Pydantic AI requires async throughout、Gmail API requires OAuth2 flow on first run 等库级陷阱这些信息在实现阶段能显著减少返工。计划文档中的 Notes and Considerations 应同样承担这一职责。3. 为每个任务附上伪代码或集成点示例。示例为 Brave Search 工具给出了带timeout30.0、结构化错误处理的伪代码为多代理调用给出了ctx.usage传递模式——伪代码的价值在于把关键细节锁定避免实现时走偏。与/execute-plan的衔接计划的生命周期终点/create-plan的产出不是终点而是起点。execute-plan.md 定义了计划的消费方式两者构成闭环任务入账/execute-plan要求先把计划中的每个任务在 Archon 中创建mcp__archon__manage_task(create, ...)初始状态todo保持计划的顺序与优先级——这正对应计划文档的 Implementation Tasks 章节单任务流转任一时刻只有一个任务处于doing状态完成后置为review验证通过后才置为done——对应计划文档的 Success Criteria 与 Testing Strategy验证兜底全部任务进入review后启动validator子代理编写并运行单元测试。计划文档若预先写清测试策略与边界用例验证阶段会顺畅得多。可见/create-plan产出的每一节都在为执行与验证阶段提供输入Implementation Tasks驱动 Archon 任务流Testing Strategy指导 validatorSuccess Criteria定义完成的判定标准。关键原则速查命令在 Important Guidelines 中给出了六条铁律可直接作为计划质量检查表Be thorough in research计划质量取决于对最佳实践的理解深度Keep it actionable每个任务必须清晰、可实现Reference everything包含链接、文件路径与示例Consider the existing codebase遵循既有模式与约定Think about testing计划中必须包含测试任务Size tasks appropriately任务粒度适中既不过大也不过细。产出与下一步命令完成后的标准输出为Implementation plan created at: PRPs/[feature-name].md You can now execute this plan using:/execute-plan PRPs/[feature-name].md也就是说一份合格计划的最终判据是它能被/execute-plan无歧义地消费。当你写出的 PRP 文档满足任务可拆分、参考可定位、测试可执行、标准可勾选这四项时/create-plan就真正完成了它的使命——把模糊的需求愿景变成 AI 可以逐行落实的施工蓝图。赞分享文档教程提示工程人工智能【免费下载链接】context-engineering-introContext engineering is the new vibe coding - its the way to actually make AI coding assistants work. Claude Code is the best for this so thats what this repo is centered around, but you can apply this strategy with any AI coding assistant!项目地址https://gitcode.com/gh_mirrors/co/context-engineering-intro点击查看免费下载相关推荐用 create-plan 命令把需求文档转化为可执行实现计划claude-agent-sdk-demos 的 PRP 规划工作流实战用 create plan 命令把需求文档转化为可执行实现计划claude agent sdk demos 的 PRP 规划工作流实战 导读 本篇文章围绕 c示例工程SuperClaude Framework 的 /sc:workflow 实现工作流生成器从 PRD 到可执行实施计划的编排实践SuperClaude Framework 的 /sc:workflow 实现工作流生成器从 PRD 到可执行实施计划的编排实践 导读 /sc:workflo开发工具CLIAI 技能/插件测试人工智能AI 评测用 Archon 任务管理驱动 AI 编码计划执行/execute-plan 命令实战指南用 Archon 任务管理驱动 AI 编码计划执行 /execute plan 命令实战指南 导读 本指南以 use cases/ai coding work文档教程提示工程人工智能创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表