在Yao Meta Skill里写脚本与生成报告面向开发者的完整指南【免费下载链接】yao-meta-skillYAO Yielding AI Outcomes. A rigorous engineering, evaluation, governance, and portability system for reusable agent skills.项目地址: https://gitcode.com/gh_mirrors/ya/yao-meta-skillYao Meta Skillyao-meta-skill是一个用于创建、评估、治理和分发可复用 AI 智能体技能agent skills的工程系统。对开发者来说它最有价值的两件事是在scripts/目录写自动化脚本以及用这些脚本批量生成可读的质量报告输出到reports/。本文用最小例子带你跑通从写一个脚本到一键刷新全部报告的完整流程新手照着做 10 分钟即可上手 先看清结构脚本放哪、报告放哪写代码之前先知道东西该放哪里这是本项目的核心纪律。目录职责例子scripts/确定性、可重复执行的逻辑工具链trigger_eval.pyreports/脚本生成的质量证据JSON MDcontext_budget.mdreferences/人类/Agent 按需阅读的长文档resource-boundaries.mdSKILL.md入口保持精简SKILL.md项目对什么内容进脚本有明确规则来自 references/resource-boundaries.md确定性、重复性的逻辑 → 放scripts/不要写成散文脚本必须真正被用到SKILL.md未引用且不在 manifest 中声明的目录会被resource_boundary_check.py判定为装饰性目录并告警报告统一落在reports/JSON 存机器可读数据MD 供人阅读 一句话原则最精简、但足够可靠的包才是最好的技能包。写第一个脚本从最小可运行例子学起项目自带了一个很好的脚本范例——build_release_packet.py。它只做一件事读一个 JSON 输入文件渲染出 Markdown 报告并打印到标准输出python3 build_release_packet.py input.json output.md这个读输入 → 渲染输出的模式正是scripts/下绝大多数报告脚本的写法。照着这个模式你可以为自己的技能包写一个报告生成器建议遵守 4 条约定入口参数化用argparse接收--output-json/--output-md方便被 CLI 调用输出双格式同时写.json给程序和.md给人退出码规范成功返回0失败返回非零值——CLI 靠它判断报告是否通过只读输入、只写报告脚本不修改技能源码保持仓库可回滚生成报告render_* 脚本工作流项目把报告生成统一命名为render_*.py例如render_skill_overview.py → 生成双语 HTML 审计评分卡 skill-overview.htmlrender_context_reports.py → 生成上下文预算报告 context_budget.mdrender_portability_report.py → 生成可移植性评分 portability_score.md单独跑一个报告脚本以可移植性为例python3 scripts/render_portability_report.py .报告不是一次性产物。每次技能改动后重新运行对应脚本reports/里的 JSON/MD 会自动刷新形成可追溯的证据链——这就是为什么发布前只需要看报告、不用重新手工检查。统一CLI用 yao.py 一条命令刷新所有报告手动逐个跑render_*容易漏。项目的统一入口 scripts/yao.py 把几十个命令整合在一起最常用的几个python3 scripts/yao.py workspace-flow --target root --label first-pass # 全量刷新报告 python3 scripts/yao.py validate my-skill # 校验技能结构 python3 scripts/yao.py test # 运行完整测试workspace-flow会在内部依次调用描述优化、混淆矩阵、回归历史、上下文预算、可移植性报告等 20 多个render_*脚本最后输出一份带每个步骤ok状态的 JSON 汇总。它依赖的共享执行器 yao_cli_runtime.py 负责以子进程方式调用每个脚本并解析其 JSON 输出——想给 CLI 加新命令读懂这一个文件就够了。用 Makefile 把脚本纳入日常测试Makefile 已把所有检查打包成目标推荐两个日常命令make ci-test # CI 同款测试Python 3.11 make test # 完整本地回归评测、报告、打包、治理检查新写的脚本想被make test覆盖只需两步在 tests/ 下加一个verify_*.py验证脚本再在 Makefile 的test目标里追加。依赖统一由 requirements-ci.txt 管理python3.11 -m venv .venv source .venv/bin/activate pip install --requirement requirements-ci.txt常见问题清单FAQQ脚本可以写非 Python 代码吗A工具链以 Python 3.11 为主且有 python_compat_check.py 专门拦截不兼容写法新脚本建议保持纯标准库或最小依赖。Q报告太多会不会撑爆上下文A不会。入口 SKILL.md 只保留路由必需内容报告按需加载预算由 context_sizer.py 持续监控当前根目录 944/1000 token。Q如何保证报告之间数据一致Arender_evidence_consistency.py 会交叉比对各报告中的关键事实防止报告互相打架。总结3 步上手清单✅ 读懂 references/resource-boundaries.md明确脚本/报告/参考文档的边界✅ 参照 build_release_packet.py 的读输入→渲染输出模式写你的第一个render_*脚本✅ 用python3 scripts/yao.py workspace-flow一键刷新全部报告并把验证逻辑接入make test掌握脚本 报告这条主线后你就可以把任何重复性工作变成可审计、可回归、可分发的技能资产了 【免费下载链接】yao-meta-skillYAO Yielding AI Outcomes. A rigorous engineering, evaluation, governance, and portability system for reusable agent skills.项目地址: https://gitcode.com/gh_mirrors/ya/yao-meta-skill创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考