1. 从 1400 个 Skills 里做减法我的 settings.json 只留了这几个GitHub 上 Claude Code Skills 的数量已经突破 1400 个官方 marketplace 收录的也超过 658 个。这个数字还在涨。我花了三个月时间陆续装了 40 多个 skill帮团队里几个人清理过他们的 skill 列表最后得出一个结论真正能在日常工作里留下来的不超过 10 个。这篇文章不讲怎么注册、怎么安装那些官方文档写得很清楚。我要讲的是筛选逻辑和配置落地——怎么从 superpowers、claude-mem 这些热词里挑出真正有用的怎么把它们写进settings.json骨架以及每一项怎么验证它真的在工作。如果你正在被一堆装了又没用的 skill 拖慢 Claude Code 的响应速度或者不确定某个 skill 值不值得留这篇可以帮你省掉几个小时的试错时间。先说结论我最终留在settings.json里的是 superpowers 的部分 skill、claude-mem、agent-browser以及一个自己写的项目规范 skill。其余的全部卸载了。2. 前置准备TaoToken 接入与 Claude Code 环境确认在动settings.json之前得先确保你的 Claude Code 能正常跑起来。我用的是 TaoToken 的 API 接入方式官网在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 端点是 https://taotoken.net/api 。如果你还没配好 API Key先去控制台创建一个https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 。创建完之后在 API Keys 页面复制出来https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。Claude Code 的环境变量配置大概长这样export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_API_KEYsk-你的key配好之后跑一个最简单的验证claude -p 回复 ok如果返回ok说明基础链路通了。这一步很重要因为后面所有 skill 的验证都依赖 Claude Code 能正常响应。如果这一步报错先排查 API Key 和网络别急着装 skill。环境确认之后检查一下 skill 目录ls -la ~/.claude/skills/如果目录不存在手动建一个mkdir -p ~/.claude/skillsClaude Code 加载 skill 的逻辑是启动时扫描~/.claude/skills/下所有SKILL.md文件的 YAML frontmatter读取name和description每次请求用大约 100 tokens 做路由判断。激活后才加载完整内容。所以装太多 skill 的代价不是 token 爆炸而是路由噪声——description 写得模糊的 skill 会在不该激活的时候乱激活。3. 可复制配置settings.json 骨架与 skill 筛选标准3.1 settings.json 的完整骨架Claude Code 的settings.json通常放在~/.claude/settings.json。我的配置骨架如下{ skills: { enabled: [ superpowers/brainstorming, superpowers/systematic-debugging, superpowers/writing-plans, claude-mem, agent-browser ], disabled: [ superpowers/executing-plans, superpowers/requesting-code-review, superpowers/verification-before-completion ] }, memory: { provider: claude-mem, storage: local, autoInject: true, maxSnippets: 5 }, browser: { default: agent-browser, fallback: playwright-cli } }这个骨架的核心思路是只启用我每天都会用到的 skill把 superpowers 里那些重流程的 skill 放到 disabled 列表里需要的时候手动开。3.2 筛选标准四个必查项装任何一个 skill 之前我会检查这四点第一description 是路由规则还是营销文案。好的 description 读起来像触发条件比如Use when user needs to interact with websites: navigate pages, fill forms, click buttons。差的 description 是A powerful skill that supercharges your workflow。前者 Claude 知道什么时候激活后者会在不该激活的时候乱激活。第二SKILL.md 有没有 references 分层。打开 skill 目录看有没有references/子目录。有分层的说明作者考虑过 token 效率核心逻辑在 SKILL.md细节按需加载。全都堆在 SKILL.md 里的装了是在浪费上下文。第三GitHub 更新频率。模型在快速迭代半年没更新的 skill 可能在用老版本模型的行为假设指导新模型。我一般看最近一次 commit 是不是在三个月内。第四先用 7 天再决定保留。装一个 skill用一周。如果一周之内没有主动用过它卸载。不用的 skill 占着路由扫描空间长期是负担。3.3 superpowers 的选择性启用superpowers 是生态里最成功的 skill 集合187K star14 个 skill 覆盖完整软件开发生命周期。但它的问题也很明显简单任务会被拖慢计划修改体验差TDD 规则有时候过于强制。我的做法是只启用三个superpowers/brainstorming, superpowers/systematic-debugging, superpowers/writing-plansbrainstorming强制在动代码之前把需求想清楚systematic-debugging提供结构化的排查路径writing-plans生成实施计划。这三个是真正改变工作方式的。executing-plans、requesting-code-review、verification-before-completion我放到 disabled 里做大型重构的时候手动开。3.4 claude-mem 的配置claude-mem 解决的是跨会话记忆问题。配置项里maxSnippets控制每次注入的记忆片段数量我设成 5。设太多会引入噪声设太少又记不住关键决策。memory: { provider: claude-mem, storage: local, autoInject: true, maxSnippets: 5 }它的存储是本地 SQLite Chroma 向量数据库不经过外部服务。这一点对团队协作场景很重要记忆数据不出本地。3.5 agent-browser 的配置浏览器自动化我默认用 agent-browser复杂 DOM 操作降级到 Playwright CLIbrowser: { default: agent-browser, fallback: playwright-cli }agent-browser 每页只消耗 200-400 tokens因为它用精简的 YAML 摘要表示页面状态而不是把完整 DOM 树 dump 到上下文里。日常的导航、表单、提取数据够用。遇到复杂 JavaScript 交互再切 Playwright CLI。4. 验证请求逐项确认 skill 真的在工作配置写完之后不能假设它生效了。每一项都要验证。4.1 验证 skill 加载claude -p 列出当前已加载的 skillsClaude 会返回当前激活的 skill 列表。如果 enabled 列表里的 skill 没出现检查settings.json的路径和格式。4.2 验证 superpowers/brainstormingclaude -p 我想给项目加一个用户认证模块帮我 brainstorm 一下如果 brainstorming 生效Claude 不会直接开始写代码而是会问你一系列问题认证方式用 JWT 还是 session需要支持第三方登录吗用户表怎么设计这些问题是它在强制把需求想清楚。4.3 验证 claude-mem先在一个会话里说一个决策claude -p 记住我们这个项目用 PostgreSQL不用 MySQL然后新开一个会话claude -p 我们这个项目用什么数据库如果 claude-mem 生效第二个会话应该能回答 PostgreSQL。如果回答不知道检查autoInject是否开启以及记忆库文件是否存在。4.4 验证 agent-browserclaude -p 用 agent-browser 打开 https://example.com 并提取页面标题成功的话会返回页面标题同时你可以在输出里看到 token 消耗量。agent-browser 的 token 消耗应该在 200-400 之间。如果超过 1000说明它可能降级到了其他浏览器工具。4.5 验证 API 链路如果上面任何一步失败先回到最基础的验证curl https://taotoken.net/api/v1/messages \ -H x-api-key: sk-你的key \ -H anthropic-version: 2023-06-01 \ -H content-type: application/json \ -d {model:claude-sonnet-4-20250514,max_tokens:50,messages:[{role:user,content:回复 ok}]}返回正常说明 API 链路没问题问题出在 skill 配置上。模型对话的调试可以在 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 里快速试。5. 本篇常见错排查5.1 skill 装了但没激活最常见的原因是 description 写得太模糊。Claude 的路由判断依赖 description 里的触发词。如果 description 是提升工作效率Claude 不知道什么时候该激活。改成Use when user needs to write unit tests for Python functions这种具体的触发条件。5.2 claude-mem 注入的记忆是错的这是记忆噪声问题。claude-mem 会记住一切包括临时决策和后来被推翻的方案。解决办法是定期清理记忆库或者在会话结束时主动告诉 Claude这条不要记住。claude -p 刚才讨论的临时方案不要存入记忆5.3 superpowers 在简单任务上太啰嗦这是设计上的取舍。superpowers 的 brainstorming 会拦截所有任务包括帮我写个正则这种。解决办法是只启用部分 skill或者在做简单任务时临时禁用claude --no-skills -p 帮我写一个匹配邮箱的正则5.4 agent-browser 在复杂页面上失败agent-browser 的 YAML 摘要对复杂 DOM 操作支持有限。如果页面有大量动态渲染内容或多步骤表单切到 Playwright CLIbrowser: { default: agent-browser, fallback: playwright-cli, complexityThreshold: high }5.5 settings.json 格式错误导致 skill 全部失效JSON 不支持注释尾随逗号也会导致解析失败。改完配置后先验证python3 -c import json; json.load(open($HOME/.claude/settings.json))没有报错说明格式正确。5.6 API 返回 401 或 403检查 API Key 是否过期以及ANTHROPIC_BASE_URL是否指向了正确的端点。TaoToken 的 API 端点是https://taotoken.net/api不要多加路径。如果用的是 Coding Plan 方式接入确认 plan 状态正常https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。6. 长期编码与 Agent 场景的接入建议如果你主要是做长期编码或者 Agent 类项目skill 的选择逻辑会不太一样。短期任务看重的是单次效率长期项目看重的是记忆复利和流程一致性。我的建议是长期项目里 claude-mem 的优先级高于 superpowers。因为跨会话的记忆沉淀会随着时间累积价值而 superpowers 的流程收益在单次任务里就能体现不依赖历史积累。Agent 类项目还需要注意 skill 的 token 开销。Agent 会频繁调用模型每次调用的 skill 路由扫描开销会累积。这时候精简 skill 列表比什么都重要。我一般会把 enabled 列表控制在 5 个以内。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面有完整的 API 参数说明和 skill 配置示例。Claude Code 相关的接入细节可以参考 https://taotoken.net/claude-code?utm_sourcetaotoken_aicg_blog_endutm_contentclaude-codeutm_campaignrewrite 。最后说一个我踩过的坑不要一次性把所有看起来有用的 skill 都装上。装一个用一周确认它真的解决了你的问题再装下一个。1400 个 skill 里大部分你装上后一周内就会忘了它的存在。真正留下来的是那些你每天都会主动用的。