agent-md-refactor

用途：重构过度膨胀的智能体指令文件（AGENTS.md、CLAUDE.md、COPILOT.md 等），使其遵循“渐进式披露”原则——根文件只保留每个任务都适用的必要信息，其余按主题拆分到被链接的分类文件中。触发场景包括：AGENTS.md 太长、想拆分或整理指令、清理智能体配置等。

主要能力（五个阶段）：

1. 分析：找出指令之间的矛盾（如风格冲突、互斥工作流或工具偏好），逐条列出并交由用户裁决优先级。
2. 提取：只保留根文件应有的内容，如一句话项目描述、非默认包管理器、自定义构建/测试/类型检查命令、必须覆盖默认值的关键规则、适用于全部任务的通用规则。
3. 归类：把其余指令按主题分组，常见类别有 typescript.md、testing.md、code-style.md、git-workflow.md、architecture.md、api-design.md、security.md、performance.md；建议控制在 3–8 个文件。
4. 结构化：生成根文件加 .claude/（或 docs/agent-instructions/）链接文件的结构，根文件包含速查命令与指向各详细文件的链接，各链接文件自带概览、可执行规则与正反示例。
5. 精简：标记应删除的指令，如冗余（项目中已用 TS）、过于笼统（“写干净代码”）、显而易见、属于默认行为或已过时的内容。

使用方式：按技能触发语调用（如“refactor my CLAUDE.md”），随后按阶段执行；结束时用清单核对——矛盾已解决、根文件仅含必要信息、指令已归类、结构与链接正确、冗余内容已删，并确认各链接文件独立自洽、根文件少于 50 行、链接均有效。资料中的示例显示重构后根文件形如：

CLAUDE.md

React dashboard for real-time analytics visualization.

Commands

• pnpm dev - Start development server
• pnpm test - Run tests with coverage
• pnpm build - Production build

Guidelines

• Code Style
• Testing
• TypeScript

适用场景：维护多主题、篇幅较大的智能体配置仓库，希望降低上下文占用、便于长期维护的团队或个人。

限制与注意：资料未提供具体安装命令、运行环境要求、收费方式、平台支持或与其他工具的集成说明，这些信息暂未提供；执行矛盾裁决时需人工确认，删除标记需用户复核以免丢失有效指令。