乐于分享
好东西不私藏

不会写AI技能?用姚老师的这个元Skill,直接写出90分的Skill

不会写AI技能?用姚老师的这个元Skill,直接写出90分的Skill

开源社区的「技能工厂」,正在改变我们构建AI能力的方式


几个月前,如果你问一个AI工程师「你会写skill吗」,他可能会自信地说「会啊,不就是写提示词嘛」。

现在你再问同样的问题,答案可能就复杂多了。

随着Claude Code、OpenAI Codex等编程智能体的普及,「skill」这个概念已经从简单的提示词升级为一个包含指令、参考文档、脚本、测试用例、跨平台适配器的完整软件包。

但问题来了:怎么写出一个高质量的skill?

如果你也面临这个困惑,姚老师的Yao Meta Skill值得了解一下。

一个skill,到底有多难写?

随着大模型能力的提升,我们越来越习惯于通过提示词(Prompt)来"教"AI完成特定任务。但一个团队中,有价值的业务知识往往散落在:

  • 个人笔记本里零散的提示词片段
  • 微信群聊中口口相传的"最佳实践"
  • 临时编写的、用完即弃的一次性脚本
  • 每个人大脑中隐式的工作流程

这种状态带来的问题是显而易见的:

  • 知识无法沉淀和复用
  • 质量参差不齐,依赖个人经验
  • 难以评估和改进
  • 无法跨团队、跨平台共享

你可能会说:这不就是"提示词工程"需要解决的问题吗?是的,但只靠提示词本身远远不够。

Yao Meta Skill(以下简称Yao)提出的思路是:把AI技能当作软件工程中的"组件"来构建和维护,而不是当作一次性文本片段。 我们来看一个高质量的skill需要具备什么:

  • 清晰的触发边界:什么情况下该激活,什么情况下不该激活
  • 紧凑的指令主体:入口文件要轻,详细内容放在参考文档中
  • 可验证的输出质量:有测试用例,有评估标准
  • 跨平台兼容:能在OpenAI、Claude、VS Code等不同环境下工作
  • 可维护的版本管理:有发布记录,有迭代证据

看到这些要求,你可能已经发现了:写好一个skill,本质上是在做一次小规模的软件工程,而不仅仅是写一段提示词。

对于大多数开发者来说,从「写提示词」到「构建skill」之间的鸿沟,比想象中要大得多。

姚老师的Yao Meta Skill:一个「元技能」工厂

Yao Meta Skill解决的核心问题就是:如何系统化地创建、评估、打包和治理可复用的AI技能。

它的定位很独特——这是一个关于如何构建技能的技能(meta-skill)。

项目作者姚老师(Yao Jingang)借鉴了Anthropic官方Claude Code源码的设计思路,同时整合了全网其他模型的skill实践经验,最终形成了这个开源项目。

换句话说:如果你不会写skill,用这个skill就可以帮你写出高质量的skill。

它的设计来源:Claude Code源码 + 全网最佳实践

项目README中坦率地提到,这个「元技能」的设计参考了多个来源:

  • Anthropic官方Claude Code源码(社区称之为「泄露」的源码,实际上是开源可获取的):提供了Claude在代码智能体场景下的skill设计范式
  • OpenAI Skill Creator:学习其简洁的指令编写方法
  • 全网其他模型的skill实践:整合了不同平台的skill打包经验

这意味着,Yao不是一个凭空创造的理论框架,而是对当前主流AI技能工程实践的系统化总结和工程化包装。

它能帮你写出什么样的skill?

根据项目自评的加权质量基准:

维度
得分(满分10分)
方法深度
9.5
工具链完整性
9.5
测试严谨性
9.5
治理与生命周期
9.5
本地执行可靠性
9.5
可移植性
9.0

综合得分:91.5/100

作为对比,Anthropic Skill Creator得分为67.5,OpenAI Skill Creator得分为50.5。

用姚老师的话说:用这个元技能产出的skill,质量可以达到90分以上。

