清晰的触发面
精简的 SKILL.md
可选的 references、scripts 和 evals
深度起草前先做一轮更有人味的意图对话，先理解真实任务、输出物、边界和用户在意的标准
深度起草前先做一轮自动 GitHub benchmark scan，先拉取 3 个高星公开项目，提炼 borrow / avoid 模式，再结合用户参考与本地约束
会主动询问用户是否有希望借鉴的参考对象，只学习其中的模式抽象、结构和标准，不复制原文或私密内容
新建 skill 时自动生成一份极简白底 HTML 可视化说明
首次建包后会自动给出 3 个最有价值的下一步迭代方向
提供一个紧凑的 HTML review viewer，方便第一次人工理解和评审
提供一个轻量 feedback log，不必每次都走完整 promotion 流程
提供一个 with-skill vs baseline 的对比报告，便于快速看增量收益
提供一个 archetype-aware 的 quickstart，引导新 skill 落到 scaffold、production、library 或 governed 的合适形态
中性的源元数据以及面向不同客户端的适配层
内建的治理、晋升和 portability 检查

架构图

Hero 版可以压缩成一条主线：把零散输入变成一个可治理、可复用的 skill 包。

flowchart LR
    A["输入<br/>workflow / prompt / transcript / docs / notes"] --> B["路由<br/>SKILL.md"]
    B --> C["设计<br/>方法 + 质量门"]
    C --> D["执行<br/>create / validate / eval / promote"]
    D --> E["产出<br/>skill 包 + 报告 + 适配层"]

10 秒理解这张图：

输入：从零散的 workflow、prompt、文档和笔记出发。
路由：先用精简的 SKILL.md 定义边界和触发。
设计：选择合适的 archetype、gates 和资源拆分方式。
执行：通过统一 CLI 完成创建、校验、优化和晋升。
产出：最终得到 skill 包，以及评测、治理和 portability 证据。

对比快照

下面这个表更适合拿来判断“哪种系统更适合当前场景”。它是一个面向场景的比较快照，不是适用于所有情境的绝对结论。

评分维度	skill-creator	yao-meta-skill	说明
上手门槛	9	6	`skill-creator` 语言更亲切、对话更直觉；`yao-meta-skill` 概念更多，学习曲线更陡。
灵活性	9	7	`skill-creator` 更自由；`yao-meta-skill` 的流程更明确、更结构化。
方法论深度	5	9.5	`yao-meta-skill` 有更完整的 skill engineering doctrine、archetypes、gate selection、governance 和 resource boundaries。
评估严谨度	7	9.5	`yao-meta-skill` 更强调 layered holdout、route confusion、adversarial checks 和 promotion gates。
人工评审体验	9	5	`skill-creator` 的人工评审体验更直观；`yao-meta-skill` 目前仍以报告驱动为主。
治理与生命周期	2	9.5	`yao-meta-skill` 把重要 skill 当成可治理资产，具备 maturity、review cadence 和 promotion evidence。
跨环境复用	4	9	`yao-meta-skill` 采用中性元数据、adapter、degradation rule 和 portability checks。
工具链完整度	6	9.5	`yao-meta-skill` 提供更完整的工具链、统一 CLI、CI 和报告系统。
迭代效率	8	7	`skill-creator` 在快速小循环上更轻；`yao-meta-skill` 会为了质量门和证据多付出一些流程成本。
文档质量	7	9	`yao-meta-skill` 现在提供多语言文档、案例、失败案例库和方法论文档。
适合个人使用	9	6	`skill-creator` 更适合个人快速试作。
适合团队/组织	5	9.5	`yao-meta-skill` 更适合团队复用、治理、CI 和长期维护。
综合	6.7	8.0	核心取舍很清楚：一个偏轻量对话流，一个偏工程化和治理化。

适用场景

如果你要的是个人快速试作、边聊边做、轻量起稿，更适合 skill-creator。
如果你要的是团队复用、显式边界、质量门、治理、可移植性和长期维护，更适合 yao-meta-skill。
一个很实用的组合方式是：先用更对话式的系统做第一版，再用 yao-meta-skill 把它加固成团队可复用的正式资产。

快速开始

先描述你想沉淀成 skill 的 workflow、prompt 集合或重复任务。
先做一轮简短但更有人味的意图对话，把真实任务、输出物、边界、约束和你在意的质量标准说清楚。
先让 quickstart 自动跑一轮 GitHub benchmark scan，读取 3 个高质量公开项目并提炼可借鉴模式；之后再结合你自己的参考对象。本地文件只做适配和隐私校准。
使用 archetype-aware 的 quickstart 或完整作者流，在 scaffold、production、library 或 governed 模式下生成或改进 skill 包。
新建 skill 后，会默认附带 reports/intent-dialogue.md、reports/skill-overview.html、reports/review-viewer.html、reports/reference-scan.md 和 reports/iteration-directions.md；后续还可以通过 feedback log 和 baseline compare 快速收集意见、查看增量收益，而不必每次都走完整 promotion 流程。

当前结果

当前 make test 可通过
当前回归集下 trigger eval 为 0 误触发、0 漏触发
train / dev / holdout 三层评测均通过
openai、claude、generic 三个目标的 packaging contract 校验通过

当前优势

