技能增强与发布就绪

要解决什么问题

很多 Agent 技能只有一份 loosely 的 SKILL.md 草稿：结构勉强合法，但何时该触发、执行时要交付什么、缺哪些配套文件往往说不清。结果是别的模型要么误触发、要么执行时只给建议而不产出可复用包，发布前也缺少可对照的评测与清单。

本技能面向「技能质量」本身，而不是泛泛改文案或无关重构。它强调在可触发、可执行、可测试、可发布之间闭环，默认比轻量脚手架更重，适合别人会依赖的技能包。

核心工作方式

流程以 SKILL.md 为单一事实来源，README.md 只保留人类可读摘要，references/workflows.md 扩展说明而不与之抢定义。典型路径分六段：

1. 识别模式：在新建、增强、本地改包、触发优化、补齐产物、质量审查、发布就绪审查之间选主模式（本地改包与发布审查优先级更高）。
2. 本地可编辑性：若动本机已安装技能，先确认路径、读写能力与是否仅分析还是真改文件。
3. 锁定契约：目的、正/负触发样例、输出结构、必需产物与验证预期。
4. 构建或修订产物：按默认布局维护 SKILL.md、README.md、agents/openai.yaml、evals/evals.json、references/ 等。
5. 审查门禁：触发边界、输出契约、执行可靠性、产物完整性、发布就绪；本地修改还需修改安全。
6. 汇报状态：说明改了什么、还差什么，并标注 draft / internally usable / release-candidate / publish-ready。

质量维度被当作一等公民：触发质量、执行清晰度、输出契约、产物完整性、验证覆盖、发布就绪、本地编辑安全。

适用边界

• 适合：从零写技能、增强已有包、改本地技能、优化触发准确率、补强 README/evals/metadata、做发布前审查。
• 不适合作为主路径：与技能无关的普通 prose 编辑、无关代码重构、单纯发现/安装技能、只涉及平台发布步骤且不改技能包本身。
• 混合需求时，只处理其中与技能质量相关的切片；目标不是「这里有个草稿」，而是别的 LLM 能稳定用好的依赖级技能包或明确的增强计划。