Oct 27, 2026
用 yao-meta-skill 把重复工作流变成可治理、团队可用的 Skill
yao-meta-skill 是一个元 skill 工厂:描述一遍重复工作流,它就生成带平台无关契约(Skill IR)的 skill 包,配套 OpenAI、Claude 等目标编译器、触发质量评测实验室和发布前的评审门禁。
团队的运营知识很少沉淀在文档里——它散落在聊天记录、个人提示词和没人写下来的习惯中。yao-meta-skill(YAO = Yielding AI Outcomes,中文可理解为产出 AI 结果)是一个 3k 星标的 MIT 开源项目,它本身是一个元 skill:职责就是创建、评估、打包和治理你的其他 skill。
为什么这个 Skill 重要
1.0 把重复工作流变成可安装的 skill 包;2.0 被 README 称为 Skill OS,在生成的 SKILL.md 外面包了一层可治理的生命周期:
- Skill IR(技能中间表示)——用平台无关的结构记录意图、触发方式、输入输出、边界、参考资料和交付产物。
- 目标编译与适配器——同一份源语义可编译到 OpenAI、Claude、通用 agent skill、Agent Skills 兼容包和 VS Code 使用场景。
- 输出评测实验室——触发检查、输出断言、执行证据和盲评材料包。
- Review Studio 2.0(评审工作台)——把意图、触发、输出评测、上下文成本、信任扫描和发布证据放进同一个 HTML 门禁页面。
- 证据与发布治理——包体验证、安装模拟,以及在证据任务未完成时阻止过早「世界级」宣传的公开宣传守卫。
- SkillOps 闭环——采用漂移与每周策展报告,把发布后的信号带回下一轮迭代。
安装
为 Codex 全局安装:
npx -y skills add yaojingang/yao-meta-skill -a codex -g -y
要为所有支持的 agent 安装,把 -a codex 换成 -a '*'。安装后重启客户端,然后自然语言对话即可——README 列出的触发语包括 "create a skill from this workflow"、"improve this existing skill"、"evaluate this skill"、"add evals to this skill"。开发这个工厂本身需要 Python 3.11 或更新版本。
实战:把工作流笔记变成受治理的包
按 README 的快速开始流程,用统一的 yao.py 命令行操作:
- 描述你想沉淀的工作流。意图对话只为核心分叉——任务、产出或方向——提出一个个性化问题,两轮后停止,并记录结构化假设。
quickstart先静默执行基准扫描和参考综合;只有当意图仍不清晰或出现真实设计冲突时才会向你提问。- 从 archetype-aware 的四种模式里选一种生成包:scaffold、production、library 或 governed。
- 查看三份 HTML 报告:
reports/skill-interpretation.html(默认简体中文,右上角可切英文)、reports/skill-overview.html看审计记分卡,reports/review-studio.html看发布阻塞项、权限批准和证据路径。 - 校验与评审:
python3 scripts/yao.py init my-skill --description "Describe what the skill does."
python3 scripts/yao.py validate my-skill
python3 scripts/yao.py review-viewer my-skill
当包要交付给其他客户端时,README 的导出路径会把 Skill IR 编译成目标平台契约再打包——compile-skill 和 package 通过 --target / --platform 标志支持 openai、claude、generic 和 vscode。
技巧
- 触发质量是核心纪律:README 的验证说明里写到,描述要在 train/dev/holdout、盲测保留集、对抗保留集、路由混淆追踪和 judge-backed 盲评全部通过后才算可晋升。
- 保持入口精简——细节放进
references/和scripts/。上下文预算是显式且被追踪的:README 报告根 skill 目前为 944/1000。 - 把 README 的加权质量评测当作自评:它给 Yao 打了 91.5/100,对比 Anthropic 和 OpenAI 的 skill creator,并刻意排除星标——这是项目给自己打的分,不是第三方证据。
- 对 OpenAI skill-creator 的 5/5 真人盲评结果,是 2026-06-29 一名评审员自行发布的快照,README 自己也标注了这一边界。
- 运行时更新检查有缓存且只读:
python3 scripts/yao.py check-update --notice --self每 24 小时最多查一次 GitHub 的VERSION,不会改动正在执行的 skill 任务。
何时不用这个 Skill
一次性的提示词不需要打包——这个仓库专门为这类判断写了非 skill 决策树方法论。README 也把对话式创建(Anthropic/OpenAI 风格)定位成「人工引导迭代比仓库级治理更重要」的场景,并建议混合用法:先对话式起草,当包需要证据、可移植性和发布门禁时再用 yao 加固。治理机制本身有成本——对于没人会复用的个人片段,README 自己的设计原则是额外结构只在有回报时才添加。
查看 排行榜 了解更多 skill。