056、Claude Code Skill 系统入门：技能的定义、自动发现与调用机制全解析

056、Skill 系统入门：技能的定义、自动发现与调用机制全解析

上周帮团队排查一个CI流水线卡死的问题，Claude Code在解析一个复杂的monorepo时，突然对某个内部包的构建脚本产生了“幻觉”——它试图调用一个根本不存在的build:prod命令。我盯着终端里那行“I’ll try to run the build script”的日志，突然意识到：Claude Code的Skill系统，本质上就是给AI装上了一套“可编程的行为反射弧”。如果你不理解这套机制，AI就会像那个对着空文件夹喊“编译！”的实习生一样，既努力又尴尬。

技能是什么？不是插件，是“行为模板”

很多人第一次接触Skill系统，会下意识把它类比成VS Code的插件或GitHub Actions的action。这个类比只对了一半。Skill不是扩展功能，而是定义AI在特定上下文中如何思考并执行动作的模板。

举个例子，你写一个deploy.skill.md：

--- name: deploy description: 部署服务到K8s集群，支持滚动更新和回滚 trigger: user asks to deploy --- 1. 确认当前分支是否为 `main` 或 `release/*` 2. 读取 `deploy/k8s/` 目录下的YAML模板 3. 执行 `kubectl apply -f deploy