skill-enhance — 技能提升

技能增强 使用此技能来产生高质量的技能，这些技能不仅结构有效，还清晰、可触发、可执行、可测试和可发布。此技能故意比轻量级技能脚手架更重。 当用户创建或增强其他代理或用户依赖的技能时，优先考虑质量而不是速度。 触发边界 在以下情况下使用此技能： 创建新技能 增强现有技能 提高技能触发准确性 加强技能的输出合同 添加或完善README、evals、参考资料、元数据或发布说明 检查技能是否可靠地指导LLM 检查技能是否准备好发布 不要将此技能用作以下的主要路径： 与技能无关的普通文本编辑 与技能无关的一般代码重构 简单的技能发现或安装 不影响技能包本身的平台特定发布步骤 如果请求是混合的，只使用此技能来处理技能质量部分。 核心原则 不要止步于“这是一个草稿”。目标是交付技能包或具体的增强计划，以弥合以下差距： 一个松散定义的技能想法和一个可靠的技能 另一个LLM可以实际使用的技能 将以下内容视为一流的质量维度： 触发质量 执行清晰度 输出合同质量 工件完整性 验证覆盖范围 发布就绪性 任务模式 将请求分类为一个主要模式： 新技能创建 现有技能增强 触发优化 工件完成 质量审查 发布就绪性审查 如果存在多种模式，使用以下顺序： 总结当前状态和目标 确定质量差距 决定技能必须做什么以及何时触发 定义或重写输出合同 产生或修订包工件 运行审查门 声明技能是否发布就绪 工作流

• 捕获真实目标

在编写任何内容之前，确定： 用户是否正在创建新技能或增强现有技能 技能是为谁的 哪些用户请求应该触发它 技能在触发时必须产生什么 目标是项目本地、可共享还是发布就绪 如果已经存在现有技能，请先阅读并提取： 当前能力 当前触发词语 捆绑工件 差距或不一致性

• 定义技能合同

在编写SKILL.md之前，请确保合同清晰。至少定义： 技能的目的 正面触发案例 负面触发案例 预期输出结构 所需工件 验证期望 使用references/trigger-design.md和references/output-contracts.md。

• 构建或修订包

默认情况下，强大的技能包应包括： SKILL.md README.md agents/openai.yaml evals/evals.json 相关参考资料 使用references/artifact-matrix.md来决定哪些工件是必需的，哪些是可选的。 不要假设一个有效的SKILL.md就足以构成一个发布质量的技能。

• 加强触发质量

审查触发描述以检查： 欠触发 过触发 模糊的措辞 缺少常见的请求模式 缺少排除项 如果需要，重写描述以使技能更有可能在有用时触发，但不太可能劫持无关任务。

• 加强执行可靠性

检查技能指令是否实际可行。特别审查： 工作流是否清晰 决策点是否明确 输出是否明确定义 技能是否要求实际的可交付成果，而不是抽象的建议 参考资料是否可发现且正确范围 使用references/review-checklist.md。

• 添加验证覆盖范围

创建现实的eval提示，用于技能预计产生可重复、可审查的输出。 使用evals/evals.json来覆盖： 核心happy-path创建或增强 触发边界案例 工件完成案例 发布就绪性案例 至少一个非触发或超出范围的案例 如果技能是主观的，evals仍然可以定义预期的输出质量，而不是严格的断言。

• 审查发布就绪性

使用references/publish-readiness.md和references/skill-packaging.md。 在宣布工作完成之前，检查： 技能名称是否在公共场合有意义 描述是否有助于发现 人类面向的文档是否与代理面向的指令分开 捆绑工件是否足够 技能是否可以在没有额外隐藏上下文的情况下理解 是否有足够的验证材料用于发布审查 明确声明技能是否为： 草稿 内部可用 发布候选 发布就绪 输出合同 默认使用以下结构，除非用户请求其他格式：

• 任务模式

声明这是新创建、增强、触发优化、工件完成、质量审查还是发布就绪性审查。

• 当前状态摘要

描述...