企业官网建设流程全解析

061、自定义项目级 Skill：为团队场景定制专属技能的方法论与工程模板

从一次凌晨的告警说起

凌晨两点，手机震得我直接从床上弹起来。PagerDuty 推送了一条 Critical 告警：生产环境某个微服务的错误率在五分钟内从 0.1% 飙到了 23%。我下意识想用 Claude Code 跑一下根因分析，结果发现它根本不理解我们团队内部的“错误码体系”——它把ERR_BIZ_1001当成 HTTP 500 去查，查了半天告诉我“可能是数据库连接池满了”。我盯着屏幕骂了句脏话，数据库连接池满个屁，那是我们自定义的业务限流错误码。

那一刻我意识到：通用大模型再强，不懂你的业务上下文就是废物。于是有了今天这篇——如何给 Claude Code 写一套真正能用的项目级 Skill。

Skill 不是 Prompt，是工程构件

很多人把 Skill 理解成“写一段好一点的 Prompt”，这是典型的认知偏差。Skill 的本质是一套可复用、可版本化、可组合的工程化行为模板。它包含三个层次：

1. 行为定义层：告诉 Claude 在什么场景下做什么事
2. 知识注入层：塞入团队特有的领域知识（错误码、架构图、命名规范）
3. 约束层：限制它不要乱来（比如别去改生产环境的数据库）