1. 为什么你的 Claude Code 需要一个“专属助手团队”如果你已经在用 Claude Code 写代码大概率经历过这样的场景主对话里刚聊完架构设计转头让它审查一段代码它却把前面几百行的上下文一起“背”着走响应变慢、token 飙升审查结果还容易被无关信息带偏。更麻烦的是团队里每个人对“代码审查”的标准都不一样今天让它查安全明天让它查命名每次都要重新粘贴一大段提示词。Claude Skills 和 SubAgent 就是来解决这两个问题的。Skills 是把重复的指令、检查清单、操作流程封装成可复用的“技能包”需要时按需加载SubAgent 则是把特定任务委派给拥有独立上下文的“专家助手”主会话保持干净子代理专注干活。两者组合起来你就能从“每次手动指挥一个通用 AI”升级成“管理一支各司其职的 AI 开发团队”。这篇内容面向希望构建专属 AI 开发助手的开发者会交付可复制的 Skills 目录结构、SubAgent 定义文件和 settings.json 骨架并给出通过 TaoToken 统一 Key/API 通道接入的验证步骤。目标很明确从零跑通一个可扩展的助手工作流让你看完就能动手搭起来。2. 前置准备用 TaoToken 统一 Key 与 API 通道在配置 Skills 和 SubAgent 之前先把模型接入通道理顺。Claude Code 本身支持多种模型但如果你想让主会话、子代理、技能脚本都走同一个 Key避免到处散落配置用 TaoToken 做统一入口会省很多事。TaoToken 提供兼容的 API 通道你只需要一个 Key就能在 Claude Code 的 settings.json 里统一配置模型访问。官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 端点是 https://taotoken.net/api 注意这个不加 UTM 参数。操作路径很简单先到控制台创建 API Key然后把它写进 Claude Code 的配置文件。如果你还没创建 Key可以走这个 deep link 直达https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 。创建完成后Key 的管理页面在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 后续轮换或新增都从这里进。注意Key 只存在本地配置文件或环境变量里不要提交到 Git 仓库。团队共享时用环境变量注入别把明文 Key 写进项目级 settings.json。接入文档可以参考 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面有完整的参数说明和示例。配置好之后Claude Code 的主会话、SubAgent、Skill 脚本就都能复用同一个通道不用每个地方单独填一遍。3. 可复制配置Skills 目录结构与 SKILL.md 骨架Skills 的核心是“按需加载”启动时只读技能名称和描述任务匹配时才加载完整指令。所以目录结构要清晰SKILL.md 要写好触发描述。个人级 Skill 放在~/.claude/skills/下项目级 Skill 放在项目根目录/.claude/skills/下。每个技能一个独立目录目录名就是技能名里面放一个SKILL.md。结构如下~/.claude/skills/ └── code-review/ ├── SKILL.md └── scripts/ └── check.sh项目级同理项目根目录/.claude/skills/ └── api-doc-gen/ └── SKILL.mdSKILL.md的骨架可以这样写重点是开头的描述要能让 Claude 判断“什么时候该用这个技能”--- name: code-review description: 当用户要求审查代码、检查代码质量、查找潜在 bug 或安全问题时使用。适用于 Python、JavaScript、Go 等语言。 --- # 代码审查技能 ## 执行步骤 1. 读取用户指定的文件或目录 2. 按以下清单逐项检查 - 命名规范变量、函数、类名是否清晰一致 - 错误处理是否有未捕获的异常、边界条件遗漏 - 安全隐患硬编码密钥、SQL 注入、路径穿越 - 性能问题不必要的循环嵌套、重复计算 3. 输出格式按严重程度分级高/中/低每条给出文件行号和修改建议 ## 参数 - $ARGUMENTS要审查的文件路径或目录 - $1语言类型可选默认自动识别这里$ARGUMENTS和$1、$2是占位符调用技能时传入的参数会替换进去。比如你输入/code-review src/main.py python$1就是python。项目级 Skill 和用户级 Skill 可以同名Claude 会根据描述让你选择用哪一个。实测下来把团队规范写进项目级 Skill新人拉下代码就能用同一套审查标准比口头传达靠谱得多。4. 可复制配置SubAgent 定义文件与 settings.json 骨架SubAgent 的定义文件是 Markdown 格式放在.claude/agents/目录下。项目级放项目根目录/.claude/agents/用户级放~/.claude/agents/。每个子代理一个.md文件文件名就是代理名。一个只读代码审查子代理的定义骨架--- name: code-reviewer description: 只读代码审查专家。当需要审查代码质量、安全漏洞、性能问题时使用。不能修改文件。 model: claude-sonnet-4-6 tools: - Read - Glob - Grep --- # 代码审查专家 你是一名资深代码审查员只读不写。你的职责是 1. 读取指定文件逐行分析 2. 按高/中/低三级输出问题每条包含文件路径、行号、问题描述、修复建议 3. 重点关注安全漏洞、错误处理、边界条件、命名规范、重复代码 ## 约束 - 禁止使用 Edit、Write 工具 - 禁止执行任何 shell 命令 - 输出必须结构化便于直接贴进 PR 评论关键参数说明字段作用可选值示例name代理名称调用时用code-reviewerdescription触发描述主代理据此决定何时委派只读代码审查专家…model指定模型可按任务复杂度选claude-sonnet-4-6 / claude-haiku-4-5tools允许使用的工具列表Read / Glob / Grep / Edit / Writesettings.json骨架用来统一模型通道和权限。项目级放在.claude/settings.json用户级放在~/.claude/settings.json{ model: claude-sonnet-4-6, apiKey: ${TAOTOKEN_API_KEY}, baseUrl: https://taotoken.net/api, permissions: { allow: [Read, Glob, Grep], deny: [Bash(rm -rf)] }, agents: { code-reviewer: { model: claude-sonnet-4-6 }, test-writer: { model: claude-haiku-4-5 } } }这里apiKey用环境变量${TAOTOKEN_API_KEY}注入避免明文。baseUrl指向 TaoToken 的 API 端点。agents字段可以给不同子代理分配不同模型审查用 Sonnet 保证质量测试生成用 Haiku 控制成本。创建好之后在项目里重启 Claude Code输入/agents就能看到注册的子代理列表。如果没显示检查文件是否放在正确目录、YAML 头格式是否正确。5. 验证请求从零跑通一个可扩展工作流配置写好了得验证它真的能跑。按下面步骤走一遍确认 Skills 和 SubAgent 都正常工作。第一步确认模型通道。在 Claude Code 里输入/model看当前使用的模型是否走了你配置的通道。如果显示的是你 settings.json 里指定的模型说明 TaoToken 接入生效了。想单独验证模型对话可以走这个链接快速测试https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite 。第二步验证 Skill 加载。输入/skills命令应该能看到你创建的技能列表。个人级和项目级的技能都会列出来同名时会标注来源。如果某个技能没出现检查SKILL.md的 YAML 头是否有name和description。第三步调用 Skill。输入/code-review src/main.py观察 Claude 是否加载了对应的技能指令并按你定义的清单输出审查结果。成功的话你会看到分级的问题列表而不是泛泛的“代码看起来不错”。第四步验证 SubAgent。在对话里说“用 code-reviewer 审查 src/main.py”主代理应该会委派给子代理执行。子代理在独立上下文里跑完把结构化结果返回主会话。你可以对比一下直接让主会话审查和委派给子代理审查后者的输出更聚焦、格式更统一。第五步验证并行。同时委派两个子代理比如一个审查代码、一个生成测试观察它们是否并行执行、互不干扰。这一步跑通说明你的助手工作流已经具备扩展能力。如果你打算长期用这套工作流做编码和 Agent 任务可以考虑 Coding Plan入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 适合需要稳定通道和批量调用的场景。6. 本篇常见错排查配置过程中最容易踩的几个坑这里集中说一下。Skill 不触发最常见的原因是description写得太模糊。Claude 靠描述判断是否加载技能如果只写“代码审查”它可能匹配不到具体场景。改成“当用户要求审查代码、检查质量、查找 bug 时使用”触发率会明显提升。SubAgent 不显示先检查目录。项目级必须是项目根目录/.claude/agents/用户级是~/.claude/agents/少一层或多一层都不行。再检查文件扩展名必须是.mdYAML 头用---包裹name和description不能少。模型调用报错如果提示认证失败检查settings.json里的apiKey环境变量是否真的注入了。可以在终端echo $TAOTOKEN_API_KEY确认。baseUrl要写https://taotoken.net/api不要多加路径或斜杠。子代理权限过宽审查类子代理如果给了Edit权限它可能会直接改代码违背“只读审查”的初衷。在tools列表里只保留Read、Glob、Grep把写操作挡在外面。并行任务互相污染如果两个子代理同时写同一个文件会出现冲突。设计工作流时让写操作集中在主会话或单一子代理其他子代理只读。需要并行写时分配不同的输出目录。Skill 脚本执行失败SKILL.md里引用的脚本路径要用相对路径并且确保有执行权限。在 Linux/macOS 下chmod x scripts/check.shWindows 下注意换行符和路径分隔符差异。排查完这些你的 Skills 和 SubAgent 基本就能稳定运行了。接下来就是按团队需求不断往里加技能、加专家让这套助手工作流越长越壮。