Skill 优化器

要解决的问题

已有 SKILL.md 经常把能力描述、触发条件、流程说明和平台假设混在一起，导致 Agent 误触发、正文过长、资源引用悬空、SOP 只覆盖 happy path，遇到外部依赖失败时缺少降级和回滚约束。

技能如何工作

诊断模式默认不改写目标 Skill，而是输出优化报告与行动清单：

• 校验 YAML frontmatter、name、description、目录结构和多余文件；
• 评估 description 是否说明做什么、何时用、关键词覆盖和负面边界；
• 检查正文是否使用祈使句、是否超过 500 行、详细材料是否拆到 references/；
• 对依赖外部 MCP 或服务的 SOP，用 5D 框架核查依赖声明、降级路径、失败隔离、状态沉淀和文档分层。

元升级模式在用户确认目标、策略和改动范围后才执行，调用 governance_guard.py 做写前裁决，用 skill_interface.py 做快照和确定性替换，再用 coupling_analyzer.py 复验资源契约；遇到 HookDenied、ValidationError 等异常会记录并回滚。它也可按策略为目标 Skill 注入 history.md 与 memory.md 脚手架，但不自动改写目标逻辑。

适用边界

适合审查和治理 Agent Skill，尤其是触发质量、跨平台兼容、资源目录和 SOP 健壮性问题；不适合替代产品决策，也不能绕过 name 变更、删除文件、跨 skill 写入等治理硬阻断。