用途:当任务涉及仓库级 CLAUDE.md 的创建、更新或裁剪时使用,尤其适合现有 CLAUDE.md 过长过泛或过时、仓库只有 Cursor/Copilot/Gemini/AGENTS.md 指令需迁移、Claude 在仓库中反复犯同类可避免错误、或工作流变化需同步收敛指南的场景。
主要能力:把 CLAUDE.md 当作活的协作约束清单而非代码库说明文档。核心是可发现性过滤:每条信息先判断 Claude Code 能否仅靠阅读 README、代码、配置、脚本和目录结构自行发现;能发现的不写,不能发现且真实影响任务成功率、成本、安全性或审批流程的才写。输出目标是 CLAUDE.md,其他指令文件仅作迁移输入,需提炼真实意图改写,不逐条照搬。优先保留高风险操作审批边界、不直观的命令限制或执行前提、模块与子项目路由规则、不可随意触碰区域及隐藏生产依赖、仅在特定任务下生效的约束。已有 AGENTS.md 应作为输入源吸收,除非仓库明确要维护两套格式,否则重叠信息尽量收敛到 CLAUDE.md。仓库很大时建议按模块拆分层级化 CLAUDE.md。
使用方式:写或清理前优先检查现有 CLAUDE.md、AGENTS.md、README.md、PROJECT.md、.claude/ 项目文件、.cursor/rules/ 或 .cursorrules、.github/copilot-instructions.md、GEMINI.md,以及 CI、workflow、包管理器和任务运行器配置。已有 CLAUDE.md 时优先增量改进,不整份重写。定稿前逐条检查:是否不可直接发现、今天是否仍准确、是否真能减少错误或浪费,任一项不成立就删。最小骨架含 Scope & routing、Non-discoverable commands、Approval boundaries、Landmines、Task-specific constraints 五节,仅作起点,需按仓库实际收敛。
限制:不应写入技术栈介绍、目录结构概览、看代码即可理解的架构说明、泛泛最佳实践、已被 lint/typecheck/测试/CI 强制保障的规则及不改变行为的模板化内容。同类问题反复出现时,应先修根因到代码、脚本、测试或自动化中,根因消失前只保留最少必要说明,并积极删除过时规则。资料未提供具体安装命令、收费或平台信息。