行业动态
mp.weixin.qq.com ·
@架构师之路
用五项标准评审 Anthropic 官方 skill：以 internal-comms 为例
架构师之路作者提出评审优秀 skill 的五项标准：description 是否覆盖能力清单、触发场景与关键词；触发策略是自动还是手动且与 description 匹配；正文是路由器还是仓库、是否用祈使句、有无 Gotchas 与 Don't railroad；第三层细节是否放在 references 并有指针；以及言行一致性。作者以 Anthropic 官方仓库的 internal-comms skill 为例逐条评审，认为其正文 30 行纯路由、examples 按需加载、自身即内部沟通范例，属高分样本，但指出其 description 使用第一人称是瑕疵。
AI推荐理由 架构师之路作者以 Anthropic 官方 skills 仓库中的 internal-comms 示例为样本，逐条拆解 description、触发策略、正文路由、第三层按需加载、一致性五项评审标准，并指出官方示例 description 使用第一人称的瑕疵，对写 Agent skill 的开发者有直接参考价值；但属个人经验总结，标准转述自官方博客，正文为节选且结尾含直播预告，带一定推广成分。
66
正文
原创 58沈剑 2026-10-05 11:46 北京
好skill的5条标准。
你用过很多很多 skill 吧？它能大幅提升 AI 在专项任务上的表现。但真自己动手写 skill 的时候，发现它经常不触发，即使触发，也不按“想象中”的执行。
写好 skill 的前提，要先看懂什么是好的 skill。今天和大家聊聊，评审优秀 skill 的五项标准。
画外音：标准来自官方博客。
---
### 评审优秀 skill 的五项标准：
> **① Description**：
>
> - 能力清单、触发场景、用户关键词，三大要点齐全吗？
>
> - 是写给模型还是写给人
>
> **② 触发策略**：
>
> - 自动 or 手动（disable-model-invocation）？
>
> - 策略和 description 的写法匹配吗？
>
> **③ 正文**：
>
> - 是路由器还是仓库？
>
> - 语气是祈使句吗？
>
> - 有没有 Gotchas（坑）？
>
> - 有没有 Don't railroad（完全限制死）？
>
> **④ 第三层**：
>
> - 细节在 references 里吗？
>
> - 正文有指针吗？
>
> - 有可复用组件吗？
>
> **⑤ 一致性**：
>
> - 说的和做的一致吗？（最高阶的一条）
以后我们写 skill 或者看别人写的 skill，直接用这五条去对照，立刻就能看出功力深浅。
---
### 实战：解析 Anthropic 官方 skill
`internal-comms` 是 Anthropic 官方仓库里的示例，帮人写内部沟通材料。
画外音：
github.com/anthropics/skills/tree/main/skills/internal-comms
这个 skill 不长，但结构完整、要素齐全，是绝佳的评审样本。
我们一条条来过：
#### 1. Description：不太合格。
官方示例的 description 长这样：
> A set of resources to help me write all kinds of internal communications... Claude should use this skill whenever asked to write...
三个要点齐全（能力、场景、关键词），但注意：**它用了第一人称（"help me write"、"my company"）**。
这是一个小瑕疵， description 是**写给模型的路由规则**，用“我”会让模型匹配时多一层“这个‘我’是谁”的推理负担。Anthropic 自己倡导第三人称，但官方仓库里也有不一致的地方。
评审原则：用标准过一遍，不因为“这是官方的”就免检。
#### 2. 触发策略：自动触发，和 description 匹配，合格。
没有 `disable-model-invocation`，所以它属于自动触发。description 里的触发场景明确、关键词丰富，策略和写法完全匹配。
画外音：如果只能手动触发，desc就没这么重要了。
#### 3. 正文：教科书级路由器，合格。
正文只有 30 行，只做了一件事：**路由**。
路由器纯度 100%：只有“什么时候用”和“三步走”，没有任何实施细节，细节全在 `examples/` 目录里。
祈使句驱动：“Identify...”、“Load...”、“Follow...”，动词开头，零歧义。
指针写法：明确告诉 agent，写 3P 更新就去加载 `examples/3p-updates.md`，写通讯就去加载 `company-newsletter.md`。
Don't railroad：最后留了一句“如果不匹配任何指南，就请求澄清”，没有写死逻辑。
画外音：Don't railroad，不要全写死，留发挥空间。
#### 4. 第三层：按需加载的典范，合格。
`examples/` 目录下有 4 个文件，每个 0.6-3.3KB，全部在 ~1000 tokens 的查阅阈值以内。正文里用指针指过来，agent 按需加载。
画外音：这是标准的“渐进式披露三层加载”。
#### 5. 一致性：最高阶的满分答案，合格。
`internal-comms` 教 agent 怎么写内部沟通，而**它自己的 SKILL.md 就是一份写得极好的内部沟通**——结构清晰、语言简洁、每句话都有用。
它自己就是它教的东西的一个实例。这就是“言行一致”的最高境界。
---
### 解剖完这个 1.5KB 的官方 skill，你会发现：**好 skill 不是写出来的，是设计出来的。**
核心就三点：
1. 路由器思维：正文只做调度，细节放第三层。
2. 给模型看的语言：description 用第三人称，正文用祈使句。
3. 言行一致：教的规矩，自己先做到。
---
### 节后直播，《如何30分钟写出一个好skill》，分享自己写 skill 的一些心得，以及自己对AI的一些思考。上面这些，其中的“评审篇”。
### 欢迎预约，直播间不见不散。
调研：你写过哪些 skill？
[跳转微信打开](https://wechat2rss.bestblogs.dev/link-proxy/?k=d6c6beb9&r=1&u=https%3A%2F%2Fmp.weixin.qq.com%2Fs%3F__biz%3DMjM5ODYxMDA5OQ%3D%3D%26mid%3D2651981708%26idx%3D1%26sn%3D02d64f352330c48434bf30754dc38828)