# 先例研究：LeMetaSkill v1.0.0

研究日期：2026-10-05。研究方式：浅 clone 两个仓库，通读 SKILL.md、references、scripts、evals 全部源文件。

## 候选

### 1. joeseesun/qiaomu-meta-skill（直接同行）

- 来源：https://github.com/joeseesun/qiaomu-meta-skill
- 定位：英文为主的"Skill OS"——研究、创建、改进、评估、打包、治理、发布 qiaomu 风格 skill 的全生命周期流水线，v2.8.x。
- 为什么入选：与本 skill 职责重叠最大的公开实现，工程化程度最高。
- 维护信号：版本迭代到 2.8.1，含 tests/、reports/ 真实迭代记录（2026-07/08）。

### 2. LearnPrompt/luban-skill（直接同行 + 手艺同行）

- 来源：https://github.com/LearnPrompt/luban-skill
- 定位：中文工匠人设的"Skill 打磨工坊"——把已有 skill 打磨成可传播的公共资产，五动作方法论（验料/访行/过尺/慢刨/回炉）。
- 为什么入选：明确**不做从零创建**（官方建议用 skill-creator），恰好与本项目互补；其中文输出契约、停手点纪律是三家中最强的。

### 3. ZCode 内置 skill-creator（手艺同行）

- 来源：ZCode 官方插件（本地缓存），非公开仓库
- 定位：通用 skill 创作循环——意图捕获、起草、测试 prompt、迭代。
- 为什么入选：宿主环境的官方基线；任何个性化 meta skill 都必须先吃透它的目录约定和加载模型。

## keep / adapt / reject / invent

**保留（keep）**
- 单一创建权威规则（触发后不再调 skill-creator，防双重初始化）→ 落在 SKILL.md 工坊总则。
- "写准不写长"、先验证触发再扩内容、description 先行 → SKILL.md 总则 + writing-craft.md。
- 渐进披露三层加载模型 → writing-craft.md + architecture.md。
- 通用化门（单例教训两个领域复现才进核心规则）→ SKILL.md 第二道门。
- 证据三级标签 [设计优势]/[已验证]/[假设] 与"证据缺失"诚实条款 → handoff.md。
- 概念族触发判定（required_families + families_required）→ trigger_eval.py。首版用纯覆盖率算法，冒烟测试自己暴露 5 处误判后改用此法——这是先例方法在实战中优于自研首版的直接证据。

**改造（adapt）**
- 乔木四档（Scaffold/Production/Library/Governed）→ 三档（draft/shared/rigorous）：砍掉发布治理档（职责范围外），把发布相关的门禁全部移除，只保留创建+迭代。
- 乔木触发评估（英文概念词典内嵌脚本）→ 中英双语 + 用例文件声明概念族 + 负触发词覆盖判定，且实测分层明确写成"冒烟≠行为"。
- 鲁班九维评分（100 分制，面向发布打磨）→ 六维（触发与边界/可执行具体性/工作流清晰度/失败模式/实测/资源纪律），删去传播类维度（安装率/showcase），保留"每个分数必须给证据"。
- 鲁班冻结基线 + 验证门 + 单面慢刨 + 独立验收视角 → iteration.md 全套吸收，"commit 即 push"改为可回退基线（本环境无 git 约定）。
- 鲁班出生证清单/README house 模板 → 简化为 shared 档 README 三节起步（价值/触发/安全边界），发布类必备件（marketplace.json、GIF、徽章）不采用。

**舍弃（reject）**
- GitHub 发布流水线（feature branch → PR → release → npx 安装验证）：用户明确职责范围为创建+迭代，不含发布。
- Skill IR 导出、agents/interface.yaml、manifest.json：面向跨平台发布的中间表示，当前无此需求；若未来要发布可再引入。
- 鲁班的"出师证书"结果卡、README 十条铁律、showcase 优先级：面向公共资产传播，自用 skill 不需要。
- 乔木的 prior-art 双目录搜索脚本（skills.sh/SkillsMP API）：搜索渠道随时会变，改为方法论 reference + 人工搜索，工具不绑定特定目录服务。

**原创（invent）**
- ZCode 专属适配：发现路径优先级（.zcode/skills > .agents/skills，同名覆盖语义）、frontmatter 最小契约、正文 ≤500 行预算——三份先例均面向 Claude Code 系生态。
- validate_skill.py 的悬空引用检查（正文引用的 references/*.md 必须存在）+ 私有路径拼接式扫描（避免扫描器匹配自身源码，实测踩过的坑）。
- scaffold→validate→trigger_eval 的端到端出生即合规流水线（乔木有 validate 但无 scaffold；鲁班有 scaffold 但无 trigger eval）。
- 验证资产沉淀问题（"这次的验证手段能不能留下来？"）写进迭代交付步骤。

## 未找到的证据

- 未找到专门面向 ZCode（而非 Claude Code）生态的公开 meta skill——三家先例全部以 Claude Code/skills.sh 生态为主。此为差异化空位，也是本 skill 的存在理由之一。
- 各先例的触发实测数据（live-turn 结果）均未公开，只有词面/结构检查；本 skill 的实测同样待补（见 creation-handoff.md 的证据缺失声明）。