用途:把仓库从“通用 Claude Code 目标”转变为“精细调优的智能体工作区”,让 /build、/autopilot、/pr-fix 等自主技能具备完整项目认知。
主要能力:按阶段执行。Phase 1 用 glance 生成各目录 .glance.md 摘要(未安装则跳过);Phase 2 调用 /cartographer 生成 docs/CODEBASE_MAP.md,已有且较新时进入更新模式;Phase 3 审计并更新 CLAUDE.md,限定 200 行内,覆盖项目定位、命令、架构、技术栈、质量门禁、坑点、环境、部署;Phase 4 创建或审计 AGENTS.md,涵盖提交规范、测试、PR、编码风格、Issue 流程、完成定义、安全边界;Phase 5 扫描 git 历史与代码,为未记录的重要架构决策创建 ADR,每次最多 5 个;Phase 6 将项目特有坑点写入 ~/.claude/projects/<escaped-repo-path>/memory/MEMORY.md;Phase 7.5 发现可固化为 lint 规则的架构不变量并推荐给 /guardrail;Phase 8 分析是否需要项目专属技能。
使用方式:在仓库内运行 /tune-repo。前置检查包括 git rev-parse --is-inside-work-tree、git remote get-url origin,并先查看已有 CLAUDE.md、AGENTS.md、docs/CODEBASE_MAP.md、docs/adr/。
适用场景:需要让 AI 智能体在特定仓库中自主、稳定工作的团队。
限制:CLAUDE.md 不得超过 200 行;不覆盖已有准确文档;不为显而易见决策写 ADR;不写入推测性记忆;不对无变更仓库重复运行 Cartographer;本阶段只推荐护栏与技能缺口,不生成规则或技能。具体收费、平台支持等信息暂未提供。