技能重构助手

问题从哪来

Hermes-Agent 规范里，同行 SKILL.md 通常落在 8–15k 字符：frontmatter 完整、description 以 “Use when …” 开头，长表格和大段实现应放到 references/ 或 scripts/。实战里技能会自然变胖——内联 CSS、复制即用的代码块、跨章重复的决策树——SKILL.md 很容易涨到 20k–50k，CI 与 diff 审查都会变痛苦。

技能怎么做

本技能是一套 7 步重构工作流，不是从零写 skill（那应走 hermes-agent-skill-authoring）：

1. 调查：通读现有文档，标出章节体量、可外迁代码块、重复表格与决策树。
2. 对齐规范：加载 authoring 约束（YAML 边界、name/description 长度、必需章节结构）。
3. 规划拆分：挑出 3–5 个独立主题，按「连贯主题 + 至少 2–3k 字符 + 可在主文档按名引用」移入 references/*.md；超长实现进 scripts/。
4. 重写主文档：目标 8–15k，保留概述、何时使用、常见陷阱、验证清单与参考资料表。
5. 写引用文件：每个 2–9k，主文档概括、引用详述，避免双份粘贴。
6. 验证：用随附的 validate_skill.py（纯 stdlib）检查 frontmatter、章节、15k 上限与引用文件是否存在。

结构重组对依赖文件大小的使用者是破坏性变更，通常应 升主版本（如 2.0.0），并在更新日志写明「行为无变化」若逻辑未改。

适用边界

• 适合：用户要求「按规范整理 / 标准化 / 提炼成标准 skill」；主文件难浏览、一改就动整篇巨文。
• 不要用于：新建技能；已在 8–15k 且已分解的合规技能；有意保持密集引用的安全/合规类文档。