YAO Skill 生成审计报告YAO Skill Generation Audit
geo-content-brief-skill
技能审计报告Geo Content Brief Skill Audit Report
这份报告默认使用中文简体，把新 Skill 的定位、指标、原理、契约、质量、风险、资产和迭代路线整理为一份可审计的 HTML 报告。Skill-specific source text is authored in Chinese; switch to Simplified Chinese for the exact wording.
openaiopenaiclaudeclaudegenericgenericvscodevscode
技能概述Overview
先用一屏说明这个 Skill 是什么、给谁用、交付什么。A first-screen explanation of what this skill is, who it serves, and what it delivers.
作用定位Role
- 将 GEO 内容访谈、关键词笔记、竞品线索和渠道约束整理成可执行的中文内容简报。用于团队复用、选题规划、内容生产交接和质量评审；不用于直接代写完整长文或替代品牌策略判断。Skill-specific source text is authored in Chinese; switch to Simplified Chinese for the exact wording.
- 把一次性经验沉淀为可复用、可评估、可迁移的 Skill 包体。Turn one-off experience into a reusable, evaluable, and portable skill package.
- 交付结果：SKILL.md, agents/interface.yaml, reports/skill-ir.json, reports/compiled_targets.md, reports/output_quality_scorecard.md, reports/conformance_matrix.md, reports/security_trust_report.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/review_annotations.md, reports/review-studio.html, reports/skill-interpretation.html, reports/skill-overview.htmlDeliverables: SKILL.md, agents/interface.yaml, reports/skill-ir.json, reports/compiled_targets.md, reports/output_quality_scorecard.md, reports/conformance_matrix.md, reports/security_trust_report.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/review_annotations.md, reports/review-studio.html, reports/skill-interpretation.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.
成熟度条Maturity Bar
- 稳定Stable完整度Completeness92SKILL.md 已存在，是 Skill 的入口。SKILL.md exists and acts as the skill entrypoint.
- 稳定Stable触发清晰Trigger clarity100frontmatter description 已存在，具备基础路由面。The frontmatter description exists, giving the skill a basic routing surface.
- 关注Watch证据充分Evidence depth60已生成 12 / 20 类报告证据。Generated 12 / 20 evidence report types.
- 稳定Stable可维护性Maintainability85SKILL.md 约 864 个词/字。SKILL.md is about 864 words/characters.
- 稳定Stable可迁移性Portability100agents/interface.yaml 已存在。agents/interface.yaml exists.
- 可用Usable上下文成本Context cost78入口约 864 个词/字，references 约 565 个词/字。Entrypoint is about 864 words/characters; references are about 565.
完整度Completeness92
- SKILL.md 已存在，是 Skill 的入口。SKILL.md exists and acts as the skill entrypoint.
- README.md 已存在，便于人工阅读。README.md exists for human-readable usage.
- agents/interface.yaml 已存在，便于跨平台适配。agents/interface.yaml exists for cross-platform adaptation.
触发清晰Trigger clarity100
- frontmatter description 已存在，具备基础路由面。The frontmatter description exists, giving the skill a basic routing surface.
- description 有足够长度说明任务边界。The description is long enough to explain the task boundary.
- description 已包含使用场景或排除边界信号。The description includes usage-scenario or exclusion-boundary signals.
证据充分Evidence depth60
- 已生成 12 / 20 类报告证据。Generated 12 / 20 evidence report types.
- skill-ir.json 已存在。skill-ir.json exists.
- compiled_targets.json 已存在。compiled_targets.json exists.
可维护性Maintainability85
- SKILL.md 约 864 个词/字。SKILL.md is about 864 words/characters.
- 入口文件保持克制，可维护性较好。The entrypoint stays restrained, which supports maintainability.
- references/ 已承载扩展指导。references/ carries extended guidance.
可迁移性Portability100
- agents/interface.yaml 已存在。agents/interface.yaml exists.
- manifest.json 已存在。manifest.json exists.
- 目标平台或 adapter target 已声明。Target platforms or adapter targets are declared.
上下文成本Context cost78
- 入口约 864 个词/字，references 约 565 个词/字。Entrypoint is about 864 words/characters; references are about 565.
- 分数越高代表上下文成本越低。A higher score means lower context cost.
- 上下文成本处于可控区间。Context cost is within a controlled range.
能力画像Capability
判断这个 Skill 在能力地图中的位置和复用范围。Places this skill on a capability map and clarifies reuse scope.
画像摘要Profile
- 能力类型：Creative generationCapability type: Creative generation
- 成熟度：productionMaturity: production
- 触发强度：手动触发 + description 路由Trigger strength: Manual activation plus description-based routing
- 复用范围：跨平台Reuse scope: Cross-platform
原理结构Principle
说明入口、参考、脚本、评估和报告如何组成一个稳定闭环。Explains how entrypoint, references, scripts, evals, and reports form a stable loop.
执行流程Execution Flow
- 读取用户输入，识别目标受众、内容渠道、关键词、品牌边界、禁止表达和必须覆盖的信息。Skill-specific source text is authored in Chinese; switch to Simplified Chinese for the exact wording.
- 对照 `references/brief-structure.md` 生成简报骨架：目标、洞察、角度、关键词、结构、证据、风险和验收标准。Skill-specific source text is authored in Chinese; switch to Simplified Chinese for the exact wording.
- 如果缺少核心输入，先提出最多三个澄清问题，不用假设补全用户没有提供的事实。Skill-specific source text is authored in Chinese; switch to Simplified Chinese for the exact wording.
- 用 `evals/trigger_cases.jsonl` 检查当前请求是否属于 GEO 内容简报场景。Skill-specific source text is authored in Chinese; switch to Simplified Chinese for the exact wording.
- 用 `evals/output_cases.jsonl` 检查输出是否包含输入摘要、内容结构、证据要求、禁区和下一步动作。Skill-specific source text is authored in Chinese; switch to Simplified Chinese for the exact wording.
调用方式How To Use
- 当你需要把访谈纪要、关键词、竞品线索和渠道限制整理成中文 GEO 内容简报时，使用 $geo-content-brief-skill。Skill-specific source text is authored in Chinese; switch to Simplified Chinese for the exact wording.
- Use this skill when the request matches: 将 GEO 内容访谈、关键词笔记、竞品线索和渠道约束整理成可执行的中文内容简报。用于团队复用、选题规划、内容生产交接和质量评审；不用于直接代写完整长文或替代品牌策略判断。Use this skill when the request matches the frontmatter description.
契约边界Contract
把触发、输入、输出和排除场景放在同一屏。Keeps trigger, inputs, outputs, and exclusions on the same screen.
触发描述Trigger
将 GEO 内容访谈、关键词笔记、竞品线索和渠道约束整理成可执行的中文内容简报。用于团队复用、选题规划、内容生产交接和质量评审；不用于直接代写完整长文或替代品牌策略判断。Skill-specific source text is authored in Chinese; switch to Simplified Chinese for the exact wording.
输入材料Inputs
- 用户提供的工作流、提示词、文档、记录或散乱笔记User-provided workflows, prompts, documents, records, or rough notes.
- 期望沉淀的复用场景、排除项、约束和质量标准The reusable scenario, exclusions, constraints, and quality standards to capture.
输出结果Outputs
- 可路由的 SKILL.mdA routeable SKILL.md.
- agents/interface.yaml 元数据agents/interface.yaml metadata.
- 必要的 references、scripts、evals、reports 证据Necessary references, scripts, evals, and reports evidence.
- 结构化 Skill 目录，共 8 类关键资产。Structured skill directory with 8 key asset groups.
不应触发Should Not Trigger
- 只需要一次性回答、没有复用价值的临时请求。One-off requests that do not need reusable skill behavior.
- 要求直接执行相邻任务，而不是沉淀或使用这个 Skill。Requests to perform an adjacent task directly rather than create or use this skill.
- 缺少必要事实且用户不允许澄清的场景。Cases that lack required facts and do not allow clarification.
质量评估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 is generated so core semantics can be reviewed and migrated before platform packaging. | 保留并复用Keep |
| 强项Strength | 已生成目标编译报告，可审查 IR 到 OpenAI、Claude、generic 等目标契约的映射。Target compilation evidence is generated to review how IR maps to OpenAI, Claude, generic, and other target contracts. | 保留并复用Keep |
| 缺口Gap | 证据充分需要补强：已生成 12 / 20 类报告证据。Evidence depth needs improvement: Generated 12 / 20 evidence report types. | 纳入下一轮修复Fix next |
执行证据Execution Evidence
- 尚未生成输出执行证据报告。The output execution evidence report has not been generated yet.
盲评审定Blind Adjudication
- 尚未生成盲评审定报告。The blind review adjudication report has not been generated yet.
评审原则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 |
|---|---|---|
| 误触发风险Trigger risk | frontmatter description 已存在，具备基础路由面。The frontmatter description exists, giving the skill a basic routing surface. | 先补证据和边界，再增加包体复杂度。Improve evidence and boundaries before adding package complexity. |
| 输出漂移风险Output drift risk | 已生成 12 / 20 类报告证据。Generated 12 / 20 evidence report types. | 先补证据和边界，再增加包体复杂度。Improve evidence and boundaries before adding package complexity. |
| 证据不足风险Evidence gap risk | 已生成 12 / 20 类报告证据。Generated 12 / 20 evidence report types. | 先补证据和边界，再增加包体复杂度。Improve evidence and boundaries before adding package complexity. |
| 包体膨胀风险Package bloat risk | SKILL.md 约 864 个词/字。SKILL.md is about 864 words/characters. | 先补证据和边界，再增加包体复杂度。Improve evidence and boundaries before adding package complexity. |
| 跨平台迁移风险Portability risk | agents/interface.yaml 已存在。agents/interface.yaml exists. | 先补证据和边界，再增加包体复杂度。Improve evidence and boundaries before adding package complexity. |
世界证据World Evidence
未生成 world-class ledger；当前报告不会宣称世界级完成。No world-class ledger was generated; this report does not claim world-class completion.
尚未生成 world-class ledger；这里只保留反过度承诺提示。No world-class ledger has been generated; this panel keeps the anti-overclaim guard visible.
包体资产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.
收紧触发与排除边界Tighten trigger and exclusions
在继续扩展前，需要先把相邻但不应触发的场景说清楚。The package needs clearer near-neighbor exclusions before it grows.
- 增加 3 到 5 个应触发和不应触发的例子。Add 3 to 5 should-trigger and should-not-trigger examples.
- 精炼 frontmatter description，明确重复任务和非目标。Refine the frontmatter description to name the recurring job and non-goals.
- 扩展包体前先跑一轮触发评估。Run a first trigger evaluation pass before expanding the package.
路由更清晰，误触发更少。Cleaner routing and fewer accidental activations.
补上第一个执行资产Add the first execution asset
当前包体仍偏文本说明，应先增加一个能减少重复人工操作的资产。The package is still mostly prose. Add one asset that removes repeated manual work.
- 如果用户会反复使用某段流程说明，把它沉淀到 references。Move stable procedural guidance into references if users will need it repeatedly.
- 如果某个重复步骤可以执行而不是描述，就沉淀成一个确定性 helper script。Create one deterministic helper script if a repeated step can be executed instead of described.
- 保持主 SKILL.md 简洁，并围绕路由与入口组织。Keep the main SKILL.md compact and route-oriented.
在不膨胀入口文件的前提下提升执行质量。Stronger execution quality without bloating the entrypoint.
从脚手架推进到生产可用Promote from scaffold to production-ready
第一版已经存在，下一步收益通常来自补上最小但有效的质量门禁。The first version exists; the next gain usually comes from adding the smallest useful gates.
- 判断这个 Skill 是个人使用、团队复用，还是库级基础能力。Decide whether this skill is personal, team-reused, or library-grade.
- 只添加与风险等级匹配的质量门禁。Add only the gates that match that risk level.
- 一旦进入真实复用，就记录生命周期元数据和评审节奏。Record lifecycle metadata and review cadence once reuse becomes real.
更清晰地从探索性包体走向可维护资产。A clearer path from exploratory package to maintained asset.