Agent Md Refactor 说明文档

# 智能体 MD 重构 一种 Claude Code 技能，利用渐进式披露原则将臃肿的智能体指令文件转换为整洁、有组织的文档。 基于 https://x.com/mattpocockuk/status/2012906065856270504 (Matt Pocock 的提示词构思) ## 目的 随着时间的推移，像 `CLAUDE.md`、`AGENTS.md` 或 `COPILOT.md` 这样的智能体指令文件往往会变成包含数百行混合指令的笨重文档。这会产生几个问题： - **上下文浪费**：每个任务都会加载整个文件，即使大多数指令是不相关的 - **维护负担**：查找和更新特定指令变得困难 - **矛盾**：相互冲突的准则在未被注意的情况下积累 - **信噪比**：重要的规则被掩埋在明显或模糊的陈述中 此技能通过应用**渐进式披露**解决了这些问题 - 将基本的、通用的指令保留在根文件中，同时将其他所有内容组织成重点突出、相互链接的文档文件。 ## 何时使用 当你需要清理智能体指令文件时使用此技能。常见的触发短语包括： - "重构我的 AGENTS.md" / "重构我的 CLAUDE.md" - "拆分我的智能体指令" - "整理我的 CLAUDE.md 文件" - "我的 AGENTS.md 太长了" - "为我的指令应用渐进式披露" - "清理我的智能体配置" **重构的良好候选对象：** - 超过 50-100 行的根智能体文件 - 混合了多个不相关主题（测试、代码风格、架构等）的文件 - 没有结构、有机增长的文档 - 包含矛盾或冗余指令的文件 ## 工作原理 该技能遵循系统的 5 阶段流程： ### 阶段 1：查找矛盾 在重构之前，该技能会识别需要解决的冲突指令。示例包括矛盾的风格指南（“使用分号”与“不使用分号”）或不兼容的工作流指令。每个矛盾都会以一个问题呈现给用户以供解决。 ### 阶段 2：识别要点 仅提取真正属于根文件的内容 - 适用于每个任务的信息： | 保留在根目录 | 移出 | |-------------|----------| | 一句话项目描述 | 特定语言约定 | | 非标准包管理器 | 测试指南 | | 自定义构建/测试命令 | 代码风格细节 | | 关键覆盖项 | 框架模式 | | 通用规则（100% 任务适用） | 文档