企业官网建设流程全解析

一张HTML页面搞定技能审查：Yao Meta Skill的Review Studio 2.0门禁详解

【免费下载链接】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

Yao Meta Skill（YAO = Yielding AI Outcomes）是一套面向可复用 AI 智能体技能的工程化系统，而 Review Studio 2.0 是它的发布审查门面——把意图、触发路由、输出评测、上下文成本、运行时、信任扫描、豁免审批等十几个门禁，全部压缩进一张可离线打开的 HTML 页面，让审查者在发布前一眼看清：哪些是阻断项（blocker），哪些是警告（warning），每条问题又该去哪里修、用哪条命令验证。

为什么需要"一页式"技能审查门禁 🚪

在 Review Studio 出现之前，一个技能包的质量散落在十几份独立报告里：触发评测、输出对比、信任扫描、权限探针……审查者要在多个文件之间反复跳转，才能拼出"这个技能能不能发布"的结论。

Review Studio 2.0 的设计目标很直接（见 references/review-studio-method.md）：

• 汇总发布阻断项与警告，不让问题藏到包越做越深之后才暴露
• 每个门禁都链接到具体证据文件，结论可追溯
• 为每条警告生成"审查动作"：修复位置、证据引用、验证命令一次给全
• 让豁免（waiver）和批注（annotation）全程可审计，人接受风险必须留痕
• 纵向审查流：先摘要、再门禁、后细节，避免跨页面跳来跳去

16 道门禁：从意图画布到发布说明 🧭

Review Studio 2.0 按门禁合约（gate contract）校验 16 道门禁，缺一不可，实际数据可在 reports/review-studio.json 中查看：

门禁语义只有三种，简单明确：

• ✅pass：证据齐全，门禁满足
• ⚠️warn：审查可继续，但发布前问题必须可见
• ⛔block：修复前不得宣称生产级、库级或受治理发布就绪

例如本仓库自身的 Review Studio 摘要显示：16 道门禁、0 个阻断、3 个警告（output-lab、review-waivers、world-class-evidence），决策为review，world-class 得分 91——这份 JSON 里的review_actions恰好就是 3 条与警告一一对应的修复动作。

审查动作：从"看到警告"直达"动手修复" 🔧

这是 2.0 最有价值的设计：每个未通过的门禁都必须生成一条review_actions条目。每条动作都包含：

• summary/why：问题是什么、为什么拦
• source_fix+source_refs：指向最小粒度的报告或源文件，带行号锚点和源码摘录，审查者不用打开大文件就知道该看哪
• verification_command：修完后跑哪条命令验证
• evidence：支撑结论的证据文件

页面会把动作卡片渲染在详细证据区块之前，审查路径是：警告 → 动作 → 修复 → 验证。全部门禁通过时，review_actions为空列表，页面也会明确写出"无阻断、无警告动作"。

豁免与批注：人工决策的审计账本 📋

• 审查豁免（Review Waivers）：警告级风险可以人工接受，但必须记录审查者、理由、范围和过期时间，且永远不能把阻断项变成通过。台账见 reports/review_waivers.md
• 审查批注（Review Annotations）：挂在某个门禁 + 相对路径 + 可选行号上的评论，用于保留审查上下文和修改要求；未关闭的阻断级批注会把整体决策压回blocked。账本见 reports/review_annotations.json

两者职责清晰：批注不是豁免，动作不改变门禁计数，只是让当前决策更可操作。

如何生成你自己的 Review Studio 页面 ▶️

两种方式任选，入口脚本为 scripts/render_review_studio.py，统一 CLI 见 scripts/yao.py：

# 方式一：统一 CLI（推荐） python3 scripts/yao.py review-studio my-skill # 方式二：直接渲染脚本 python3 scripts/render_review_studio.py my-skill \ --output-html reports/review-studio.html \ --output-json reports/review-studio.json

生成的 reports/review-studio.html 是单文件静态页面，可直接发给同事在浏览器打开——无需安装环境，这就是"一张 HTML 页面搞定技能审查"的含义。渲染契约由 assets/review-studio.css 与 scripts/review_studio_layout.py 维护。

延伸阅读 📚

一句话总结：Review Studio 2.0 把技能发布审查从"翻十份报告"变成"读一张门禁页"——摘要先行、证据可溯、警告带修复动作、人工决策全留痕。当你准备把一个技能交给团队或生产环境之前，这一页就是最值得花十分钟打开的地方。

【免费下载链接】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