还在忍受几百行的 AGENTS.md？这个 Skill 把臃肿指令文件拆成「极简根文件 + 链接子文件」

你的 AGENTS.md 是不是已经胖到读不动了？

做过 Agent 配置的朋友都知道，`AGENTS.md`、`CLAUDE.md` 这类文件有个宿命——越写越长，最后变成一坨谁都不想打开的屎山。

每次新建项目顺手加几句规则，长期积累下来就是几百行。Agent 读 context 的时候 token 爆炸，你让它干正事它先卡在读文档上。

今天推荐一个专门治这个毛病的 Skill——agent-md-refactor。

它能做什么？

一句话：把臃肿的 Agent 指令文件拆成「根文件 + 链接子文件」的结构，让 Agent 只读该读的，保持轻量。

核心逻辑是渐进式披露（Progressive Disclosure）——根文件只留最核心的几条通用指令，具体的规则按类别分散到独立文件里，用链接串联。Agent 需要的时候再读，不需要的时候完全不打扰。

怎么判断哪些该删？

这个 Skill 自带一套删除标准，非常实用：

• 冗余型——”使用 TypeScript”（项目本身就是 TS，Agent 知道）
• 空泛型——”写干净的代码”（无法执行，没有意义）
• 默认型——”不要引入 bug”（Agent 本来就知道）
• 过期型——引用了已废弃的 API

这四条基本覆盖了 90% 的”屎山”来源。

执行流程很清晰

Skill 内置了一个 7 步执行清单：

1. 识别所有矛盾和重复指令
2. 根文件只保留最核心内容（目标 <50 行）
3. 剩余指令按类别分组
4. 创建链接式文件结构
5. 删除冗余/空泛指令
6. 验证所有链接有效
7. 确认覆盖完整，无重要内容丢失

每一步都有明确的验收标准，不是那种”差不多得了”的重构。

典型使用场景

当你对 Agent 说：

• “refactor my AGENTS.md”
• “split my CLAUDE.md”
• “my agents.md is too long”

Skill 就会自动介入，帮你梳理、拆解、重组。

安装超简单

一行命令搞定：

npx skills add https://github.com/davila7/claude-code-templates --skill agent-md-refactor

支持 Cursor、Claude Code、Cline、Windsurf 等主流 Agent。

GitHub：https://github.com/davila7/claude-code-templates

如果你手里有一堆越积越厚的 Agent 配置文件，这个 Skill 值得立刻用起来——重构一次，后续每次对话都轻快一点。

GitHub: https://github.com/davila7/claude-code-templates