用途：优化已有的面向 AI 的文档（CLAUDE.md、AGENTS.md、SKILL.md、智能体定义、references 参考文件），提升 Claude 的理解效果与 token 经济性。调用方式为 /optimize-claude-md <path>，路径可以是单个文件、技能目录或插件目录。
主要能力：分阶段编排优化流程。先校验目标路径并判定范围与文件类型；再测量基线，包括用 uvx skilllint@latest check --tokens-only <file> 统计 token 数，SKILL.md 另做 8 类完整性评分（X/24），CLAUDE.md/AGENTS.md 另做 6 项索引纪律审计（条目长度≤约150字符、条目无编号步骤、钩子直接陈述规则、无内联流程、无失效路由、无缺失路由）。随后委派 plugin-creator:ai-doc-optimizer 执行优化，再由独立 agent 做回归验证（PASS/REGRESSION），最后测量输出并生成含前后对比与建议的报告，经用户确认后才写回原文件。
使用方式：按提示传入目标路径；若为空会先询问。大文件或插件目录可启用迭代模式，分结构、内容、润色三轮，直到完整性分数或 token 缩减收敛。
适用场景：整理 AI 面向文档、拆分索引与 docs/ 路由、抽取路径作用域规则到 .claude/rules/、压缩冗长说明。
限制：语义优化依赖 Skill Lapidary，若不可用则阻塞语义优化；不自动应用改动；非 markdown 或二进制文件跳过；具体收费、平台支持等资料暂未提供。