SKILL.md 优化工具

解决的问题

很多 SKILL.md 更像项目说明而不是 Agent 可执行指令：YAML description 缺少 WHAT、WHEN 和触发词，章节混杂安装、问答、科普，术语和路径不一致，文件过长导致关键规则被稀释。尤其当文件超过 500 行时，关键规则更容易被埋没。这类问题会让模型匹配不稳、阅读成本变高，也影响后续维护。

如何工作

该技能围绕标准书写格式做约束优化：

• YAML 修复：改成第三人称，补齐 WHAT + WHEN，末尾追加触发词，并控制在 1024 字符内。
• 结构重组：强制以简介和功能特性开头，补齐鉴权章节，删除空壳与用户向内容。
• 精简冗余：删除重复说明、基础科普和过多示例，优先保留 Agent 执行所需的核心规则。
• 格式统一：统一术语、代码块语言、正斜杠路径和表格风格，必要时把超长内容外移到 references/。

适用边界

它只改 SKILL.md，不修改 README.md、脚本或引用文件；目标是优化表达与结构，不改变技能原有行为。若项目缺少鉴权信息或引用路径，技能不会凭空补齐，需要在优化后人工确认。