<!-- title: 28万星框架对拆：禁令与编排 -->

# 28万星框架对拆：禁令与编排——流程型Skill的两派写法

## 概述

## 一、数据底盘：两个框架本周站在哪里

两条元信息先读出第一层范式差异：**描述的语气就不一样**。superpowers 说自己是个「framework & methodology」——方法论声明；mattpocock 说「Straight from my .agents directory」——个人配置公开。一个是盖楼，一个是搬家。这个差异会一路贯穿到每一份 SKILL.md 的句式里。

第二层差异在**形态**：superpowers 14 个技能，已进 Anthropic 官方插件市场，一条命令安装（`/plugin install superpowers@claude-plugins-official`，08-29 存档引其 README）；mattpocock 53 个技能，走 skills.sh 与 CLI 分发，总榜前 12 名里 mattpocock 系占 9 席（08-29 存档抓取）。小而密对大而全，这决定了两者对「单个 Skill 该多重」的不同答案。

## 二、评测对比表

| 维度（权重） | superpowers 流程型 | mattpocock 流程型 |
|---|---|---|
| 功能完整度 25% | ★★★★☆ | ★★★★★ |
| 设计质量 25% | ★★★★★ | ★★★★★ |
| 实战效果 20% | ★★★★ | ★★★★ |
| 上手难度 15% | ★★★★☆ | ★★★ |
| 社区活跃度 15% | ★★★★★ | ★★★★★ |

> 评分口径说明：这是**范式级对照分**而非单件分，由三部分构成——铁律三件 4.6/4.4/4.1 与 triage 4.25/handoff 4.15 为 08-29 两期逐段拆解的存档实测分；流程型名单件为名单级黑箱估分；superpowers 上手加分来自官方插件市场一条命令，mattpocock 上手扣分来自 triage 强依赖 `/setup-matt-pocock-skills` 写入配置（裸仓库装上跑不起来，存档已证）。两列综合分本栏目不给出——口径混杂的加权总分是假精度，这是本系列的一贯纪律。

## 三、范式A：superpowers 的禁令式——先装刹车，再装引擎

superpowers 的 14 个技能里至少 6 个是流程型：brainstorming、writing-plans、executing-plans、subagent-driven-development、using-git-worktrees、finishing-a-development-branch（08-29 存档抓取名单）。但这个框架真正确立「禁令式」范式的，是被逐段拆过的三个约束件：`systematic-debugging`、`verification-before-completion`、`receiving-code-review`。它们共用的四件写法资产，值得原样复述，因为每一件都是可搬的：

**铁律代码块**。把最不可协商的规则放进一个独立代码块，让它在正文视觉上像法条而不是建议——模型对代码块内容的服从度高于普通段落，这是用排版做提示词工程。

**反合理化表**。左栏是模型可能产生的借口（“这次改动很小不用测了”），右栏是为什么借口不成立。它不试图让模型「更自觉」，而是**预先写好每一句自我辩护的反驳**——把对抗从运行时提前到写作时。

**红旗清单**。枚举「你已经偏了」的信号：跳过步骤、宣称完成却无证据、绕过验证。清单的本质是给模型一面镜子，让它能自查而不是等用户抓包。

**阶段门升级规则**。阶段没过门，不许进下一阶段；想跳过，必须显式向用户申请而不是自行豁免。这把「流程」从一个建议变成一扇物理门。

四个资产共享同一个哲学：**模型是会被说服的，所以要把说服它的话提前堵死**。08-29 存档的判词「先装刹车，再装引擎」说的就是这个——superpowers 把一半的技能预算花在「不许做什么」上，流程型六件大概率是这套禁令语言在流程场景的延伸（此为推断：六件正文未逐行核验，但框架级写法一致性在三件深读样本上有实证）。

## 四、范式B：mattpocock 的编排式——流程是状态机，不是禁令

mattpocock 侧的手感完全不同。它的流程型不阻止你做错事，而是**让你无路可做错事**——每一步的出口只有一个。四件实证资产：

**原语复用**。`grilling`（拷问式访谈）在仓库 README 里被明确列为 grill-me、grill-with-docs、triage、wayfinder、improve-codebase-architecture 五个技能的共享原语——**一个原语、五个出口**。提问策略和终止条件只写一遍，五个上层技能各自引用。这是软件工程里的组合优于复制，直接搬进了技能设计。

**状态机化角色**。triage 把 issue 分流做成一个小状态机：2 个分类角色（bug/enhancement）+ 5 个状态角色（needs-triage / needs-info / ready-for-agent / ready-for-human / wontfix），每条 issue 任意时刻有且只有一个角色。存档判词精确：模型不需要「理解」流程，只需要「执行」流转。禁令式靠堵，编排式靠**把自由度收窄到不存在**。

**强制 AI 披露**。所有发到 tracker 的 AI 评论必须以 `> *This was generated by AI during triage.*` 引用行开头。「这是 AI 说的」被写进协议而不是道德呼吁——治理层的产品化意识领先大多数 Skill 一个身位。

**分层调用架构**。套件明确区分 user-invoked（用户显式召唤）与 model-invoked（模型自动触发）两级，并把描述里的依赖声明写成 "when another skill needs..."（0343 存档引 domain-modeling）——技能公开声明自己是别的技能的依赖库，53 件的上下文账就是这么算平的。

两派对比到句法层面就很清楚了：superpowers 的高频句式是 **never / do not / 必须先**；mattpocock 流程件的高频结构是 **if state X then only action Y**。前者在跟模型的「抄近道本能」作战，后者干脆把近道拆掉修成单行道。

## 五、模式提炼：写流程型 Skill 的五条可抄模式

