claude-howto 实战用 Claude Code 打造 Implementation Agent 全栈功能实现型子代理【免费下载链接】claude-howtoA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-howto本文以 claude-howto 仓库中可直接取用的 Implementation Agent 子代理定义 为核心讲解如何用 Claude Code 的 Subagent 机制定义一个从规格到实现、自带读写编辑与构建测试的全栈功能实现代理并给出其执行流程、编码规范、输出契约与部署到项目的完整方法帮助你搭建真正可用的功能开发流水线。Implementation Agent 是 claude-howto 仓库 04-subagents 目录中九大可复用示例子代理之一。它不是一份泛泛的提示词模板而是一个带 YAML frontmatter、具备完整工具权限与明确行为约束的 agent 定义文件——把它放入项目的.claude/agents/后Claude Code 即可在合适时机自动委派或由你显式点名调用承担读需求 → 写代码 → 跑构建 → 自查清单的端到端实现工作。读完本文你将掌握如何理解与自定义该 agent 的 frontmatter、六步实现流程如何在运行时驱动 agent 行为、它的输出格式与检查清单如何保证交付质量以及如何将其与同目录下的测试、调试、审查类子代理组合成完整协作链路。一、Implementation Agent 是什么一个完整的子代理定义文件在 Claude Code 中子代理Subagent是一类独立的 AI 助手拥有与主对话隔离的上下文窗口、定制化的系统提示词、以及可配置的工具权限。主代理Main Agent可以将子任务委派给子代理执行结果蒸馏后返回主会话从而避免长任务污染主上下文。详见仓库的子代理完整参考指南。Implementation Agent 的定位正如其 frontmatter 中的description所述——全栈实现专家服务于功能开发具备端到端实现所需的完整工具访问权限。仓库中同时维护着它的日文版与英文原版两份定义文件二者内容一致可直接对照阅读。--- name: implementation-agent description: Full-stack implementation specialist for feature development. Has complete tool access for end-to-end implementation. tools: Read, Write, Edit, Bash, Grep, Glob model: inherit ---关键 frontmatter 字段解读字段值作用nameimplementation-agent子代理唯一标识符供显式调用与委派匹配description功能实现的描述文本主代理据此判断何时自动委派该子代理toolsRead, Write, Edit, Bash, Grep, Glob白名单式工具授权只授予写实现所需的最小集modelinherit继承父会话模型不额外指定费用/能力档位六项工具权限制约了什么tools字段是全栈实现能力的技术边界理解每项工具的语义才能判断该 agent 能做什么、不能做什么Read读取规格说明与既有代码是理解需求与现状的入口Write创建新的代码文件对应从规格到实现的落盘动作Edit就地修改既有文件对应需求变更、重构与缺陷修复Bash执行构建、测试与各类 shell 命令是验证成果的通道Grep在代码库中按正则检索用于定位相关符号与模式Glob按文件名模式查找文件用于发现项目结构与相关资源。需要留意一个平台差异在原生 macOS/Linux 构建中Glob 与 Grep 往往通过 Bash 工具内部的bfs/ugrep透明提供而非独立工具在 Windows 与 npm-JS 构建中仍是独立工具。作者在tools中引用 Glob/Grep 是安全的后端替换对 agent 透明。如果希望进一步收紧权限可以改用disallowedTools显式禁止某项能力或用tools: Read, Bash(npm:*), Bash(test:*)这类语法做条件化工具访问。为什么 model 用 inheritmodel: inherit表示该子代理沿用主会话配置的模型不把成本与能力锁死在某一个档位。对于实现类任务——既要写代码又要跑构建模型的推理能力直接影响改动质量——继承父会话是最稳妥的默认选择若想降低成本或提速可显式改为sonnet/haiku需在仓库的配置表允许范围内且需理解模型档位对复杂实现任务质量的影响。二、角色设定从规格到实现的资深开发者frontmatter 之下的正文即系统提示词system prompt。Implementation Agent 的核心角色一句话概括为あなたは仕様から機能を実装するシニア開発者である。你是一名从规格说明出发实现功能的资深开发者。正文随后列出了该 agent 的完整能力清单构建了它与只会聊天的普通会话之间的本质区别读取规格与既有代码Read编写新的代码文件Write编辑既有文件Edit运行构建命令Bash在代码库中搜索Grep查找符合模式的文件Glob。注意这套清单与 frontmatter 的tools一一对应——提示词中声明我具备什么能力frontmatter 中通过工具授权把这些能力物理落地。设计自定义子代理时保持二者的对称性是避免 agent以为能做却做不了的关键。从系统提示词的设计角度看这段角色声明的价值在于它让子代理在每次被唤醒时都明确自己处于实现者而非审查者规划者的心智模式中直接进入写代码、跑构建的状态机。三、六步实现流程运行时如何被驱动Implementation Agent 系统提示词以呼び出されたら被调用时为引导规定了标准工作流程。它本质上是一种结构化行为协议——把不可预测的自由发挥收敛为六个固定阶段要件を完全に理解する完整理解需求——不带着模糊目标写代码先吃透规格与验收口径既存コードベースのパターンを分析する分析既有代码库模式——识别项目惯例让新代码长在现有结构之上実装アプローチを計画する规划实现方案——先想清楚改动范围与文件划分再动手段階的に実装する分阶段实施——以小步提交推进避免一次性大改难以回退進めながらテストする边推进边测试——实现的每一阶段都即时验证整理してリファクタリングする整理并重构——收尾阶段清理草稿痕迹、消除重复。这六步与仓库中其他子代理的过程化提示词风格一脉相承例如 Debugger 子代理 定义了取错误 → 查变更 → 立假设 → 切分 → 修复验证五步根因分析流程。这种把专业方法论显式写入提示词的做法是让子代理输出稳定高质量的关键工程实践——你不依赖模型偶然发挥出专业水平而是用提示词结构固定住专业流程。四、实现守则四个维度的硬约束系统提示词的実装ガイドライン实现守则部分从四个维度对编码行为施加约束。这些条款共同构成了 agent 的软件工程素养。4.1 代码质量Code Quality遵循既有项目规约命名、格式化、目录约定编写自解释代码self-documenting让代码本身说明意图仅在逻辑复杂处添加注释避免噪音注释保持函数小而聚焦控制圈复杂度使用有意义的变量名。4.2 文件组织File Organization依据项目结构放置文件而非自创布局将相关功能聚合分组降低查找成本遵循项目命名约定让文件名可预测避免过深的目录嵌套控制模块间的认知负担。4.3 错误处理Error Handling覆盖所有错误路径——包括用户输入异常、依赖失败、空值边界提供有意义的错误信息而非笼统的 Something went wrong恰当记录错误日志便于事后定位优雅失败fail gracefully在出错时不产生半损坏状态。4.4 测试Testing为新功能编写测试确保既有测试仍然通过回归防护覆盖边界情形空集合、null、边界值对 API 类功能补充集成测试验证真实链路。与 Test Engineer 子代理 的规范对照可以看得更清楚后者明确单元测试 → 集成测试 → 端到端 → 边界情形 → 错误场景的分层策略并规定覆盖率最低 80%、关键路径认证、支付、数据处理100%。Implementation Agent 的测试守则描述的是自己实现、自己验证的基线而 Test Engineer 是专项接管测试战役的更高标准——二者叠加即构成完整的质量闭环。五、输出格式契约让结果可被主会话直接消费子代理工作完成后结果要蒸馏回主代理。如果输出结构混乱主代理就难以消化、转述或继续加工。因此 Implementation Agent 规定每个实现任务都按固定模板汇报作成したファイル新建的文件新建文件清单修正したファイル修改的文件变更文件清单追加したテスト新增的测试测试文件路径ビルドステータス构建状态Pass / Failメモ备注重要考量、遗留风险、对调用者的建议。这是一份面向人类与主代理共同消费的结构化交付物文件清单让变更可审计构建状态让质量可判定备注则传递了代码之外的隐性知识。参照同目录子代理可以发现输出契约是该仓库子代理体系的一致惯例——Debugger 要求按错误 → 根本原因 → 证据 → 修正 → 测试 → 预防六段汇报Test Engineer 要求报告文件 → 用例数 → 覆盖率增量 → 覆盖到的关键路径。这启示我们为每个自定义子代理设计专属的输出 schema是让它与主会话、与其他子代理高效协作的前提。六、完成检查清单防止半成品交付系统提示词要求 agent 在标记完成前逐项自检代码遵循项目规约全部测试通过构建成功无 lint 错误边界情形已处理错误处理已实现这份清单的价值在于把完成从主观感受变成可勾选的客观标准。主代理在收到子代理结果时可以直接要求其报告逐项自检结论从机制上杜绝写完就跑、编译不过也算交付的常见翻车模式。七、与周边子代理的协作编排把实现放进流水线单独一个 Implementation Agent 能完成单点功能开发但它真正的价值在协作编排中释放。仓库 04-subagents/README.md 的架构图清晰地展示了这一模型主代理作为协调者Coordinator把任务委派给 Code Reviewer、Test Engineer、Documentation Writer 等各专业子代理各自在独立上下文中执行后把结果返回主代理综合。Implementation Agent 在其中的典型站位是流水线的生产工位实现前主代理可先派 [Explore/Plan 思路] 梳理代码库或在提示中携带规格与相关文件路径实现中委派 Implementation Agent 落地功能获取文件清单与构建状态实现后链式派发 Test Engineer 补足测试覆盖、Code Reviewer 做质量审查、Debugger 处理失败用例、Documentation Writer 更新文档——前一个 agent 的输出直接作为后一个的输入。在提示语层面連鎖chaining是这样表达的First use the implementation-agent to build the feature, then have the test-engineer add coverage for the new API endpoints.这类语句会触发主代理按序委派多个子代理实现流水线化作业。同时要注意与主代理的协作礼貌Subagent 每个任务使用独立上下文主会话历史不会自动带过去因此调用时必须显式传递必要上下文规格、文件路径、验收标准这正是仓库最佳实践中别忘了传递必要上下文告诫的来源。若需长期记忆可给该子代理配置memory字段user/project/local三档让其在MEMORY.md中跨会话积累项目知识——例如记录本项目常用的构建命令与测试入口。八、部署到你的项目让 agent 真正可用Implementation Agent 仓库中维护了面向不同语言读者的说明英文版、日文版 等安装方式归结如下。方式一让 Claude 代劳推荐直接在会话中描述诉求例如Create a project-level subagent that implements features from specs, with access to Bash, Read, Write, Edit, Grep, and Glob. Claude 会为你写好.claude/agents/下的定义文件可再人工微调。注意从 v2.1.198 起/agents命令不再提供交互式创建向导创建与管理改为询问 Claude或直接编辑.claude/agents/文件两种途径。方式二直接复制仓库文件cd /path/to/your/project mkdir -p .claude/agents cp /path/to/04-subagents/implementation-agent.md .claude/agents/ # 若同目录其余示例子代理也需要可整批复制 # cp /path/to/04-subagents/*.md .claude/agents/ # 然后删除不需要的 README 副本方式三安装为用户级全项目可用mkdir -p ~/.claude/agents cp /path/to/04-subagents/implementation-agent.md ~/.claude/agents/优先级与验证子代理定义的加载优先级为CLI 定义--agentsJSON 项目级.claude/agents/ 用户级~/.claude/agents/ 插件目录同名时高优先级覆盖低优先级。安装后用claude agents命令或在会话中询问 Claude 即可确认implementation-agent已被识别若未被加载可运行ls .claude/agents/检查文件是否就位、frontmatter 是否合法YAML 解析错误会导致整个文件被跳过。九、基于源码的定制建议看完原始定义你多半会想按自己团队的口味微调。结合 frontmatter 的完整字段表见子代理参考指南的配置字段章节几点落地建议收紧/放宽工具不希望实现代理任意跑命令删除Bash仅保留Read, Write, Edit, Grep, Glob或改用条件语法Bash(npm:*)只允许包管理器类命令。设定权限模式若希望实现代理在acceptEdits自动接受编辑模式下运行减少打断可加permissionMode: acceptEdits注意 v2.1.212 起子代理默认继承父会话权限模式显式覆盖才生效。限制失控循环加maxTurns如40约束 agentic 轮次上限防止长任务空转。注入团队规范在正文系统提示词中追加本项目特定的构建命令、测试入口与分支策略——系统提示词是子代理按你的规矩干活的最强杠杆。匹配团队既有 SKILL若仓库 03-skills 下有沉淀的编码规范类 Skill可在子代理描述中提示其按需使用让实现行为与团队知识库对齐。结语Implementation Agent 的价值不在于让 AI 写代码这种笼统概念而在于它用一份结构化的定义文件把实现者角色、工具边界、六步流程、四维守则、输出契约与完成清单固化成了可重复、可审计、可协作的工程实体。把 ja/04-subagents/implementation-agent.md 中的定义部署进你的项目并让它与同目录的 Test Engineer、Code Reviewer、Debugger 组成流水线你就拥有了一条由主代理协调、各专业子代理接力、上下文互不污染的功能交付链路——这正是 claude-howto 仓库想教会你的把 Claude Code 从单打独斗升级为团队协作的核心姿势。【免费下载链接】claude-howtoA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-howto创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考