配了三年 Claude Code，今天才发现 skills 装完从来不是终点——这件事被一套管理方案彻底接上了

你以为 skills 装完就完事了？今天这件事被一套管理方案彻底接上了

大多数人在 Claude Code 里装完一个 skill 的流程是这样的：找到、安装、结束。Claude Code 告诉你「Skill installed」，然后就没有然后了。下一个 skill 又重复一遍。一年以后你的 .claude/skills/ 目录里塞了三十七个 skill，其中二十个你只在安装那天见过一面。

这不是你不会用 Claude Code，这是工具链的最后一公里没人教你。

技能目录的「死人困境」

Anthropic 的工程师 Thariq Shihipar 在内部实践中发现了一个规律：他用 PreToolUse hook 追踪每个 skill 的触发频率，结果发现三分之一的 skill 在过去三十天里零触发——不是不能用，是没人记得它们存在。

这背后是一个认知偏差：skill 装完以后就消失在目录里了，直到某次对话里突然想起来「哎我好像装过一个这玩意儿」，再去找才发现早就忘了当初为什么装的。团队里更是如此——A 装了一个 db-migration skill，B 在另一个项目里手写了一年 CREATE TABLE，两个人从来不知道对方手里有武器。

软链接：一个符号解决跨项目共享

解决这个问题最朴素的方式是软链接。

你不需要在每个项目里单独装 skill，只需要维护一个中央仓库：

# 建立中央仓库
mkdir -p ~/claude-skills
git clone https://github.com/your-org/team-skills ~/claude-skills

# 在项目里软链接
mkdir -p ./.claude/skills
ln -s ~/claude-skills/db-migration ./.claude/skills/db-migration
ln -s ~/claude-skills/code-review ./.claude/skills/code-review

这样你在任何项目里说「帮我 review 这个 SQL migration」，Claude Code 都会触发 db-migration skill，因为它就躺在当前项目的 .claude/skills/ 里——实际文件在 ~/claude-skills/ 统一维护，一次更新所有项目生效。

Windows 用户需要注意：git clone 时要加 -c core.symlinks=true，否则符号链接会变成一行的指针文本。

Private Marketplace：团队级的 skill 分发

软链接解决个人跨项目问题，但团队有更复杂的需求：谁装了什么、谁来维护、谁来审批。

Anthropic 官方支持通过 plugin marketplace 解决这件事。你可以把团队所有的 skill、agent、hook 和 MCP 配置打包成一个 plugin，在 marketplace.json 里声明：

{
  "plugins": [
    { "name": "create-pr", "source": "./skills/create-pr" },
    { "name": "backend-reviewer", "source": "./agents/backend-reviewer.md" }
  ]
}

新成员克隆项目以后，Claude Code 会自动发现并安装所有 plugin——等于 clone 一次，全套技能到手。管理员可以在 settings.json 里用 strictKnownMarketplaces 限制只允许经过审批的 marketplace，杜绝成员装来路不明的第三方 skill。

这个机制企业版还可以配合 managed settings 做强制配置——管理员下发的东西员工改不了，这是真正的「组织级 skill 治理」。

「Gotchas」才是 skill 的护城河

大多数 skill 教程教你怎么写「When to Use」和「Instructions」，但 Anthropic 内部实践里最高价值的章节叫 Gotchas——「在这里踩过的真实坑」。

这不是故障排除文档，这是组织的制度性记忆。

一个好的 Gotchas 长这样：

## Gotchas
- `createPayment()` 在余额不足时返回 null，不抛异常，要单独判断
- 预发环境数据库每天 UTC 00:00 重置，23:30 以后不要跑迁移
- deploy-service 如果服务名包含大写字母会静默失败

这类信息从哪来？工程师在生产环境踩过一个坑，然后把这个坑写进 skill。下次遇到类似情况的人直接受益。这和代码审查一样——经验从个人脑子里流进了可复用的资产。

Thariq 的原话是：这个章节装完第一天就能值回本。

下一步：从零到有序只需要三步

第一步，在现有项目中跑 /plugin 查看 Installed tab，Claude Code 会标记出「超过两周没触发」的 skill——这些是你需要清理或者真正用起来的。

第二步，选一个你们团队最高频的重复操作，比如「每次都要查数据库变更日志」，写一个 10 行的 db-changes skill，重点是「When to Use」和至少两条 Gotchas。

第三步，把这个 skill 放进团队共享仓库，通知同事开始用。第一个 skill 跑通以后，后面的会快十倍。

skill 的终点不是安装，是团队里有人因为它少踩了一个坑。