官方示例就完美吗？用标准解剖 Anthropic 的真实 Skill（6/7）

把前五课的标准变成评审能力——评审 Anthropic 官方示例仓库里的 internal-comms

这节课的目的

前五课我们手里有了五条标准：三层加载、description 公式、正文路由器、references 写法、实跑迭代。这节课做一件事：把这五条标准合成一套评审方法，拿一个真实的一流 skill 开刀。

评审对象是 Anthropic 官方示例仓库里的 internal-comms（内部沟通写作助手）。选它的原因：SKILL.md 只有 1.5KB，但结构完整、要素齐全——够短，我们能一眼看完整个文件；够全，五格清单每一格都能找到例子。

评审清单（五课标准的合订本）

先看清单，再看用它评审的完整过程。这个清单以后可以直接拿去评审任何 skill：

① Description    三个要点齐吗？写给模型还是写给人？
② 触发策略       自动 or 手动（disable-model-invocation）？
                  策略和 description 的写法匹配吗？
③ 正文           是路由器还是仓库？语气是祈使句吗？
                  有没有 Gotchas？有没有 Don't railroad？
④ 第三层         细节住 references 了吗？正文有指针吗？
                  有可复用组件（assets/scripts）吗？
⑤ 一致性         说的和做的一致吗？（最高阶的一条）

实战：评审 internal-comms

① Description —— 合格，但有一个值得讨论的点

先看例子：

description: A set of resources to help me write all kinds of
internal communications, using the formats that my company likes
to use. Claude should use this skill whenever asked to write some
sort of internal communications (status reports, leadership
updates, 3P updates, company newsletters, FAQs, incident reports,
project updates, etc.).

# 翻译：
# 一组帮我写各种内部沟通材料的资源，用我公司喜欢的格式。
# 当要求我写任何内部沟通材料（状态报告、领导层汇报、3P 更新、
# 公司通讯、FAQ、事故报告、项目更新等）时，应该使用这个 skill。

按三个要点公式严格打分：

• 能力清单 ✓（write internal communications）
• 触发场景 ✓（whenever asked to write…）
• 用户关键词 ✓（status reports、3P updates、newsletters、FAQs……一口气列了 7 个）

三个要点齐全，关键词尤其丰富。但注意一个细节：它写的是 “help me write”、”my company”——第一人称。这是 Anthropic 官方仓库里少有的第一人称 description，和官方自己倡导的”第三人称写法”不一致。评审时这是一个可以挑出来的点：description 是写给模型的路由规则，用”我”会让模型匹配时多一层”这个’我’是谁”的推理。

② 触发策略与 description 的匹配 —— 一致 ✓

看 frontmatter 例子：

---
name: internal-comms
description: A set of resources to help me write...
license: Complete terms in LICENSE.txt
---

# 翻译：
# 名称 internal-comms；描述：一组帮我写……的资源；
# 许可证：完整条款见 LICENSE.txt

没有 disable-model-invocation——它参与自动触发。所以 description 必须精确，而它确实做到了：触发场景明确、关键词丰富。策略和写法匹配。

③ 正文 —— 教科书级 ✓

看正文例子（完整，只有 30 行）：

## When to use this skill
To write internal communications, use this skill for:
- 3P updates (Progress, Plans, Problems)
- Company newsletters
- FAQ responses
- Status reports
- Leadership updates
- Project updates
- Incident reports

# 翻译：什么时候用这个 skill——写内部沟通材料时，
# 包括 3P 更新（进展、计划、问题）、公司通讯、FAQ 回复、
# 状态报告、领导层汇报、项目更新、事故报告。

## How to use this skill

To write any internal communication:

1. **Identify the communication type** from the request
2. **Load the appropriate guideline file** from the
   `examples/` directory:
    - `examples/3p-updates.md` - For Progress/Plans/Problems
    - `examples/company-newsletter.md` - For newsletters
    - `examples/faq-answers.md` - For FAQs
    - `examples/general-comms.md` - For anything else
3. **Follow the specific instructions** in that file for
   formatting, tone, and content gathering

# 翻译：怎么用这个 skill——第一步，从请求中识别沟通类型；
# 第二步，从 examples/ 目录加载对应的指南文件；
# 第三步，按文件里的具体指令执行格式、语气和内容收集。

逐条对照五格清单：

• 路由器纯度 100%——正文只有”什么时候用”和”三步走”，没有任何格式细节。格式细节全在 examples/ 里的 4 个文件中。
• 祈使句——”Identify the communication type”（识别沟通类型）、”Load the appropriate guideline file”（加载对应的指南文件）、”Follow the specific instructions”（按具体指令执行），动词开头，零歧义。
• 指针写法——第 2 步把 4 个 examples 文件各配一句说明，agent 一看就知道该加载哪个。这是”先把指针立起来”的教科书写法。
• Don’t railroad——最后一句”If the communication type doesn’t match any existing guideline, ask for clarification”（如果沟通类型不匹配任何现有指南，就请求澄清）——没有写死”不匹配就报错”，留了适配余地。

④ 第三层 —— 教科书级 ✓

看 examples/ 目录例子：

internal-comms/
├── SKILL.md                  1.5KB
├── LICENSE.txt
└── examples/
    ├── 3p-updates.md         3.3KB
    ├── company-newsletter.md 3.3KB
    ├── faq-answers.md        2.4KB
    └── general-comms.md      0.6KB

四个文件按主题分，每个 0.6-3.3KB，全部在 ~1000 tokens 的查阅阈值以内。正文里用指针指过来，agent 按需加载——第 1 课的三层模型在这里完整跑通。

⑤ 一致性 —— 最高阶的评审项

internal-comms 教 agent 怎么写内部沟通。它自己的 SKILL.md 就是一份写得极好的内部沟通——结构清晰、语言简洁、每句话都有用。它自己就是它教的东西的一个实例。这是一致性评审里最理想的答案。

评审发现的一个真实瑕疵

评审不能只说好的。internal-comms 有一个可以挑剔的点：description 里的第一人称（”help me write”、”my company”）。Anthropic 自己的 skill-creator 规范里明确倡导第三人称写法，但 internal-comms 是官方仓库里的 skill，却用了第一人称。这说明：官方仓库里也有不一致的地方，评审任何 skill 都要用自己的标准过一遍，不能因为”这是官方的”就免检。

检验一下

① Description    三个要点齐吗？写给模型还是写给人？
② 触发策略       自动 or 手动？策略和写法匹配吗？
                  ※ 先评 ② 再评 ①，顺序反了会误判
③ 正文           路由器还是仓库？祈使句吗？
                  有 Gotchas 吗？留适配余地了吗？
④ 第三层         细节住 references 吗？正文有指针吗？
                  有可复用组件吗？确定性的事有脚本吗？
⑤ 一致性         说的和做的一致吗？作者用自己的
                  方法做出过什么？（最高阶）