Claude Code agent-md-refactor 技能:拆分过长的项目指令文件
EnglishClaude Code 安装步骤
- 从固定版本 GitHub 工作副本获取完整的 `cli-tool/components/skills/development/agent-md-refactor` 目录。
- 将目录放入目标项目的 `.claude/skills/`,确认 `.claude/skills/agent-md-refactor/SKILL.md` 存在,再从项目根目录启动 Claude Code 并输入 `/agent-md-refactor`。
中文摘要
把臃肿的 `CLAUDE.md` 或 `AGENTS.md` 按主题整理成精简入口和可追溯的详细规则。适合先发现互相矛盾的条款,再移动测试、代码风格和提交约定。
SKILL.md 中文导读
可复现示例
把虚构项目的 120 行 `CLAUDE.md` 拆成根摘要、测试规则和 TypeScript 规则。源文件对缩进同时写了两格与四格。请标出冲突,保留规则并列出待确认项。工作步骤
- 通读根指令,标出冲突、必读规则和重复段落。
- 将主题细节迁到对应文档,检查相对链接和规则含义,并把有争议的规则交由维护者决定。
验收方法
应得到一个短入口和两个可打开的详细文档。两条缩进规定被清楚标记待确认,原有测试命令可从入口跟到对应位置。
GitHub 原文 · 更新日期
适用环境
需要 Claude Code 和包含项目指令文件的本地工作副本。先准备需要保留的规则和相关文档。
常见问题
拆分时可以直接选一条互相冲突的规则吗?
先列出两条原规则和各自作用范围,交给维护者确认。将无冲突的内容按主题移动,并保留入口链接。