/takeover

接管现有项目。接手别人的项目或长期未维护的项目时使用。

接管现有项目

步骤

1. 全局扫描 使用 Explore Agent 遍历项目结构，理解：

   • 目录组织和架构模式
   • 核心模块之间的依赖关系
   • 数据流向（前端 → API → 服务层 → 数据库）
   • 外部依赖和第三方集成

2. 文档盘点 逐项检查现有文档的存在性和新鲜度：

   • README、CLAUDE.md、API 文档、Schema 文档、CHANGELOG 等
   • 标注状态：Current（与代码匹配）/ Stale（明显落后）/ Outdated（严重不匹配）
   • 缺失的关键文档标注为生成候选

3. 技术栈识别 从配置文件提取：

   • package.json → 框架、库、scripts
   • tsconfig.json → TypeScript 配置
   • .eslintrc / prettier → 代码风格
   • docker-compose / Dockerfile → 部署方式
   • prisma/schema.prisma → 数据模型

4. 代码质量快照 快速评估：

   • 测试覆盖现状（有测试的模块 vs 没有的）
   • 代码风格一致性
   • TODO/FIXME/HACK 数量
   • 超长文件和复杂函数

5. 生成配置 基于分析结果生成：

   • CLAUDE.md — 项目描述、命令、架构、关键规则
   • .claude/settings.json — 权限配置
   • docs/approved-deps.md — 从现有依赖生成白名单

6. 输出分析报告

   ## 项目分析报告
   
   ### 技术栈
   [框架、语言、数据库、部署方式]
   
   ### 架构概览
   [核心模块及其关系]
   
   ### 代码健康度
   [测试覆盖、代码质量、技术债评估]
   
   ### 风险区域
   [缺少测试的关键模块、潜在安全问题、过度耦合]
   
   ### 建议的首要改进
   1. [优先级1]
   2. [优先级2]
   3. [优先级3]

文档考古（无契约项目适用）

接管的项目若无文档契约（无 ADR、无设计文档），执行本节：用 git 统计信号反推文档缺口。

• 热点模块 — git log --name-only 按目录聚合提交数，找出改动最频繁的模块（改得多 = 最需要文档）
• 修复密度 — 统计各活跃模块中 fix / bug / revert 类提交占比，占比 > 0.4 的模块 = 缺约束文档
• 孤儿决策 — 依赖清单 / 基础设施文件（package.json、Dockerfile、CI 配置等）有变更提交，但无任何决策记录 = 事后 ADR 候选
• 文档新鲜度 — 对比代码与文档的最后提交时间，代码热但文档冷的区域 = 文档已脱节

产出：事后 ADR 候选清单 + 文档缺口台账。

方法学谱系：行为代码分析（behavioral code analysis，Tornhill）。

有文档契约的项目跳过本节，走 doc-governance 契约校验。

IMPORTANT：

• 生成的配置是草稿，提醒用户必须审阅
• 不要编造项目中不存在的内容
• 对推断内容标注置信度：[HIGH] / [MEDIUM] / [LOW]