它是怎么做到的?核心机制解读

Yao之所以能帮你写出高质量skill,是因为它把整个skill构建过程做成了一个可重复的工程化流程:

1. 先澄清意图,再生成文件

很多人在写skill时,一上来就开始写指令文件。Yao的做法相反:

  • 先启动一个意图对话,澄清真正的任务目标、输出格式、排除项和标准
  • 只有在意图明确后,才会生成具体的skill文件

这避免了「写了一半发现方向错了」的低效循环。

2. 暗扫描最佳实践,只把真正的冲突抛给你

Yao会静默扫描GitHub上的优秀skill仓库,研究顶级的模式和实践。但它不会把所有参考信息都塞给你,而是只在发现真正的设计冲突或不明确时,才向你提出明确的问题。

这大大减少了认知负担。

3. 生成证据驱动的审查页面

Yao不仅仅生成一个SKILL.md文件,还会生成:

  • 一个双语HTML概览报告(默认中文,可切换英文)
  • 一个Review Studio审查面板:包含意图确认、触发测试、输出评估、权限检查、信任报告、发布证据等所有关键信息
  • 一个上下文预算检查:确保入口文件保持轻量

这些可视化报告让skill的质量一目了然,也方便团队评审。

4. 支持跨平台编译

同一个skill,可以编译为针对不同平台的版本:

  • OpenAI格式
  • Claude格式
  • 通用Agent Skills格式
  • VS Code / Copilot兼容格式

真正实现一次编写,多处部署。

真实效果:从零到一构建一个skill

如果你用Yao来创建一个新skill,典型的工作流是这样的:

# 1. 描述你想要的工作流,启动意图对话
python3 scripts/yao.py quickstart --output-dir .

# 2. Yao会先澄清你的意图,然后自动生成skill包
# 3. 生成审查页面,查看质量评估
python3 scripts/yao.py review-studio my-skill
# 4. 根据需要,编译为不同平台版本
python3 scripts/yao.py compile-skill . --target openai --target claude
# 5. 打包发布
python3 scripts/yao.py package . --platform openai --platform claude --output-dir dist --zip

整个过程,从原始的「工作流描述」到「可发布的跨平台skill包」,可能只需要几分钟。

谁应该关注这个项目?

从我个人的角度来看,以下人群会从中获益:

1. 想要系统化构建skill的开发者

如果你已经写过一些简单的skill,但感觉质量参差不齐、难以维护,Yao提供了一个完整的工程框架。

2. 团队AI能力建设的负责人

如果你们的团队正在建立共享的AI技能库,Yao的治理机制、审查流程和跨平台编译能力可以大大降低管理成本。

3. 对AI工程化感兴趣的研究者

Yao的设计本身就是一个研究案例:如何把「提示词编写」这种隐性知识,转化为可重复、可度量、可治理的工程流程。

4. 刚接触skill概念的新手

如果你还不会写skill,Yao的意图引导式创建流程可以帮你从零开始构建第一个高质量的skill。

一点思考:从「写提示词」到「构建技能」

过去两年,大模型的能力飞跃让我们习惯了「用自然语言就能编程」的幻觉。但现实是:真正可复用、可维护、可团队共享的AI能力,仍然需要工程化的方法。

Yao Meta Skill这个项目给我的启发是:

  • Skill不是提示词,而是软件组件——它需要版本管理、测试、文档和治理
  • 构建skill的过程本身可以被标准化——元skill的存在,降低了入门门槛
  • 开源社区的集体智慧是可以被系统化的——Yao整合了Anthropic、OpenAI及社区的最佳实践,形成了一套可操作的方法论

如果你也在探索「如何系统化地构建AI技能」,不妨从Yao入手,用90分的起点,开启你的skill工程之旅。


资源链接

  • GitHub: github.com/yaojingang/yao-meta-skill
  • 中文文档: docs/README.zh-CN.md

相关学习资料