用途:把一个 Claude Code 项目的项目级上下文(CLAUDE.md + 可选 MEMORY/)重构为「AGENTS.md 作单一真源(SSOT)、CLAUDE.md 收敛成只含 Claude 强绑定内容的薄壳」的结构。Claude Code 经薄壳 CLAUDE.md 的 @AGENTS.md 引入共用内容,读取 AGENTS.md 的智能体(如 Qoder、Codex 等)原生加载同一真源,避免维护两份上下文。
主要能力:生成工具无关、去品牌的 AGENTS.md;改写 MEMORY 正文保持结构与文件数不变;生成行数很少的 CLAUDE.md 薄壳,内含 @AGENTS.md 引入与「Claude Code 专属」逃生舱注释;通过脚本做前置检查与覆盖率验证。
使用方式:默认以当前工作目录为项目根,需存在 CLAUDE.md。依次执行:python3 scripts/precheck.py <project-root> 做前置检查;快照原 CLAUDE.md 到 .migration-backup/CLAUDE.md.original;对 CLAUDE.md 段落分类并请用户确认;生成 AGENTS.md(含 @MEMORY/MEMORY.md 引入,总词数受预算约束);改写 MEMORY;生成薄壳 CLAUDE.md;最后运行 python3 scripts/coverage.py <project-root> 做覆盖率验证,并用 markdownlint 检查。
适用场景:用户需要把 CLAUDE.md 迁移为 AGENTS.md、让项目在读取 AGENTS.md 的智能体中可用、双工具共存,或从 Claude Code 切换到读取 AGENTS.md 的智能体。
限制:不改动权限配置、MCP 配置、scripts、references、eval;不删除 CLAUDE.md(薄壳共存,如需删除须用户显式确认);不生成智能体专属触发式 rule 文件(如 .qoder/rules/);不适用于从零创建项目上下文,也不适用于目标智能体完全不读取 AGENTS.md 的情况;已有 AGENTS.md 时须先获用户确认再覆盖。重复运行会覆盖已有 AGENTS.md,不产生重复文件。具体替换表、分层决策与模板见技能内 references/layering.md 与 references/rewrite-rules.md。