1. 为什么你的 Claude Code 需要一套 Skills 工作流Claude Code 是终端里的 AI 编程 Agent能读代码、跑命令、改文件、修报错。但默认状态下它更像一个“什么都懂一点”的通才你让它 review它给你泛泛的建议你让它补测试它写出来的用例可能只覆盖 happy path。真正拉开效率差距的是 Claude Code Skills——一套可复用的能力模块把“资深架构师怎么审代码”“测试工程师怎么设计边界用例”这类隐性经验固化成提示词模板和工具调用逻辑。你可以把 Skills 理解成给 Claude Code 装的 SOP 手册遇到 Code Review 场景走哪几步、输出什么格式遇到 Unit Test Generator 场景先读哪些文件、覆盖哪些分支。装好之后你在终端里说一句“帮我审一下这个 PR”它就会按你定义的流程执行而不是每次从零猜你的意图。这篇面向三类人刚接触 Claude Code、想把它用进真实项目的后端/前端工程师手里有遗留项目、想用 Refactoring Assistant 清理技术债的维护者以及想把 Code Review、Unit Test Generator 接进日常流程、但不想自己从零写配置的团队。下面直接给可复制的 Skills 文件骨架、settings.json 示例以及每一项的验证动作。我试过在几个 Java 和 Node 项目里落地踩过的坑会一并写出来。2. 前置准备TaoToken 接入与 Claude Code 环境Claude Code 要跑起来核心是两件事一个能稳定调用的模型入口以及本地正确的配置。这里用 TaoToken 作为接入层它提供兼容 Anthropic 的 API 端点Claude Code 可以直接对接。先拿到 API Key。打开 https://taotoken.net/api-keys 登录后在控制台创建密钥复制那串以sk-开头的字符串。注意 Key 只在创建时完整显示一次丢了就重新生成。然后确认本地环境。Claude Code 通过 npm 全局安装Node 版本建议 18 以上node -v npm install -g anthropic-ai/claude-code claude --version接着配置环境变量让 Claude Code 走 TaoToken 的端点。在~/.zshrc或~/.bashrc里加export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_API_KEYsk-你的密钥改完执行source ~/.zshrc生效。这里有个细节ANTHROPIC_BASE_URL不要带末尾斜杠也不要加 UTM 参数否则部分版本会拼接出错误路径。如果你用的是 Windows PowerShell对应写法是$env:ANTHROPIC_BASE_URLhttps://taotoken.net/api。想先确认模型通不通可以到 https://taotoken.net/models 用对话界面发一条测试消息比在终端里盲调更快定位问题。如果你打算长期把 Claude Code 用在编码和 Agent 任务上可以了解下 Coding Planhttps://taotoken.net/coding-plan 按用量规划比单次调用更省心。3. 可复制的 Skills 配置骨架Claude Code 的 Skills 以 Markdown 文件形式放在项目根目录的.claude/skills/下。每个文件包含触发条件、执行步骤、输出格式三段。下面给三个最常用的骨架你可以直接建文件粘贴。3.1 Code Review Skill新建.claude/skills/code-review.md# Code Review Skill ## 触发条件 用户请求包含代码审查review检查代码质量审一下 PR ## 执行步骤 1. 用 git diff 或读取指定目录确定审查范围 2. 逐文件检查空指针风险、资源未关闭、循环内 IO、异常吞掉、命名规范 3. 按严重程度分级每条给出文件:行号 问题 修复建议 4. 对可自动修复的项给出 diff 片段 ## 输出格式 - [严重] 必须修复可能导致线上故障 - [警告] 建议修复影响可维护性 - [建议] 优化项风格与性能3.2 Refactoring Assistant Skill新建.claude/skills/refactoring.md# Refactoring Assistant Skill ## 触发条件 用户请求包含重构refactor代码坏味道提取方法 ## 执行步骤 1. 识别重复代码块、过长函数、过深嵌套、魔法数字 2. 给出重构方案说明为什么这样改 3. 输出重构前后对比代码 4. 提示需要回归测试的范围 ## 约束 - 不改变对外行为只调整内部结构 - 每次只重构一个关注点避免大范围改动3.3 Unit Test Generator Skill新建.claude/skills/unit-test.md# Unit Test Generator Skill ## 触发条件 用户请求包含生成测试单元测试unit test补测试 ## 执行步骤 1. 读取目标类和方法签名识别入参与返回类型 2. 覆盖正常路径、边界值、异常分支、空值 3. 使用项目已有的测试框架JUnit 5 / Jest / pytest 4. 每个用例命名体现场景加简短注释 ## 输出格式 - 直接输出可运行的测试文件 - 末尾列出未覆盖的分支提示人工补充3.4 settings.json 示例在项目根目录建.claude/settings.json控制权限和默认行为{ permissions: { allow: [ Read, Grep, Glob ], ask: [ Bash(git diff:*), Bash(mvn test:*), Bash(npm test:*) ], deny: [ Bash(rm -rf:*), Bash(git push:*) ] }, env: { ANTHROPIC_BASE_URL: https://taotoken.net/api } }这份配置的思路读操作直接放行跑测试和看 diff 需要确认删除和推送直接禁止。这样 Claude Code 在自动执行时不会误伤生产分支。4. 逐项验证让 Skills 真正跑起来配好文件不代表生效得逐项验证。下面给每个 Skill 的验证动作和预期结果。4.1 验证 Code Review在项目里制造一个明显问题比如在某个 Service 里加一行System.out.println然后执行claude 审查当前目录下最近修改的 Java 文件按 code-review skill 输出预期输出里出现[建议]级别指出System.out.println应改用 Logger并给出文件行号。如果它没匹配到 Skill检查文件名是否严格是code-review.md以及触发词是否出现在你的请求里。4.2 验证 Refactoring Assistant找一段有重复逻辑的代码执行claude 分析 UserService.java找出重复代码块按 refactoring skill 给方案预期它先列出重复位置再给出提取后的方法最后提示“需回归测试 createUser 和 updateUser”。如果它直接大改整个文件说明 Skill 里的“每次只重构一个关注点”约束没被读到确认文件在.claude/skills/下且没有语法错误。4.3 验证 Unit Test Generator选一个纯函数或 Service 方法claude 为 OrderService.calculateTotal 生成 JUnit 5 测试按 unit-test skill 执行预期生成一个完整测试类包含正常、边界金额为 0、负数、异常分支末尾列出未覆盖分支。跑一下mvn test确认能编译通过。如果生成的测试引用了不存在的依赖检查 Skill 里是否写明了测试框架版本。4.4 验证 settings.json 权限执行一条被 deny 的命令claude 帮我执行 git push origin main预期Claude Code 拒绝执行并提示该操作被 settings.json 禁止。如果它仍然尝试说明配置文件路径不对——必须是项目根目录的.claude/settings.json不是用户目录。5. 本篇常见错排查Skill 不生效Claude Code 像没看见一样。最常见原因是目录层级错了。.claude/skills/必须在项目根目录和.git同级。如果你在子目录里建Claude Code 从根启动时扫不到。另一个原因是文件扩展名不是.md或者文件开头有 BOM 字符导致解析失败。API 调用报 401 或 403。先确认ANTHROPIC_API_KEY没有多余空格再确认ANTHROPIC_BASE_URL是https://taotoken.net/api而不是带路径的完整 URL。如果 Key 是在别的环境生成的检查是否已过期。到 https://taotoken.net/api-keys 重新生成一个最省事。生成的测试编译不过。多半是 Skill 里没指定测试框架Claude Code 默认按 JUnit 4 写而项目用的是 JUnit 5。在unit-test.md的“执行步骤”里明确写“使用 JUnit 5import org.junit.jupiter.api.*”问题就解决了。Code Review 输出太泛没有行号。说明它没读到具体文件。检查你的请求里是否给了明确路径或者 Skill 的“执行步骤”第一步是否写了“用 git diff 确定范围”。如果项目没初始化 gitgit diff会失败改成“读取指定目录下所有源文件”。Refactoring 改动过大一次动了十几个文件。这是约束没写死。在 Skill 里加一行“单次重构不超过 3 个文件超出则先列计划等确认”。Claude Code 会遵守这类硬性约束。权限配置不生效该拦的没拦。settings.json的deny规则用的是前缀匹配Bash(git push:*)能拦住git push origin main但拦不住git push不带参数。要覆盖全写成Bash(git push)和Bash(git push:*)两条。6. 把 Skills 接进日常流程三个 Skill 跑通之后可以按团队习惯扩展。比如加一个api-doc.md从 Controller 生成 OpenAPI或者加log-analyzer.md从日志里提取错误模式。每个新 Skill 都遵循同样的结构触发条件写清楚执行步骤拆细输出格式固定。这样 Claude Code 的每次响应都可预期而不是开盲盒。接入文档在 https://taotoken.net/doc 里面有完整的端点说明和参数示例。如果你主要用 Claude Code 做长期编码和 Agent 任务Coding Plan 的用量模型比按次调用更划算入口在 https://taotoken.net/coding-plan 。模型对话验证在 https://taotoken.net/models API Key 管理在 https://taotoken.net/api-keys 控制台总览在 https://taotoken.net/console 。Claude Code 专用接入说明可以看 https://taotoken.net/ClaudeCodeAnthropic 。最后说一个实际经验Skills 不是越多越好。我一开始装了七八个结果 Claude Code 在匹配时经常选错。后来砍到三个核心的——Code Review、Refactoring、Unit Test——反而每次都能命中。先把这三个用顺再按需加。