agent-md-refactor

# 智能体 MD 重构 重构臃肿的智能体指令文件（AGENTS.md, CLAUDE.md, COPILOT.md 等），使其遵循**渐进式披露原则** - 将要点保留在根目录，并将其余内容组织成链接的、分类的文件。 --- ## 触发器 在以下情况使用此技能： - "重构我的 AGENTS.md" / "重构我的 CLAUDE.md" - "拆分我的智能体指令" - "整理我的 CLAUDE.md 文件" - "我的 AGENTS.md 太长了" - "为我的指令应用渐进式披露" - "清理我的智能体配置" --- ## 快速参考 | 阶段 | 操作 | 输出 | |-------|--------|--------| | 1. 分析 | 查找矛盾 | 待解决的冲突列表 | | 2. 提取 | 识别要点 | 根文件的核心指令 | | 3. 分类 | 对剩余指令分组 | 逻辑分类 | | 4. 结构 | 创建文件层级 | 根文件 + 链接文件 | | 5. 修剪 | 标记删除 | 冗余/模糊的指令 | --- ## 流程 ### 阶段 1：查找矛盾 识别任何相互冲突的指令。 **寻找：** - 矛盾的风格指南（例如，“使用分号”与“不使用分号”） - 冲突的工作流指令 - 不兼容的工具偏好 - 互斥的模式 **对于发现的每个矛盾：** markdown ## 发现矛盾 **指令 A：** [引用] **指令 B：** [引用] **问题：** 哪一个应该优先，或者两者都应该是条件性的？ 在继续之前，请用户解决。 --- ### 阶段 2：识别要点 仅提取属于根智能体文件的内容。根文件应该是最小化的 - 适用于**每一个任务**的信息。 **基本内容（保留在根目录）：** | 分类 | 示例 | |----------|---------| | 项目描述 | 一句话：“一个用于分析的 React 仪表板” | | 包管理器 | 仅当不是 npm 时（例如，“使用 pnpm”） | | 非标准命令 | 自定义构建/测试/类型检查命令 | | 关键覆盖项 | 必须覆盖默认设置的内容 | | 通用规则 | 适用于 100% 的任务 | **非必要内容（移至链接文件）：** - 特定语言约定 - 测试指南 - 代码风格细节 - 框架模式 - 文档标准 - Git 工作流细节 --- ### 阶段 3：对剩余内容分组 将剩余指令组织成逻辑分类。 **常见分类：** | 分类 | 内容 | |----------|----------| | `typescript.md` | TS 约定、类型模式、严格模式规则 | | `testing.md` | 测试框架、覆盖率、模拟 p