---
name: studio-project-scan
description: 【Studio】代码库扫描 — 映射既有项目、识别技术债 → docs/arch/SYSTEM-MAP.md + TECH-DEBT.md。当用户说「分析这个项目/代码库现状」时使用。
context: fork
agent: technical-architect
---

# 技能：项目扫描与映射 (/studio-project-scan)

**执行代理**: `technical-architect` & `lead-developer`

---

## 概述 (Summary)

此技能用于在接手现有项目时，快速建立对技术栈、架构模式和代码质量的认知。

## 协作工作流 (Workflow)

1.  **自动审计 (Question-less)**: 代理自动扫描根目录和核心源码目录。
2.  **技术栈识别**: 识别后端、前端、数据库和 CI/CD 配置。
3.  **产出方案 (Options)**:
    - 代理展示识别到的架构草图。
    - 询问用户：哪些模块是目前最需要关注的“黑盒”？
4.  **生成草案 (Draft)**:
    - 生成 `docs/arch/SYSTEM-MAP.md` (系统模块图)。
    - 生成 `docs/arch/TECH-DEBT.md` (已知技术债清单)。
5.  **批准 (Approval)**: 用户确认文档准确性。

## 成功门控 (Success Gate)

- 明确标识了当前项目的入口文件和核心依赖。
- 文档中记录了至少 3 个核心模块的功能描述。
- 识别出了现有的测试覆盖情况。

## 输出约束 (Output Budget)

**[强制]** 返回主上下文时，只输出以下格式的单行摘要，不得重复文档内容：

```
扫描完成。以下是结果摘要：

**生成文档**
- `docs/arch/SYSTEM-MAP.md` — [一句话描述]
- `docs/arch/TECH-DEBT.md` — [X 条债务条目]

**最值得关注的技术债**
- [优先级最高的 1-2 条，每条不超过 30 字]

**下一步建议**
[一句话]
```

完整内容已写入文件，不得在摘要中展开。