Appearance
/sillyspec:scan
代码库扫描 — 棕地项目的入口。
交互式引导，问你要扫什么，不会上来就全量读文件。
快速扫描 ⚡
扫一眼项目概况，几秒钟搞定。
生成 3 份文档：
| 文档 | 内容 |
|---|---|
STACK.md | 技术栈 |
STRUCTURE.md | 目录结构 |
PROJECT.md | 项目概览 |
深度扫描 🔍
基于预处理脚本的输出，深入分析。
生成 7 份文档：
| 文档 | 内容 |
|---|---|
STACK.md | 技术栈 |
ARCHITECTURE.md | 架构（含数据模型摘要） |
STRUCTURE.md | 目录结构 |
CONVENTIONS.md | 代码约定（命名、风格、Git 规范） |
INTEGRATIONS.md | 集成（外部服务、API、环境变量） |
TESTING.md | 测试现状（框架、覆盖率、运行命令） |
CONCERNS.md | 技术债务（🔴严重 / 🟡中等 / 🟢低） |
预处理脚本（深度扫描专用）
深度扫描前自动运行 scripts/scan-preprocess.sh，零 token 完成以下工作：
- 📊 文件统计（按语言分类）+ 动态耗时估算
- 📁 目录分布（源文件最多的 Top 10 目录）
- 📦 依赖关系提取（Java/Python/JS/Go 各语言的 import 分析）
- 🏗️ 代码结构提取（类名、函数名、注解）
- 🗄️ 数据库 Schema 文件位置检测
- 🔍 框架和 ORM 自动检测（Spring Boot / Django / Flask / Gin / NestJS / Vue / React...）
- ⚙️ 框架配置文件检测（拦截器、审计、基类等隐形规则）
所有结果写入 SCAN-RAW.md，AI 读取这份摘要而不是原始源码。
好处：
- 大幅减少 token 消耗（AI 不读原始文件，只读结构化摘要）
- 防止上下文爆炸（300+ 文件的项目也能处理）
- 耗时估算按实际文件数动态计算（不是写死的 3 分钟）
断点续扫
深度扫描每份文档写完立即保存。即使中断，下次执行会自动检查：
📊 扫描进度检查：
✅ STACK.md 已存在
✅ ARCHITECTURE.md 已存在
✅ STRUCTURE.md 已存在
⬜ CONVENTIONS.md 待生成 ← 从这里继续
⬜ INTEGRATIONS.md 待生成
...只补缺失的文档，不会重复生成。
也可以用 /sillyspec:resume 自动探测中断状态。
数据库 Schema 扫描
无论哪种模式，都会自动扫描数据库 schema。 这是防止 AI 编造表名的关键步骤。
支持自动识别：Prisma、SQLAlchemy、Django、TypeORM、Mongoose、Java JPA、MyBatis、Go GORM、Drizzle、原始 SQL migration。
生成摘要表格（表名 + 说明 + 字段数），详细 schema 在后续阶段按需加载。
个性化建议
扫描完成后，AI 会根据项目特点给出建议：
- 没有测试文件 → "⚠️ 未发现测试，execute 阶段注意补充"
- 发现数据库 → "后续 brainstorm 会自动读取相关 schema"
- 发现 API 框架 → "execute 会强制读取现有 Controller/Service"
- 项目较大（100+ 源文件）→ "建议深度扫描获取完整分析"
传参模式（跳过交互）
如果你知道要扫什么，可以直接传参：
bash
# 快速扫描整个项目
/sillyspec:scan
# 深度扫描整个项目
/sillyspec:scan --deep
# 只扫描 api 模块
/sillyspec:scan api
# 深度扫描 api 模块
/sillyspec:scan api --deep传了参数就跳过交互引导，直接执行。