用途:将工程的项目上下文归约为“AGENTS.md 作单一真源(SSOT)”的形态,兼容多个 AI coding agent。适用场景包括把 CLAUDE.md 改薄壳并引入 @AGENTS.md、合并去重并存的 CLAUDE.md 与 AGENTS.md,以及规范化已有 AGENTS.md。
主要能力:AGENTS.md 承载 L1 常驻内容,CLAUDE.md 退化为薄壳,仅保留 @AGENTS.md 与少量工具专属逃生舱;L2 记忆以 repo 根 MEMORY/ 为真源,在 AGENTS.md 的“## 跨会话记忆(索引)”段用单行 @MEMORY/MEMORY.md 引入,并由顶部强制 Read 指令兜底不展开 @import 的 agent;支持幂等重跑,临时快照目录 .migration-backup/ 在收尾删除。
使用方式:从 skill 根运行 python3 tools/precheck.py <project-root> 判定路径,路径 1 从 CLAUDE.md 迁移、路径 2 规范化 AGENTS.md;随后按分层生成 AGENTS.md、处理 MEMORY/、生成薄壳 CLAUDE.md,再运行 python3 tools/coverage.py <project-root> 做覆盖率比对,最后跑 markdownlint 并 rm -rf .migration-backup/。改写遵循 R1–R6 规则,只动上下文文件,不触碰权限、MCP 配置与目标项目脚本;不生成 agent 专属触发式 rule 文件;纯裸项目先用 /init 生成初始文件。分类表、逃生舱等内容需与用户交互确认,冲突口径由用户裁定。具体模板、替换表与验证细节见 ref/layering.md 与 ref/rewrite-rules.md。