Skip to content

takeover.md

来自 cli/templates/level-3/

markdown
---
name: takeover
description: >
  接管现有项目。接手别人的项目或长期未维护的项目时使用。
  全面分析代码库,生成 CLAUDE.md 和体系配置。
---

# 接管现有项目

## 步骤

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]

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

面向个人开发者的 AI 辅助编程工程化方案