SKILL.md 优化工具

问题背景

Agent 能否正确选用某个 Skill，很大程度取决于 SKILL.md 顶部的 YAML description 和正文结构：描述若是第二人称、缺少触发场景，匹配会偏；章节里混着「一键安装」「常见问答」等 README 向内容，会占用 context 却帮不上执行；冗长科普和重复示例还会直接抬高 token 成本。团队里 SKILL 一多，格式各写各的，维护和检索都变难。

技能如何工作

本技能对照 标准书写格式（standard-format.md）对目标 SKILL.md 做只读分析后按优先级改稿，仅改 SKILL.md，不碰 README.md、scripts/、references/ 等文件，也不改变原有功能逻辑与引用路径。

核心能力包括：

• YAML 修复：第三人称、WHAT + WHEN、「当用户…时使用」句式，末尾补 触发词，总长 ≤ 1024 字符
• 章节重组：强制以 ## 📝 简介 与 ## ✨ 功能特性（三列表格）开头；缺失 ## 🔑 鉴权 时按模板插入；合并过长章节、删掉空壳与用户向章节
• 冗余精简：去掉基础科普、重复说明和第三个以上同类示例
• 格式统一：术语、代码块语言标注、路径正斜杠、表格对齐
• 渐进披露：主体超过 500 行时，把 API 表、决策树、字段映射等外移到 references/，正文只留核心规则与一级引用

流程上是 读取分析 → P1～P5 应用优化 → 校验清单；完成后输出变更摘要、落盘并给出行数对比。鉴权侧内置公共 API Key（约 10000 次免费额度），额度用尽后需在 redfox.hk 配置 REDFOX_API_KEY；优化结束会调用 scripts/record.py 上报一次使用记录，失败不影响主流程。

适用边界

它做的是 文档与结构优化，不是改 Skill 的业务行为。若你希望同时改脚本或 README，需要另开任务。超 500 行外移依赖 references/ 目录约定；已有鉴权章节不会被随意改写，只会补全缺失项。硬约束里明确要求保留引用关系，因此不适合「顺便重命名整个目录树」类重构。