YAO Skill 生成审计报告YAO Skill Generation Audit
yao-meta-skill
技能审计报告Yao Meta Skill Audit Report
这份报告默认使用中文简体，把新 Skill 的定位、指标、原理、契约、质量、风险、资产和迭代路线整理为一份可审计的 HTML 报告。Create, refactor, evaluate, and package agent skills from workflows, prompts, transcripts, docs, or notes. Use when asked to create a skill, turn a repeated process into a reusable skill, improve an existing skill, add evals, or package a skill for team reuse.
openaiopenaiclaudeclaudegenericgenericvscodevscode
技能概述Overview
先用一屏说明这个 Skill 是什么、给谁用、交付什么。A first-screen explanation of what this skill is, who it serves, and what it delivers.
作用定位Role
- 从工作流、提示词、对话记录、文档或笔记中创建、重构、评估和打包 agent skill；适用于新建 Skill、沉淀重复流程、改进现有 Skill、补充 eval 或团队复用打包。Create, refactor, evaluate, and package agent skills from workflows, prompts, transcripts, docs, or notes. Use when asked to create a skill, turn a repeated process into a reusable skill, improve an existing skill, add evals, or package a skill for team reuse.
- 把一次性经验沉淀为可复用、可评估、可迁移的 Skill 包体。把一次性经验沉淀为可复用、可评估、可迁移的 Skill 包体。
- 交付结果：SKILL.md, agents/interface.yaml, reports/skill-ir.json, reports/compiled_targets.md, reports/output_quality_scorecard.md, reports/output_execution_runs.md, reports/output_blind_review_pack.md, reports/output_review_kit.md, reports/output_review_adjudication.md, reports/benchmark_reproducibility.md, reports/output_blind_answer_key.json, reports/conformance_matrix.md, reports/security_trust_report.md, reports/runtime_permission_probes.md, reports/skill_atlas.html, reports/registry_audit.md, reports/package_verification.md, reports/install_simulation.md, reports/upgrade_check.md, reports/adoption_drift_report.md, reports/review_waivers.md, reports/world_class_evidence_plan.md, reports/world_class_evidence_ledger.md, reports/review_annotations.md, reports/review-studio.html, reports/skill-overview.html交付结果：SKILL.md, agents/interface.yaml, reports/skill-ir.json, reports/compiled_targets.md, reports/output_quality_scorecard.md, reports/output_execution_runs.md, reports/output_blind_review_pack.md, reports/output_review_kit.md, reports/output_review_adjudication.md, reports/benchmark_reproducibility.md, reports/output_blind_answer_key.json, reports/conformance_matrix.md, reports/security_trust_report.md, reports/runtime_permission_probes.md, reports/skill_atlas.html, reports/registry_audit.md, reports/package_verification.md, reports/install_simulation.md, reports/upgrade_check.md, reports/adoption_drift_report.md, reports/review_waivers.md, reports/world_class_evidence_plan.md, reports/world_class_evidence_ledger.md, reports/review_annotations.md, reports/review-studio.html, reports/skill-overview.html
总览指标Metrics
分数来自本地文件和 reports 证据，缺失时明确标为证据不足。Scores are derived from package files and reports; missing inputs are shown as evidence gaps.
指标判读Reading
先看雷达图判断能力短板，再看下方每项分数的证据原因。分数不是装饰数字，必须和本地文件、reports 证据或证据不足提示对应。Read the radar first for weak spots, then inspect each score with its evidence. Scores must map to local files, reports, or explicit evidence gaps.
- 稳定Stable完整度100SKILL.md 已存在，是 Skill 的入口。SKILL.md 已存在，是 Skill 的入口。
- 稳定Stable触发清晰100frontmatter description 已存在，具备基础路由面。frontmatter description 已存在，具备基础路由面。
- 稳定Stable证据充分100已生成 20 / 20 类报告证据。已生成 20 / 20 类报告证据。
- 稳定Stable可维护性100SKILL.md 约 356 个词/字。SKILL.md 约 356 个词/字。
- 稳定Stable可迁移性100agents/interface.yaml 已存在。agents/interface.yaml 已存在。
- 关注Watch上下文成本42入口约 356 个词/字，references 约 15566 个词/字。入口约 356 个词/字，references 约 15566 个词/字。
完整度100
- SKILL.md 已存在，是 Skill 的入口。SKILL.md 已存在，是 Skill 的入口。
- README.md 已存在，便于人工阅读。README.md 已存在，便于人工阅读。
- agents/interface.yaml 已存在，便于跨平台适配。agents/interface.yaml 已存在，便于跨平台适配。
触发清晰100
- frontmatter description 已存在，具备基础路由面。frontmatter description 已存在，具备基础路由面。
- description 有足够长度说明任务边界。description 有足够长度说明任务边界。
- description 已包含使用场景或排除边界信号。description 已包含使用场景或排除边界信号。
证据充分100
- 已生成 20 / 20 类报告证据。已生成 20 / 20 类报告证据。
- skill-ir.json 已存在。skill-ir.json 已存在。
- compiled_targets.json 已存在。compiled_targets.json 已存在。
可维护性100
- SKILL.md 约 356 个词/字。SKILL.md 约 356 个词/字。
- 入口文件保持克制，可维护性较好。入口文件保持克制，可维护性较好。
- references/ 已承载扩展指导。references/ 已承载扩展指导。
可迁移性100
- agents/interface.yaml 已存在。agents/interface.yaml 已存在。
- manifest.json 已存在。manifest.json 已存在。
- 目标平台或 adapter target 已声明。目标平台或 adapter target 已声明。
上下文成本42
- 入口约 356 个词/字，references 约 15566 个词/字。入口约 356 个词/字，references 约 15566 个词/字。
- 分数越高代表上下文成本越低。分数越高代表上下文成本越低。
- 上下文成本偏高，建议压缩入口或拆分 references。上下文成本偏高，建议压缩入口或拆分 references。
能力画像Capability
判断这个 Skill 在能力地图中的位置和复用范围。Places this skill on a capability map and clarifies reuse scope.
画像摘要Profile
- 能力类型：Execution operation能力类型：Execution operation
- 成熟度：governed成熟度：governed
- 触发强度：手动触发 + description 路由触发强度：手动触发 + description 路由
- 复用范围：跨平台复用范围：跨平台
原理结构Principle
说明入口、参考、脚本、评估和报告如何组成一个稳定闭环。Explains how entrypoint, references, scripts, evals, and reports form a stable loop.
执行流程Execution Flow
- 判断请求是否应该沉淀为 Skill，并选择最轻量可靠的模式。Decide whether the request should become a skill and choose the lightest fit.
- 捕捉任务、输出、排除项、约束和质量标准。Capture job, output, exclusions, constraints, and standards.
- 运行参考扫描：先看外部 benchmark，再看用户材料，最后校验本地适配；只暴露不确定性或冲突。Run reference scan: external benchmarks first, user references second, local fit third; surface only uncertainty or conflict.
- 尽早写出 `description`，先测试路由质量，再扩展包体。Write the `description` early and test route quality before expanding the package.
- 只在确有价值时添加 output-risk、artifact-design、prompt-quality 和 system-model 报告。Add output-risk, artifact-design, prompt-quality, and system-model reports only when they matter.
调用方式How To Use
- 当你需要把工作流或笔记沉淀成结构精简、触发清晰且带必要 eval 的可复用 Skill 时使用 $yao-meta-skill。Use $yao-meta-skill to turn my workflow or notes into a reusable skill with lean structure, clear triggering, and the right evals.
- 当用户请求与该 Skill 的触发描述匹配时使用。Use this skill when the request matches: Create, refactor, evaluate, and package agent skills from workflows, prompts, transcripts, docs, or notes. Use when asked to create a skill, turn a repeated process into a reusable skill, improve an existing skill, add evals, or package a skill for team reuse.
契约边界Contract
把触发、输入、输出和排除场景放在同一屏。Keeps trigger, inputs, outputs, and exclusions on the same screen.
触发描述Trigger
该 Skill 的触发描述来自 SKILL.md frontmatter；默认中文报告先呈现能力边界，原始英文描述可切换到英文查看。Create, refactor, evaluate, and package agent skills from workflows, prompts, transcripts, docs, or notes. Use when asked to create a skill, turn a repeated process into a reusable skill, improve an existing skill, add evals, or package a skill for team reuse.
输入材料Inputs
- 原始说明可切换到英文查看；默认中文报告保留结论与结构说明。rough workflow notes, SOPs, runbooks, prompts, transcripts, documents, or repeated task descriptions
- 原始说明可切换到英文查看；默认中文报告保留结论与结构说明。an existing skill directory that needs refactor, evaluation, packaging, or governance hardening
- 原始说明可切换到英文查看；默认中文报告保留结论与结构说明。target platform requirements such as OpenAI, Claude, generic Agent Skills, or team distribution
- 原始说明可切换到英文查看；默认中文报告保留结论与结构说明。benchmark references, local constraints, desired maturity tier, and review standards
输出结果Outputs
- 原始说明可切换到英文查看；默认中文报告保留结论与结构说明。A working skill package with lean SKILL.md, aligned agents/interface.yaml, justified references, scripts only when useful, eval evidence, reports, packaging metadata, and clear next iteration recommendations.
- 结构化 Skill 目录，共 8 类关键资产。结构化 Skill 目录，共 8 类关键资产。
不应触发Should Not Trigger
- 只需要一次性回答、没有复用价值的临时请求。只需要一次性回答、没有复用价值的临时请求。
- 要求直接执行相邻任务，而不是沉淀或使用这个 Skill。要求直接执行相邻任务，而不是沉淀或使用这个 Skill。
- 缺少必要事实且用户不允许澄清的场景。缺少必要事实且用户不允许澄清的场景。
质量评估Quality
展示强项、缺口和建议，避免只给分不解释。Shows strengths, gaps, and recommendations instead of scores without explanation.
| 类型Type | 证据Evidence | 建议Action |
|---|---|---|
| 强项Strength | 触发面保持精简，并锚定在 frontmatter description。The trigger surface stays lean and anchored in the frontmatter description. | 保留并复用Keep |
| 强项Strength | 已生成 Skill IR，核心语义可先于平台打包被审查和迁移。已生成 Skill IR，核心语义可先于平台打包被审查和迁移。 | 保留并复用Keep |
| 强项Strength | 已生成目标编译报告，可审查 IR 到 OpenAI、Claude、generic 等目标契约的映射。已生成目标编译报告，可审查 IR 到 OpenAI、Claude、generic 等目标契约的映射。 | 保留并复用Keep |
| 缺口Gap | 上下文成本需要补强：入口约 356 个词/字，references 约 15566 个词/字。上下文成本需要补强：入口约 356 个词/字，references 约 15566 个词/字。 | 纳入下一轮修复Fix next |
执行证据Execution Evidence
- 变体运行：10变体运行：10
- 模型执行：0模型执行：0
- 记录样本：0记录样本：0
- Token 估算：10Token 估算：10
盲评审定Blind Adjudication
- 评审进度：0 / 5评审进度：0 / 5
- 待评审：5待评审：5
- 一致率：暂无一致率：暂无
- 非法决策：0非法决策：0
评审原则Review Rule
- 先记录 reviewer 对 A/B 的选择，再打开答案 key 计算一致率。Record the reviewer's A/B choice before opening the answer key and calculating agreement.
- 缺少真实 reviewer 决策时只显示待评审，不伪造人工结论。When real reviewer decisions are missing, show pending status instead of fabricating human conclusions.
运行原则Run Rule
- recorded fixture 只能证明可复现样本，不等同于模型执行。A recorded fixture proves reproducible samples only; it is not model execution.
- 只有 provider runner 返回 model metadata 时才计入 model-executed。Only provider runners that return model metadata count as model-executed.
风险治理Risk
提前暴露误触发、漂移、证据不足和迁移风险。Surfaces trigger, drift, evidence, and portability risks before the package grows.
| 风险Risk | 信号Signal | 应对Response |
|---|---|---|
| 误触发风险误触发风险 | frontmatter description 已存在，具备基础路由面。frontmatter description 已存在，具备基础路由面。 | 先补证据和边界，再增加包体复杂度。先补证据和边界，再增加包体复杂度。 |
| 输出漂移风险输出漂移风险 | 已生成 20 / 20 类报告证据。已生成 20 / 20 类报告证据。 | 先补证据和边界，再增加包体复杂度。先补证据和边界，再增加包体复杂度。 |
| 证据不足风险证据不足风险 | 已生成 20 / 20 类报告证据。已生成 20 / 20 类报告证据。 | 先补证据和边界，再增加包体复杂度。先补证据和边界，再增加包体复杂度。 |
| 包体膨胀风险包体膨胀风险 | SKILL.md 约 356 个词/字。SKILL.md 约 356 个词/字。 | 先补证据和边界，再增加包体复杂度。先补证据和边界，再增加包体复杂度。 |
| 跨平台迁移风险跨平台迁移风险 | agents/interface.yaml 已存在。agents/interface.yaml 已存在。 | 先补证据和边界，再增加包体复杂度。先补证据和边界，再增加包体复杂度。 |
包体资产Assets
让 reviewer 快速确认关键文件、目录和资产分布。Lets reviewers confirm key files, directories, and asset distribution quickly.
| 路径Path | 作用Role | 类型Type |
|---|---|---|
| SKILL.md | Skill 入口文件Skill entrypoint | 文件file |
| README.md | 人类可读使用说明Human-readable usage guide | 文件file |
| agents/interface.yaml | 跨平台接口元数据Neutral interface metadata | 文件file |
| manifest.json | 生命周期与打包元数据Lifecycle and portability metadata | 文件file |
| references | 扩展指导与复用资料Extended guidance and reusable notes | 目录folder |
| scripts | 确定性脚本或本地工具Deterministic helpers or local tooling | 目录folder |
| evals | 触发与质量检查Trigger and quality checks | 目录folder |
| reports | 生成的证据与总结报告Generated evidence and overview artifacts | 目录folder |
迭代路线Roadmap
把下一步升级收束为少数高价值动作。Keeps next iteration moves focused and actionable.
有选择地借鉴一个成熟模式Borrow one proven pattern on purpose
已经有公开 benchmark 对象，下一步应主动选择一个模式借鉴，而不是松散吸收所有做法。You already have public benchmark objects. The next gain is to choose one pattern intentionally instead of absorbing everything loosely.
- 阅读 `obra/superpowers` 中最值得借鉴的模式。Read the strongest pattern from obra/superpowers.
- 先判断要借鉴的是方法、结构、执行方式还是可迁移性，并且第一轮只借鉴其中一个。Decide whether to borrow method, structure, execution, or portability, but only one of them first.
- 记录本轮不借鉴的内容，避免包体过重。Record what you will not borrow so the package stays light.
包体形态更清晰，也减少偶然过度设计。A cleaner package shape with less accidental over-design.
加固跨环境语义Harden portability semantics
这个 Skill 已经面向跨环境复用，因此早期就需要把契约语义说清楚。The skill already signals reuse across environments, so contract clarity matters early.
- 确认激活模式、执行上下文和信任假设。Confirm activation mode, execution context, and trust assumptions.
- 补充或复核非原生目标端的降级策略。Add or review degradation strategy for non-native targets.
- 至少打包一次 Skill，用来验证 adapter 预期。Package the skill once to verify adapter expectations.
跨环境复用更安全，目标漂移更少。Safer cross-environment reuse with less target drift.
建立迭代证据回路Create an iteration evidence loop
第一版之后，包体应该能说明改了什么以及为什么改。The package should show what changed and why after the first draft.
- 生成 HTML Skill 报告，并保持它与包体内容一致。Generate the HTML skill report and keep it aligned with the package.
- 记录参考扫描的取舍和非目标。Record reference scan choices and non-goals.
- 在继续增加文件前，明确记录下一轮迭代选择。Capture the next iteration choice explicitly before adding more files.
让下一位作者或评审者更容易接手。A clearer path for the next author or reviewer.