一句话验收一个 AI skill:场景枚举查入口覆盖 → 路径模拟查流程断链 → 统一验收报告。
你的 skill「看起来很完整但实际用不了」?这个验收流水线把两套互补的方法论串成一条命令:
- 结构体检(静态清单)——孤儿 references、断裂引用、文档脚本割裂、触发词漂移、8g 跨文件判据对账;带
scripts/的对象加跑 7b 可执行契约核实(文档声称的脚本行为逐 flag 实跑) - 场景枚举(横向轴)——穷举「谁、说什么话、要什么结果」,查整类用户没被覆盖
- 路径模拟(纵向轴)——沿真实指令走到底,查流程断链
- 统一报告——问题清单(阻断/一般/建议)→ 等你确认 → 修复后重走
| 被引用 | 仓库 | 未安装时 |
|---|---|---|
| skill-health-audit | 体检清单 + 自动化脚本 | 降级快照收录在本仓 references/degraded-snapshots.md(附录 A) |
| path-simulation | 步骤 0 至末尾:场景枚举+路径走查 | 降级快照收录在本仓 references/degraded-snapshots.md(附录 B) |
| skill-acceptance-report-schema | 报告双层四区结构 + 台账七字段 + 严重度语义 | 本仓 Phase 4 自带要点,版式从简(证据区表可省) |
- 装齐四个 = 全功能验收
- 只装本 skill = 降级模式(内置摘要快照,权威以源仓库为准)
四件套全景:本 skill 是唯一入口与编排器(定界 → 结构体检 → 场景枚举 → 路径模拟 → 报告与台账),另外三个各管一段、彼此不重复:
skill-acceptance(本仓,编排)
├─ Phase 1 → skill-health-audit 结构体检清单 + 4 脚本
├─ Phase 2/3 → path-simulation 场景枚举 + 路径走查
└─ Phase 4 → skill-acceptance-report-schema 报告版式 + 台账字段
引用方式是「引用步骤号」而非复制内容——被引用方加一步、改判据,编排器自动跟随,不会产生副本漂移。另三个仓的 README 都有「与姊妹 skill 的关系」一节,各自写自己视角。
对你的 AI 助手说一句话:
「验收 XX skill」
输出(双层四区,结构权威定义见 skill-acceptance-report-schema):①覆盖+体量账(字符口径)→ ②问题清单(阻断/一般/建议)+ 是否修复 → ③证据区全表格(体检项/8g 配对/声称核实/场景矩阵/走查轨迹/误报)→ ④总评;交付后登记台账(status/coverage/scope/size/issues/fixed/note)。
Phase 0 定界:被测 skill 路径 + 类型(流程类/知识类)+ 范围(增量/全量——增量不豁免 8g/#7 必走项)+ 所有权(自己/第三方)+ 深度档位(日常=增量不配靶区 ≤10min;手术/发布前=全量+靶区)
↓
Phase 1 结构体检(开场跑 preflight_check.py 一次拿齐机械证据 → 人工定性;按 skill-health-audit 清单,含 7b 可执行契约核实与 8g 全量判据对账)
↓
Phase 2 场景枚举(path-simulation 步骤 0:五维矩阵)
↓
Phase 3 路径模拟(path-simulation 步骤 1 至末尾:标准/异常/跨文件 #7 判据配对)
↓
Phase 4 统一报告 🔴 报告先于修复——等确认才动手(报告按 MEDIA 交付文件卡片;聊天正文只给精编三件:问题清单表 / 覆盖账 / 待拍板表)
↓
Phase 5 修复 + 负例/回归重走
验收发现的问题,必须先出报告、等使用者确认后才修。 对每一轮新发现都生效——「同会话拍板过大方向」「改动看起来机械」都不是跳过的理由。实测违反的后果:修复未经验证、格式错位、返工。
适合:
- ✅ 新建 skill 的交付前验收
- ✅ 开发方案 / 实施计划(plan)的验收——plan 是流程类文档:结构体检核它引用的源文件与声称,场景枚举查决策点/边界场景漏没漏,路径模拟走「照着方案执行」查里程碑断链(实测:一份插件开发 plan 走查抓出 2 个阻断级会话归属错位 + 4 个一般问题)
- ✅ 多轮迭代后的 skill(孤儿/残留/触发词漂移是高频病)
- ✅ 架构改造后(旧口径残留对账)
- ✅ 开源发布前(结构不健康谈开源是空中楼阁)
不适合:
- ❌ 纯知识类文档(无执行步骤)
- ❌ 发布到 GitHub 的流程本身(另用发布清单,本 skill 只管验收)
skill-acceptance/
├── SKILL.md # 编排流程(Phase 0-5)+ 批量模式 + 陷阱表
├── references/common-pitfalls.md # 坑表(实测翻车 + 防法)
├── references/degraded-snapshots.md # 附录 A/B 降级快照(未装被引用 skill 时才读)
└── LICENSE
彬少 —— 一个什么都折腾一下的人:装系统 · 玩AI · 搭知识库 · 做设计。这个仓库里的东西都是我自己的卡点长出来的,日常在用,做完就开源。
微信公众号 「宝藏彬少」:折腾,是为了更好用。欢迎关注交流。
MIT © 2026 Binshao