技能:项目扫描与映射 (/studio-project-scan)
执行代理: technical-architect & lead-developer
概述 (Summary)
此技能用于在接手现有项目时,快速建立对技术栈、架构模式和代码质量的认知。
协作工作流 (Workflow)
- 自动审计 (Question-less): 代理自动扫描根目录和核心源码目录。
- 技术栈识别: 识别后端、前端、数据库和 CI/CD 配置。
- 产出方案 (Options):
- 代理展示识别到的架构草图。
- 询问用户:哪些模块是目前最需要关注的“黑盒”?
- 生成草案 (Draft):
- 生成
docs/arch/SYSTEM-MAP.md(系统模块图)。 - 生成
docs/arch/TECH-DEBT.md(已知技术债清单)。
- 生成
- 批准 (Approval): 用户确认文档准确性。
成功门控 (Success Gate)
- 明确标识了当前项目的入口文件和核心依赖。
- 文档中记录了至少 3 个核心模块的功能描述。
- 识别出了现有的测试覆盖情况。
输出约束 (Output Budget)
[强制] 返回主上下文时,只输出以下格式的单行摘要,不得重复文档内容:
扫描完成。以下是结果摘要:
**生成文档**
- `docs/arch/SYSTEM-MAP.md` — [一句话描述]
- `docs/arch/TECH-DEBT.md` — [X 条债务条目]
**最值得关注的技术债**
- [优先级最高的 1-2 条,每条不超过 30 字]
**下一步建议**
[一句话]
完整内容已写入文件,不得在摘要中展开。