根据最近一轮加权评测，Yao 当前最强的优势主要集中在真正决定 meta-skill 质量的几个维度：

方法论完整性 9.8：已经形成正式的 skill engineering doctrine，覆盖 gate selection、non-skill decision、governance 和 resource boundary。
工程化工具链 9.8：初始化、校验、优化、报告、晋升检查、打包和 CI 已经串成一条完整工具链。
治理 / 维护 / 安全 9.8：重要 skill 可以声明生命周期、review cadence、maturity score、trust boundary 和 promotion evidence。
评测闭环 9.7：触发评测已经覆盖 train/dev/holdout、blind holdout、adversarial holdout、judge-backed blind eval、drift history 和 promotion gate。
跨环境复用 / 打包 9.6：源码保持中性，adapter、degradation rule 和 packaging contract 负责保留跨环境可移植语义。
触发与边界设计 9.5：route confusion、anti-pattern regression 和 promotion policy 把 trigger 质量变成可审计的路由问题。
上下文效率 9.4：入口文件保持紧凑，context budget 分层治理，quality density 也被量化跟踪。

整体方向很明确：入口尽量轻，评测尽量硬，治理成为 skill 质量的一部分。

为什么是 Yao

轻量：入口保持紧凑，context budget 明确分层，只有在真正值得时才增加额外结构。
严谨：trigger 质量会经过 family regression、blind holdout、adversarial holdout、route confusion、judge-backed blind eval 和 promotion gate 的联合检查。
可治理：重要 skill 被当成可维护资产处理，具备 lifecycle、maturity expectation、owner 和 review cadence。
可移植：源码元数据保持中性，adapter、degradation rule 和 packaging contract 负责保留跨环境可复用语义。

它能做什么

这个项目帮助你把 skill 从一次性 prompt，升级成可创建、可重构、可评估、可打包的长期能力包。

它的设计逻辑很简单：

识别用户请求背后真正重复发生的工作
划清 skill 边界，让一个包只做一个连贯的任务
优先优化触发 description，而不是先把正文写长
保持主 skill 文件精简，把细节移到 references 或 scripts
只在值得时加入质量门槛
只为真正需要的客户端导出兼容产物

为什么要做它

大多数团队的重要操作知识都散落在聊天记录、个人 prompt、口头习惯和未成文 workflow 中。这个项目的作用，是把这些隐性流程知识转成：

可发现的 skill 包
可重复的执行流程
更低上下文负担的指令
可复用的团队资产
可兼容分发的产物

仓库结构

yao-meta-skill/
├── SKILL.md
├── README.md
├── LICENSE
├── .gitignore
├── agents/
│   └── interface.yaml
├── references/
├── scripts/
└── templates/

核心组成

`SKILL.md`

主 skill 入口，定义触发面、工作模式、压缩后的工作流和输出契约。

`agents/interface.yaml`

中性的元数据单一来源。它保存显示信息和兼容性信息，不把源码树锁定到某一家厂商的专属路径。

`references/`

用于存放不应该塞进主 skill 文件的长文档，包括设计规则、评估方法、兼容策略和质量 rubric。

`scripts/`

让这个元 skill 具备工程化能力的辅助脚本：

trigger_eval.py：检查 trigger description 是否过宽或过弱
context_sizer.py：估算上下文体积，并在初始加载过大时给出警告
cross_packager.py：从中性的源码包生成客户端特定的导出产物

`templates/`

用于生成简单 skill 和更复杂 skill 的起步模板。

如何使用

1. 直接使用这个 skill

当你想做以下事情时，可以调用 yao-meta-skill：

创建新 skill
改进已有 skill
给 skill 增加 eval
把 workflow 变成可复用包
为更广泛的团队使用准备 skill

2. 生成一个新的 skill 包

典型流程是：

描述 workflow 或能力
识别触发语句和目标输出
选择 scaffold、production 或 library 模式
生成 skill 包
在需要时运行体积检查和触发检查
导出面向目标客户端的兼容产物

3. 导出兼容产物

示例：

python3 scripts/cross_packager.py ./yao-meta-skill --platform openai --platform claude --zip
python3 scripts/context_sizer.py ./yao-meta-skill
python3 scripts/trigger_eval.py --description "Create and improve agent skills..." --cases ./cases.json

优势

方法论优先，不是 prompt 优先：skill creation 被当成正式工程流程，而不是只写一段说明文字
天生面向触发优化：description 会经过 route confusion、blind holdout、adversarial family 和 promotion policy 的检查
入口轻量：SKILL.md 保持克制，references、scripts、evals 只在真正值得时加入
工具链完整：初始化、校验、优化、报告、打包、测试，都能走统一 CLI 和 CI 路径
治理化资产：重要 skill 可以带 owner、lifecycle、maturity expectation 和 review cadence
默认可移植：源码中立，兼容性通过 adapter 和 degradation rule 处理
证据密度高：route scorecard、regression history、context budget、portability score、promotion decision 都是公开产物，而不是隐藏实现

最适合谁

这个项目尤其适合：

agent 构建者
内部工具团队
正在从 prompt engineering 转向 skill engineering 的人
想构建可复用 skill 库的组织

许可证

MIT。见 LICENSE。

README.zh-CN.md Unescape Escape

Yao Meta Skill 中文介绍

架构图