Studio Project Scan

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

wxxzy 71f391b 1.7 KB Updated

File contents

技能:项目扫描与映射 (/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 字]

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

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

wxxzy/Claude-Code-Software-Studios/tree/main/.claude/skills/studio-project-scan commit 71f391b821

Frequently asked questions

npx skillmds@latest add wxxzy/studio-project-scan