Skip to content

Latest commit

 

History

27 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

✅ Skill 验收流水线(skill-acceptance) 版本

一句话验收一个 AI skill:场景枚举查入口覆盖 → 路径模拟查流程断链 → 统一验收报告。


这是什么(30 秒看懂)

你的 skill「看起来很完整但实际用不了」?这个验收流水线把两套互补的方法论串成一条命令:

  1. 结构体检(静态清单)——孤儿 references、断裂引用、文档脚本割裂、触发词漂移、8g 跨文件判据对账;带 scripts/ 的对象加跑 7b 可执行契约核实(文档声称的脚本行为逐 flag 实跑)
  2. 场景枚举(横向轴)——穷举「谁、说什么话、要什么结果」,查整类用户没被覆盖
  3. 路径模拟(纵向轴)——沿真实指令走到底,查流程断链
  4. 统一报告——问题清单(阻断/一般/建议)→ 等你确认 → 修复后重走

依赖关系(先看这个)

被引用 仓库 未安装时
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

About

【Skill 验收流水线 v1.6.6】一句话验收 skill 或开发方案:Phase 0 定界 → 结构体检(skill-health-audit)→ 场景枚举 + 路径模拟(path-simulation)→ 报告与台账(skill-acceptance-report-schema)。四件套的编排器/唯一入口。附录 A/B 为降级快照,未装姊妹 skill 也能独立跑。

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors