文档教程AI 技能【免费下载链接】claude-code-best-practicefrom vibe coding to agentic engineering - practice makes claude perfect项目地址https://gitcode.com/GitHub_Trending/cl/claude-code-best-practice点击查看免费下载/rpi:implement是 RPIResearch → Plan → Implement开发工作流中的最终执行环节Step 4负责把PLAN.md中的分阶段计划真正落到代码上并在每个阶段通过代码审查与用户验证门保证质量。读完本文你将掌握该命令的参数用法、Agent 编排机制、六步阶段循环、错误处理策略与完成报告规范能够在自己的仓库中直接复刻这套带验证门的分阶段实现工程实践。RPI 工作流全景implement 命令所处的位置RPI 是一套带验证门validation gates的系统化开发工作流完整链路为Describe描述→ Research研究→ Plan规划→ Implement实现其核心思想是在投入实现之前先做可行性研究GO/NO-GO 决策再产出详细规划文档最后才进入分阶段实现——每一步都有质量门防止浪费精力在不可行的功能上。整体流程可参考 RPI Workflow 总览 及其 流程示意图在 RPI 中每个功能的所有工作都收敛在rpi/{feature-slug}/目录下其中/rpi:implement的输出位置是rpi/{feature-slug}/implement/其完整目录结构如下rpi/{feature-slug}/ ├── REQUEST.md # Step 1: 初始功能描述 ├── research/ │ └── RESEARCH.md # Step 2: GO/NO-GO 可行性分析 ├── plan/ │ ├── PLAN.md # Step 3: 实现路线图分阶段、带验收标准 │ ├── pm.md # 产品需求文档 │ ├── ux.md # UX 设计文档 │ └── eng.md # 技术规格文档 └── implement/ └── IMPLEMENT.md # Step 4: 分阶段实现记录本命令产出/rpi:implement的定义文件位于 development-workflows/rpi/.claude/commands/rpi/implement.md与其上游命令/rpi:researchresearch.md和/rpi:planplan.md共同组成了完整的 RPI 命令族。命令定位与前置条件/rpi:implement是一个 Claude Code 自定义斜杠命令其 YAML frontmatter 如下--- description: Execute phased implementation with validation gates argument-hint: feature-slug [--phase N] [--validate-only] ---它要求从用户输入中必须解析出 feature slug即rpi/下的文件夹名并满足两个前置条件功能文件夹已存在rpi/{feature-slug}/规划已完成rpi/{feature-slug}/plan/PLAN.md存在PLAN.md由/rpi:plan命令生成包含分阶段的任务拆解、每个阶段的可交付物与验收标准详见 plan.md 中关于PLAN.md生成规范的说明。也就是说implement命令必须在plan完成之后才能运行它只负责执行不负责规划。命令行参数与 Flags命令支持三个可选参数用于控制执行范围参数作用使用注意--phase N只执行指定阶段1–8省略时从第 1 阶段开始可用于单阶段调试或断点续执行--validate-only只验证当前阶段不执行实现适用于已有代码的重新校验--skip-validation跳过验证门直接继续谨慎使用会绕过质量保障环节典型用法示例# 执行所有阶段从 Phase 1 开始 /rpi:implement my-feature # 只执行第 3 阶段 /rpi:implement my-feature --phase 3 # 只验证第 2 阶段不实现 /rpi:implement my-feature --phase 2 --validate-only从源码结构看该命令最多支持 8 个阶段--phase N的取值范围为 1–8这与/rpi:plan中将功能拆解为 3–5 个逻辑阶段、每阶段交付可测试功能的建议相呼应——阶段数由规划决定实现命令负责逐阶段执行。Agent 编排谁在什么环节干活/rpi:implement的核心设计是多 Agent 协作所有 Agent 统一使用Opus 模型以保证最高质量。命令将 Agent 分为两类实现 Agent主执行者Agent类型使用时机senior-software-engineerCustom自定义所有实现任务支持 Agent辅助角色Agent类型用途ExploreBuilt-in内置实现前的代码探索code-reviewerCustom自定义代码审查与质量验证constitutional-validatorCustom自定义对照项目宪法进行合规验证documentation-analyst-writerBuilt-in内置文档生成Agent 路由规则所有实现任务统一由senior-software-engineer处理其余 Agent 按阶段职能介入。这些 Agent 的定义文件就存放在 development-workflows/rpi/.claude/agents/ 目录下例如senior-software-engineer.md一名务实的独立贡献者IC遵循采纳 适配 发明原则以TDD 优先、小步可逆提交、保持边界干净的方式交付带理由与回滚说明的 PRcode-reviewer.md专注于正确性、清晰性、安全性与可维护性输出结构化的 CODE REVIEW REPORTconstitutional-validator.md从使命对齐、架构对齐、知识管理、人机协作模型、复杂度适配五个维度把关给出 APPROVED / APPROVED WITH CONDITIONS / NEEDS REVISION / REJECTED 四级裁决。Phase 0加载上下文与规则全局准备在任何阶段开始之前命令先执行 Phase 0 完成三类准备工作0.1 加载项目宪法Project Constitution——在仓库中查找 constitution 或 principles 文档若存在则提取技术约束类型安全、测试要求、组件隔离业务原则质量标准、工作流约定架构边界并将这些约束在实现期间强制执行。constitutional-validator的存在正是为了在执行链中持续校验这种对齐性。0.2 加载领域特定指南Domain-Specific Guidelines——根据待修改文件检查组件专属 README编码风格指南测试要求文档0.3 分析实现范围Implementation Scope——读取rpi/{feature-slug}/plan/PLAN.md识别所有待修改文件并将其映射到实现 Agent。Phase 0 的产出与验证清单宪法上下文摘要领域规则已加载文件到 Agent 的映射阶段执行计划- [ ] Constitution loaded (if exists) - [ ] Domain rules loaded for affected files - [ ] All files mapped to agents - [ ] Execution plan understood分阶段实现循环每阶段的六步流程命令的核心是按 PLAN.md 中的阶段逐个执行每个阶段都走一遍完整的六步循环┌─────────────────────────────────────────────────────────────────┐ │ Phase N: [Phase Name] │ ├─────────────────────────────────────────────────────────────────┤ │ │ │ 1. Code Discovery (Explore Agent) │ │ └─→ Understand existing code before changing it │ │ │ │ 2. Implementation (senior-software-engineer) │ │ └─→ Implement phase deliverables │ │ │ │ 3. Self-Validation │ │ └─→ Engineer validates against phase checklist │ │ │ │ 4. Code Review (code-reviewer Agent) │ │ └─→ Security, correctness, maintainability │ │ │ │ 5. User Validation Gate │ │ └─→ STOP and request user approval │ │ ├─→ PASS: Proceed to next phase │ │ ├─→ CONDITIONAL PASS: Note issues, proceed │ │ └─→ FAIL: Fix issues, re-validate │ │ │ │ 6. Documentation Update │ │ └─→ Update phase status in PLAN.md │ │ │ └─────────────────────────────────────────────────────────────────┘Step 1代码发现Code Discovery执行 AgentExplore内置通过 Task 工具调用subagent_typeExplore。目的在改动代码之前先把实现建立在对代码库现实的了解之上避免盲改。Explore 需要分析当前阶段受影响文件弄清现有模式、集成点和约束。命令内置了一份可直接复用的 Explore 提示词模板要求其调查并记录五类信息当前实现这些文件如何工作用了什么模式哪些函数/类会受影响集成点哪些其他文件导入或使用这些模块哪些 API/接口会变化哪些测试覆盖了这段代码依赖使用了哪些库有哪些内部工具可用当前代码存在什么约束待遵循的模式这些文件的编码风格、命名约定、错误处理模式是什么风险与考量改动可能破坏什么存在哪些边界情况向后兼容性担忧最终输出一份 discovery summary 供实现 Agent 使用。Step 2实现Implementation执行 Agentsenior-software-engineer接收 Step 1 的探索上下文实现该阶段的全部可交付物并遵循宪法约束与项目规则。命令提供了实现 Agent 提示词模板其核心要求是遵循探索阶段识别出的现有代码模式遵守宪法约束类型安全、测试等遵循项目特定规则如适用为新功能编写测试加入适当的日志优雅地处理错误质量清单包括代码遵循现有模式、类型注解齐全、测试编写并通过、不破坏既有功能、日志可观测、错误处理完备。Step 3自我验证Self-Validation执行 Agentsenior-software-engineer与 Step 2 相同。Agent 对照阶段清单自我验证运行 lint、执行相关测试、确认构建成功。命令预留了验证命令占位符需按项目实际情况替换# 运行 linter [your-linter-command] # 运行测试 [your-test-command] # 构建/编译 [your-build-command]自我验证清单所有可交付物已实现、lint 通过、测试通过、构建成功、既有测试无回归、宪法约束被遵守、领域规则被遵循。Step 4代码审查Code Review执行 Agentcode-reviewerCustom自动调用聚焦正确性、安全性、可维护性先解决阻塞问题再继续。审查提示词模板要求其关注正确性与测试、安全与依赖卫生、架构边界、清晰优于取巧并对照 Phase 0 加载的宪法约束给出标准格式的审查输出。依据 code-reviewer.md 的定义其输出为结构化报告包含 Verdict、Blockers文件:行号—问题—具体修复建议、High Priority、Medium Priority 与 Good Practices 五部分。审查裁决Review VerdictsAPPROVED进入用户验证环节APPROVED WITH SUGGESTIONS记录建议后继续NEEDS REVISION修复问题后重新审查Step 5用户验证门User Validation GateCRITICAL本步骤必须要求用户交互禁止自动继续。这是整个命令验证门思想的落点——AI 可以自动做探索、实现、自检、审查但每阶段完成后的放行权掌握在用户手中。命令要求向用户呈现完整的验证请求格式如下## Phase N Validation Request ### Deliverables Completed - [x] [Deliverable 1] - [implementation summary] - [x] [Deliverable 2] - [implementation summary] - ... ### Files Changed | File | Change Type | Lines | |------|-------------|-------| | [file] | [add/modify] | [±N] | ### Tests - [x] Unit tests: PASS - [x] Integration tests: PASS - [x] Build: SUCCESS ### Code Review - Verdict: [APPROVED / APPROVED WITH SUGGESTIONS] - Issues: [None / List] ### Validation Criteria (from PLAN.md) - [ ] [Criterion 1] - [ ] [Criterion 2] - ...用户可做的三种决定User DecisionsPASS阶段完成进入下一阶段CONDITIONAL PASS记录问题带谨慎继续FAIL指明需修复的问题重跑 Steps 2–5Step 6文档更新Documentation Update每阶段验证后必须同步两份文档更新rpi/{feature-slug}/plan/PLAN.md的阶段状态更新rpi/{feature-slug}/implement/IMPLEMENT.md的验证结果PLAN.md 阶段状态标记规范- [ ] Phase N: Not Started - [~] Phase N: In Progress - [x] Phase N: Validated (PASS) - [!] Phase N: Conditional Pass (with notes) - [-] Phase N: Failed Validation (needs rework)IMPLEMENT.md 记录模板# Implementation Record **Feature**: [feature-slug] **Started**: [Date] **Status**: [IN_PROGRESS / COMPLETED] --- ## Phase 1: [Phase Name] **Date**: [Date] **Verdict**: [PASS / CONDITIONAL PASS / FAIL] ### Deliverables - [x] [Deliverable 1] - [x] [Deliverable 2] ### Files Changed [List with line counts] ### Test Results [Test output summary] ### Code Review [Review verdict and notes] ### Notes [Any additional notes]每个阶段追加一份记录最终汇总出Phases Completed: N of N与最终状态。错误处理机制命令为四类典型失败场景预置了明确的降级策略实现失败Implementation Failures记录具体失败 → 分析根因 → 尝试替代方案最多 2 次→ 仍失败则停止并向用户求助绝不允许带着坏实现进入下一阶段。消息模板Implementation failed: [error]. Attempted [N] approaches. User guidance needed.测试失败Test Failures分析失败原因代码 bug 还是测试 bug→ 修复 → 重跑 → 持续失败则记录并询问用户。禁止在测试失败的情况下标记阶段完成。消息模板Tests failing: [failures]. Fix attempted but unsuccessful. User review needed.构建失败Build Failures依次检查类型错误、缺失导入、语法错误 → 修复并重建 → 仍失败则升级给用户。消息模板Build failing: [error]. Unable to resolve automatically.Agent 失败Agent Failures先用相同输入重试一次 → 仍失败则无该 Agent 参与的情况下继续并在验证请求中记录缺口。消息模板Agent [name] failed. Proceeding without contribution.这套错误处理的共同底线是AI 的自动化可以出错但质量门不能被静默绕过——涉及质量判定的失败必须显式暴露给用户。完成报告与质量门完成报告Completion Report全部阶段成功后命令输出一份完整的完成报告包含Feature Summary功能名、完成阶段数 N of NPhases Executed 表每阶段的状态PASS与备注Files Modified 表文件、变更类型、行数±NTests Added新增测试文件列表Code Review Summary修复的阻塞数、已处理的建议数Constitutional Compliance类型安全、测试、组件隔离、无破坏性变更Artifacts Created更新后的 PLAN.md 与全部阶段验证的 IMPLEMENT.md报告还内置了PR Notes 模板为收尾提供现成的 PR 素材**Title**: [{feature-slug}] [Brief description] **Summary**: [What was implemented] **Changes**: [List key changes] **Testing**: [How tested] **Rollout**: [Deployment steps] **Rollback**: [Rollback procedure if issues]Next Steps创建 PR → 请求最终人工审查 → 部署到 staging → 在 staging 验证 → 部署到生产。质量门Quality Gates每阶段质量门——标记任何阶段完成前必须全部勾选所有可交付物已实现lint 通过测试通过构建成功代码审查通过获得用户验证文档已更新最终质量门——标记实现完成前必须全部勾选所有阶段已验证无失败测试整体构建成功宪法合规已验证领域规则已遵循PR notes 已生成何时使用 / 何时不用命令明确划定了适用边界防止杀鸡用牛刀应该使用在/rpi:plan生成 PLAN.md 之后需要带验证门的分阶段实现时需要结构化实现的功能不应该使用Bug 修复过于沉重直接修复即可非常简单的变更少于 30 分钟的工作量探索性原型仅文档变更最佳实践清单先读 PLAN.md理解你在实现什么信任代码发现让 Explore Agent 为实现提供信息遵循现有模式让代码发现结果指导实现方式不要跳过验证门的存在是为了及早发现问题边做边记录每个阶段后立即更新状态卡住时提问宁可提问也不要错误地继续从 Agent 定义看这些实践与 senior-software-engineer.md 的工作循环高度一致澄清需求与验收标准、简短规划、TDD 优先小步提交、验证并交付带理由与回滚说明的 PR。上下文管理完成后务必 /compact命令特别强调实现工作流会消耗大量上下文。完成所有阶段或取得重大进展后必须主动提示用户压缩对话Context Management: This implementation workflow consumed significant context. To preserve progress and free up space, please run:/compactThis will summarize the conversation and preserve implementation status while reducing token usage for future work.触发 /compact 提示的时机所有阶段完成后每个主要阶段完成后如果是跨会话的多阶段实现实现过程中上下文即将耗尽时这与仓库 CLAUDE.md 中在约 50% 上下文占用时手动执行/compact将子任务拆小到可在 50% 上下文内完成的工作流经验一脉相承——多 Agent 分阶段编排天然是上下文密集型的及时压缩是保证长任务不断线的前提。小结把带验证门的分阶段实现落到自己的仓库/rpi:implement的本质是把一次大型 AI 实现任务拆解为探索 → 实现 → 自检 → 审查 → 用户放行 → 记录的循环让 AI 在质量闭环中逐阶段推进。要复刻这套实践只需将.claude目录包含agents/与commands/rpi/复制到自己的仓库根目录创建rpi/功能目录再依次运行/rpi:research、/rpi:plan、/rpi:implement即可。当每个阶段都经过 Explore 的代码发现、senior-software-engineer 的实现、code-reviewer 的审查与用户验证门的放行时AI 生成代码的质量就从一次性输出进化为受控交付——这正是该命令嵌入 RPI 工作流Step 4 of 4Describe → Research → Plan →Implement想要达成的工程目标。赞分享文档教程AI 技能【免费下载链接】claude-code-best-practicefrom vibe coding to agentic engineering - practice makes claude perfect项目地址https://gitcode.com/GitHub_Trending/cl/claude-code-best-practice点击查看免费下载相关推荐Claude Code Codex 跨模型工作流实战Claude 规划实现、Codex 质控验证的四阶段协作方法Claude Code Codex 跨模型工作流实战Claude 规划实现、Codex 质控验证的四阶段协作方法 在 claude code best p文档教程AI 技能Feature Development 插件实战用七阶段工作流在 Claude Code 中高质量落地新功能Feature Development 插件实战用七阶段工作流在 Claude Code 中高质量落地新功能 Feature Development 是 clAI 插件开发工具插件系统Claude Code Game Studios 中的 /code-review 技能九阶段架构级代码审查工作流实战指南Claude Code Game Studios 中的 /code review 技能九阶段架构级代码审查工作流实战指南 导读 /code review 是AI 技能/插件游戏开发AI 应用上一篇计算机考研408备考一份少走弯路的58份资源地图下一篇SierraDeathGenerator API参考完整JavaScript接口与事件系统文档创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考