本期轮次职责是设计模式提炼，五条按「可搬运程度」排序，每条注明出处与适用条件：

```mermaid
flowchart TD
    subgraph 禁令派_superpowers
        A1[铁律代码块] --> A2[反合理化表]
        A2 --> A3[红旗清单]
        A3 --> A4[阶段门升级规则]
    end
    subgraph 编排派_mattpocock
        B1[原语复用<br/>一个原语五个出口] --> B2[状态机化角色<br/>任意时刻单一状态]
        B2 --> B3[强制AI披露协议]
        B3 --> B4[分层调用与依赖声明]
    end
    A4 --> C{你的场景}
    B4 --> C
    C -- 模型爱抄近道/后果不可逆 --> D[选禁令式]
    C -- 步骤可枚举/流转可判定 --> E[选编排式]
    C -- 严肃生产环境 --> F[两派混装<br/>刹车+单行道]
```

**M1 反合理化表**（出自 superpowers 铁律三件）。适用：任何「模型总给自己找借口」的环节，如跳过测试、提前宣布完成。写法：两列表，左栏借口原话，右栏反驳。成本最低、见效最直接的一条。

**M2 状态机化**（出自 triage）。适用：步骤可枚举、每步出口有限的流程。写法：把流程中的每个中间态命名成角色/状态，规定任意时刻有且只有一个，流转条件写成 if-then。判定成本从「理解」降到「查表」。

**M3 原语复用**（出自 mattpocock README 架构）。适用：套件内五个以上技能共享同一能力。写法：把共享能力抽成独立底层技能，上层件在正文里引用而非复述。上下文预算的复利来源——但单技能作者用不上，这是套件作者的模式。

**M4 阶段门 + 显式豁免**（出自 verification-before-completion 与阶段门规则）。适用：不可逆操作之前（部署、删除、对外发布）。写法：门条件写成 checkable 且 exhaustive 的判据（此表述法亦见于 mattpocock 的 writing-great-skills——两派在「判据可检验」这一点上罕见共识），豁免权永远在人不在模型。

**M5 协议化披露**（出自 triage）。适用：产出物会进入多人协作界面的技能（issue、PR、文档）。写法：固定前缀/引用行 + 正文强制规则。一行协议换来整个团队对 AI 产出的可辨识度。

一个反直觉的总结：**两派其实互为补集**。禁令式堵的是「模型不该有的自由」，编排式收的是「模型剩下的自由」——成熟的生产技能往往两条都要，先修单行道，再在每条路口装刹车。

## 六、本周信号：官方从「给 Skill」转向「给架构」

把它放进本期的范式框架里看，第三种分发形态浮现了：superpowers 卖方法论，mattpocock 卖个人工作流，commerce-agents 卖行业参考架构——**Skill 仓库正在从「技能的容器」变成「知识的发行格式」**。08-29 存档早已旁证过这个趋势的暗面（fork 蹭名、镜像刷量），今天这条四倍增速曲线是它的明面。对想入场写 Skill 的人，含义很直接：品类词（framework、blueprint、methodology）正在成为新的描述层战场，单纯「我做了个 Skill」的定位颗粒度已经不够用了。

## 七、怎么选、怎么装

按团队状态二选一或混装（判断框架出自 08-29 存档，本期沿用并细化）：

- **模型频繁抄近道、改动不可逆**（支付、删除、生产部署）：superpowers 的刹车优先。
- **流程步骤清晰、追求可预测产出**（issue 分流、规格到工单、会话交接）：mattpocock 的单行道优先。
- **严肃生产环境**：两派混装——用 mattpocock 的状态机定义正路，用 superpowers 的反合理化表堵住每条岔路的借口。

```bash
# superpowers：官方插件市场一条命令（README 口径，存档 8-29 期引）
/plugin install superpowers@claude-plugins-official

# mattpocock 全家桶（含 triage/handoff/grill-me/tdd 等 53 件）
npx skills add mattpocock/skills

# 通用手动安装（任一仓库皆可）
git clone --depth 1 https://github.com/obra/superpowers ~/.claude/skills/superpowers
git clone --depth 1 https://github.com/mattpocock/skills ~/.claude/skills/mattpocock-skills
```

注意两点：mattpocock 系的 triage 装完必须先跑 `/setup-matt-pocock-skills` 写入 tracker 与 label 配置（GitHub/Linear/本地文件三选一），裸装不可用；superpowers 全装 14 件会占用常驻描述上下文，按需禁用暂不用到的件是合理操作（此为按官方加载模型的推断，非实测结论）。

## 推荐排行榜

- **写法资产最值钱**：superpowers 约束三件（4.6/4.4/4.1，存档实测）——四件套写法资产 M1/M4 的出处，任何写 Skill 的人都该读一遍原文。
- **架构最值得抄**：mattpocock triage（4.25，存档实测）——状态机 + 披露协议 + 角色即状态，编排式的完整标本。
- **最被低估的模式**：grilling 原语复用——「一个原语五个出口」在安装量上是 1820 万次级别的验证，公开讨论它的人却不多。
- **本周信号位**：commerce-agents 一天 3.8 倍——官方蓝图形态的第一次爆发，下个周期值得持续跟踪其仓库结构。

八轮拆完，本期补上了这个系列最后一块显眼的空当：两大头部框架从未同台，而它们恰好各执控制范式的一端。描述决定命运是本系列第一课，本期是它的续篇——**描述决定来不来，范式决定来了之后模型是「不敢错」还是「错不了」**。星数只是滞后的读数，句式才是当下的证据。

## 参考来源

> [!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 等场景全覆盖。

![51学通信知识星球海报-扫码加入](https://wiki.500nian.com/images/zhixingqiu_qrcode.png)
