# 评分表倒着用：写Skill预检清单——设计模式提炼的第三条路
## 概述
## 一、评测对象：六个被引最广的「范本件」
八轮拆解下来，有些 Skill 件被反复引用为某一写法的出处。本期选六个当「范本件」，用标准五维评分表横评——注意评分口径：superpowers 约束三件（4.6）与 triage（4.25）有 08-29 存档实测分打底，其余为名单级黑箱估分，两档分数在表中分列，不做加权合成。
| 范本件 | 出处 | 它是哪个写法的标本 | 功能 25% | 设计 25% | 实战 20% | 上手 15% | 社区 15% |
|---|---|---|---|---|---|---|---|
| domain-modeling | mattpocock/skills | description 路由表 + 负面空间 | ★★★★★ | ★★★★★ | ★★★★ | ★★★★ | ★★★★★ |
| webapp-testing | anthropics/skills 官方 | 决策树 + 生命周期托管 | ★★★★★ | ★★★★★ | ★★★★★ | ★★★★ | ★★★★ |
| superpowers 约束三件 | obra/superpowers | 铁律/反合理化表/红旗清单 | ★★★★☆ | ★★★★★ | ★★★★ | ★★★★☆ | ★★★★★ |
| triage | mattpocock/skills | 状态机编排 + 披露协议 | ★★★★★ | ★★★★★ | ★★★★ | ★★★ | ★★★★★ |
| copy-editing | 社区件 | 口语触发词枚举 | ★★★★ | ★★★★ | ★★★★ | ★★★★★ | ★★★ |
| 1.2KB 极简件 | skills.sh 榜单件 | 极简正文的价值上限 | ★★★ | ★★★★ | ★★★★ | ★★★★★ | ★★★★ |
> 分数依据：domain-modeling 存档实测 4.4 综合分（08-31 逐段拆解）、52 万安装（skills.sh，单源）；triage 存档实测 4.25；superpowers 约束三件存档实测 4.6；其余估分依据见下文各节引证。极简件与 copy-editing 的安装/热度数据为存档标题口径，未做二次核验。
## 二、为什么「倒过来」是成立的
五维评测表的每一维，对应的都是 SKILL.md 里一个**可写的段落**，而不是一个抽象的品质：
| 评测维度 | 评测员的问题 | 作者对应的写作动作 |
|---|---|---|
| 功能完整度 25% | 边界场景处理如何？ | 写失败路径，不写成功路径 |
| 设计质量 25% | 触发词与结构如何？ | description 写成路由表，正文做渐进披露 |
| 实战效果 20% | 真的提升效率了吗？ | 写自检与验收环节 |
| 上手难度 15% | 安装配置成本高吗？ | 写依赖声明与环境兜底 |
| 社区活跃度 15% | 更新与响应如何？ | 写可维护的表述法，让别人敢改 |
这张映射表是本文的骨架。八轮评测攒下的所有「高分案例」，逐维挂回右列，就是一份写作指南——不需要发明新理论，只需要把评分标准交给作者。
## 三、维度一：功能完整度——写失败路径，别写成功路径
评测表里功能完整度权重最高（25%），判据是「边界场景处理如何」。翻到作者侧，一个反直觉的结论是：**SKILL.md 里最值钱的段落，写的全是不顺利的情形**。
三个存档案例。其一，本周拆过的某接线件（r5-1133 期）用整整一段处理 MCP 未连接：安装命令、OAuth 登录、重启提醒，甚至给了 Windows/WSL 下用 `mcp-remote` 走 SSE 的兜底 JSON 配置——多数 Skill 假设环境就绪，它假设环境一定会坏。其二，官方 webapp-testing 把「环境起不起来」做成独立决策树分支，`with_server.py` 承担服务生命周期托管，文档自称这个「必要之恶」是刻意为之——边界场景不是附录，是主干。其三，domain-modeling 在 frontmatter 之后先划「负面空间」：明说哪些任务**不该**用它。评测员给「边界处理」打的分，一大半落在这些段落上。
给写作者的操作结论：动笔前先列三样东西——环境会怎么坏、输入会怎么怪、这个 Skill 会**被误用**到哪里。这三样各写一段，功能分就有了下限；只写成功路径的 SKILL.md，评测表第一列就先丢一半。
## 四、维度二：设计质量——description 是路由表，正文是抽屉
设计质量 25% 的判据是「触发词设计、提示词工程水平」，这是八轮评测里拉开分差最大的一维。翻到作者侧，拆成两个动作。
**动作一：把 description 写成路由表，不是简介。** 存档反复验证过同一条规律：官方仓库里 Prisma 件的 description 每一条都是「用户会说出口的原话级任务」——「帮我在生产环境跑迁移」「从 Prisma 6 升到 7」；domain-modeling 一条 description 埋三个触发器；91 万安装的 grill-me 更进一步，触发于用户的**认知状态**（「我不确定这个状态机对不对」）而非指令词，所以用户不需要念出「原型」这个咒语也能路由到位。反面样本本栏目也报道过：「无描述闯榜」那一期整版都是 description 缺失的榜单件——它们靠别的东西上榜，但没有一个成为范本件。写作口诀一句话：description 不是「我是什么」，是「用户什么时候会需要我」，每一条都要是原话。
**动作二：正文做成抽屉，不是倾倒。** codebase-design 的结构是教科书：SKILL.md 只管词汇与原则，DEEPENING.md 管依赖分类与接缝纪律，DESIGN-IT-TWICE.md 是完整的多代理编排协议——三个文件按需加载，上下文窗口留给触发时刻。webapp-testing 的 examples/ 目录同理。注意别和「极简主义」混淆：59 万安装的 1.2KB 极简件证明上限可以很高，但它是触发面极窄的单点件；渐进披露的正解是「入口薄、抽屉深」，不是「全都很薄」。
**一个规范层陷阱必须单独说**：taste-skill 的 README 专门强调，安装命令 `--skill` 参数跟的是 frontmatter 里 `name:` 字段的值（`design-taste-frontend`），不是文件夹名（`taste-skill`）——大量用户装不上单个 Skill 就栽在这里（单源：08-28 存档引其 README）。作者侧的对应动作：让 `name:` 与文件夹名一致，或者在 README 第一屏就写清两者差异。这一条不写，上手分的失分方式会非常隐蔽。
## 五、维度三：实战效果——把验收环节写进文件
实战效果 20% 是最难在动笔时自证的一维——安装量是滞后指标，等数字出来再改就晚了。作者侧的替代做法：**把验收环节预先写进 SKILL.md**，让模型自己证明活干完了。
三个不同流派的存档样本：superpowers 的 `verification-before-completion` 用铁律代码块禁止「没验证就宣布完成」，配反合理化表预先反驳每一句自我辩护（「这次改动很小不用测了」→ 为什么不成立）；dbs-ai-check 把自检规则直接列成清单；本会话注册表里的官方地基件 fewer-permission-prompts 则是自反思型——每轮结束回顾自己的权限申请记录再改进规则。三家的共同点：都不指望模型「更自觉」，而是把「怎么算做完了」从运行时的临时判断，提前固化成文件里的条文。
给写作者的判据借用存档里 writing-great-skills 的表述法：每条指令都要「checkable 且 exhaustive」——可检验、且覆盖全。写完一条正文指令就问自己：模型做完这条，我**用什么证据**知道它做了？答不上来，这条就是空话，删掉或改写成可检验形式。
## 六、维度四：上手难度——依赖声明与环境兜底
上手难度 15% 的判据是「安装/配置成本」。评测侧有一条成熟的查依赖方法（09-03 存档总结）：看 frontmatter 有无 `requires` 声明、README 有无环境清单，node/ffmpeg 缺一项，上手成本翻倍。翻到作者侧就是两句话的事，但生态里大量 Skill 就是不写。
反面教训最深的一个来自 mattpocock/skills：triage 强依赖 `/setup-matt-pocock-skills` 先写入配置，**裸仓库装上跑不起来**（存档已证）——这套件设计分顶格，上手分却被配置依赖拖到三星，本期对比表里可见。正面对照是 superpowers：进了 Anthropic 官方插件市场，`/plugin install superpowers@claude-plugins-official` 一条命令，上手分加满。
写作动作清单：① frontmatter 声明全部外部依赖（MCP 服务器、CLI、语言运行时）；② README 第一屏给三条路径——一键安装、手动放置（`git clone` 到 `~/.claude/skills/`）、依赖自检命令；③ 给出「坏了怎么办」的最短排查段。这三条写全的 Skill，上手分不会低于四星。
## 七、维度五：社区活跃度——表述法决定别人敢不敢改
社区活跃度 15% 看起来是作者控制不了的维度（Star、下载量都是结果），但八轮评测观察到一个被低估的相关性：**可维护的表述法会让社区敢于介入**。writing-great-skills 式的「checkable 且 exhaustive」条文、triage 的状态机显式建模（2 个前置角色 + 5 个工作流角色，每个转移条件写明），本质都是把「隐性判断」翻译成「显式条文」——显式条文才能被 PR 修订，隐性行文只能被 fork。triage 本身就是证据：2026 年 4 月 28 日才被 skills.sh 收录，靠半年爬上总榜第 11（安装量在不同页面存在 415.8K–665.6K 口径差异，如实标注），迭代速度依赖的正是它条文化的写法。
作者侧的检验法：把自己 SKILL.md 里任意一段交给陌生人改，改错了会不会立刻被发现？会发现——说明表述可审计；不会发现——这段就是维护负债。
## 八、反面清单：五种常见死法
正面清单讲完，按评测表的失分点倒排五种死法（与「新星榜暗面」那期的内容型问题——梗件、蹭牌、书改——不同，这里是纯设计层的死法）：
1. **无 description**：路由层直接失明，触发全靠运气。「无描述闯榜」期整版样本。
2. **description 写成百科**：「我是什么」长文——模型路由匹配的是用户原话，不是产品自述。反例对照：Prisma 件的原话级任务行。
3. **正文一次倾倒**：几万字塞进 SKILL.md，触发即爆上下文。对照 codebase-design 的抽屉结构。
4. **假设环境就绪**：不写依赖、不写兜底，第一次真实运行就报错。对照 r5-1133 期的 Step 0。
5. **name 与文件夹不一致且不说明**：装不上，且错误信息不指向真因。对照 taste-skill 的 README 教训。
## 九、预检清单：动笔前的五问
五维评测表翻面，压成动笔前自答的五个问题——按本系列评分权重排序：
1. **失败卷**：环境会怎么坏、输入会怎么怪、会被误用到哪里？各写一段了吗？（功能 25%）
2. **路由卷**：description 每条都是用户原话吗？埋了几个触发器？正文抽屉分几层？（设计 25%）
3. **验收卷**：每条指令「checkable 且 exhaustive」吗？做完的证据是什么？（实战 20%）
4. **安装卷**：`requires` 声明、三条安装路径、坏了怎么办，齐了吗？（上手 15%）
5. **维护卷**：随便一段交给陌生人改，改错能被发现吗？（社区 15%）
```mermaid
flowchart TD
A[动笔前：五维预检] --> B[功能 25%]
A --> C[设计 25%]
A --> D[实战 20%]
A --> E[上手 15%]
A --> F[社区 15%]
B --> B1[写失败路径
环境坏/输入怪/被误用]
C --> C1[description 路由表
正文抽屉化渐进披露]
D --> D1[checkable 且 exhaustive
验收条文进正文]
E --> E1[requires 声明
三条安装路径 + 排查段]
F --> F1[显式条文可审计
陌生人能改]
B1 --> G{五卷全过？}
C1 --> G
D1 --> G
E1 --> G
F1 --> G
G -->|是| H[发布]
G -->|否| A
```
## 推荐排行榜
- **最值得整篇精读的范本**：domain-modeling（存档实测 4.4）——description 路由、负面空间、ADR 三重门，维度二两个动作的完整出处。
- **最值得抄结构的范本**：官方 webapp-testing——决策树 + 生命周期托管 + examples/ 抽屉，失败路径写法的满分样本。
- **条文写法最锋利的范本**：superpowers 约束三件（存档实测 4.6）——维度三验收条文的出处。
- **最值得引以为戒的范本**：triage（存档实测 4.25）——设计顶格但配置依赖拖累上手分，「裸仓库跑不起来」是所有作者该贴在屏幕上的反例。
- **成本最低的入门动作**：装一件、拆一件、按五问改一件——`npx skills add mattpocock/skills` 后先读 domain-modeling 原文，再用本文五问给它挑三处刺，比读十篇方法论都快。
五轮设计模式提炼到此凑齐三条正交路径：按**层**（八种写法）、按**范式**（禁令与编排）、按**评分反推**（本期）。层告诉你东西放哪，范式告诉你用什么语气管住模型，评分反推告诉你评委从哪里扣分。三者叠用不冲突——而其中唯一在动笔当天就能见效的，是先把五问答完再写第一行。
## 参考来源
1. 本站存档《本周爆款Skill的八种写法》（2026-09-03，skills-ecosystem-0343.md）— 四层写法框架（本文刻意避开的路径之一）与 domain-modeling 依赖声明写法
2. 本站存档《28万星框架对拆：禁令与编排》（2026-09-04，skills-ecosystem-r8-0507.md）— superpowers 281,342 星、mattpocock/skills 247,432 星双源数据，铁律三件 4.6 与 triage 4.25 存档实测分
3. 本站存档《总榜第10、11名：流程胶水Skill横评》（2026-08-29，skills-ecosystem-r3-0225.md）— triage 状态机建模、2026-04-28 收录时间与 415.8K–665.6K 安装口径差异
4. 本站存档《官方捆绑Skill横评拆解》（2026-08-28，skills-ecosystem-r3-1524.md 与同日 r2-0657）— webapp-testing 决策树、with_server.py 生命周期、examples/ 渐进披露的逐段引证
5. 本站存档《91万安装的grill-me：SKILL.md逐行拆解》（2026-08-30，skills-ecosystem-r8-0454）— 认知状态触发设计与 91 万安装口径（单源）
6. [mattpocock/skills](https://github.com/mattpocock/skills) / [obra/superpowers](https://github.com/obra/superpowers) / [anthropics/skills](https://github.com/anthropics/skills) — 范本件所在仓库；本期抓取通道不可用，正文级细节以标注的存档拆解为准
> [!tip] 51学通信知识星球
> **星主：爱卫生**（微信：gprshome201101）——公众号「51学通信」创办者，19 年通信行业运维与讲师经验，著有《GPRS网络信令实例详解》《EPC原理与实践》《5G核心网原理与实践》三本纸质书（各大电商平台有售）。
> **星球定位**：深耕 5G 核心网、IMS、NFV/AI、云原生等 ICT 领域，主打运维岗位与信令分析。
> **当前规模**：5200 篇主题 / 990 个回答，198 元/年。
> **加入福利**：加入星球后请加爱卫生微信，拉您进知识星球年度陪伴与答疑群——不限量回复您的各种问题，另有群内分享。
> **AI 加持**：51学通信知识星球已作为 skill 接入 WorkBuddy，使用 deepseek-4-flash 在海量星球帖子中精准找贴、找视频、找 FAQ 和案例，做总结、找文档和 PPT 等场景全覆盖。
