tikazyq/scaffold-analysis

Scaffold Analysis

Scope: EXECSPEC_COMPILE — Compile ExecSpec（编译 ExecSpec）

版本: 1.0.0 | 创建日期: 2025-02-03

---

1. 描述

Scaffold Analysis 识别项目的技术栈和依赖上下文，为后续编译 ExecSpec 提供基础信息。

核心职责：

• 读取Registry识别项目类型（Node.js/Python/Go）
• 识别测试框架（Jest/Pytest/RSpec/Go test）
• 从SPEC推断环境变量依赖（NFR/GOAL中声明的依赖）
• 识别外部服务依赖（数据库、API、消息队列）

Why：

• 避免环境配置遗漏（如dotenv经常被忽视）
• 为environment-config-generator提供输入依据
• 为round-planning提供技术复杂度上下文

---

2. 适用场景

• WORKFLOW Step 3 Task 3-1: 编译 ExecSpec Master Plan 前，执行脚手架分析
• 场景A: 新项目启动 Compile ExecSpec，需要识别技术栈
• 场景B: 跨项目迁移，需要快速了解技术上下文
• 场景C: 环境配置缺失，追溯技术依赖

对应 Build_Exec_Spec_Plans: Step 1 (Parse Implementation Plan)

---

3. 输入

• spec/spec_artifacts_registry.md - Registry文件，包含项目元数据和artifact清单
• package.json / requirements.txt / go.mod - 依赖配置文件

---

4. 输出

• spec/build/scaffold_analysis_report.md - 脚手架分析报告

报告包含:

• 项目类型（Language/Framework/Package Manager）
• 测试框架（Unit/Integration/E2E）
• 环境变量依赖（变量名 + Registry来源）
• 外部服务依赖（数据库/缓存/API）

---

5. 执行策略

步骤1: 读取Registry识别项目类型

扫描 spec_artifacts_registry.md，提取 project_language/project_framework 字段，推断项目类型（Node.js/Python/Go/Java）

步骤2: 识别测试框架

根据依赖配置文件推断：Node.js(jest/mocha) / Python(pytest/unittest) / Go(go test/testify)

步骤3: 推断环境变量依赖

从Registry文件提取NFR和GOAL中的环境配置需求（DATABASE_URL, API_KEY等），结合依赖配置文件推断外部服务依赖

注意: Compile ExecSpec 阶段发生在编码前，不扫描src/代码

步骤4: 识别外部服务依赖

根据依赖列表和环境变量模式推断服务类型：

• 数据库: pg/mysql/psycopg2/gorm + *_URL
• 缓存: redis/memcached
• API: axios/requests + *_KEY

步骤5: 生成报告

写入 spec/build/scaffold_analysis_report.md，包含项目类型 + 测试框架 + 环境变量 + 外部服务

---

6. 价值

SPEC组织

• 标准化技术栈识别流程，减少人工遗漏
• 为环境配置生成提供准确依据

PM/BA

• 快速了解项目技术上下文
• 识别环境配置风险点（如缺少dotenv导致启动失败）

Dev

• 自动化脚手架分析，避免手动梳理依赖
• 明确环境变量清单，减少"在我机器上能跑"问题

---

7. 验收标准

L1-STREAMLINED

检查清单（4项，≥75%通过）：

• [ ] 项目类型已识别（Node.js/Python/Go）
• [ ] 测试框架已识别（Unit Test框架）
• [ ] 环境变量依赖已扫描（至少3个常见变量）
• [ ] 报告已生成（scaffold_analysis_report.md）

通过标准：

• 4项中≥3项通过（≥75%）
• 必过项：项目类型已识别

---

L2-BALANCED

检查清单（6项，≥83%通过）：

• [ ] 项目类型已识别（Language + Framework）
• [ ] 测试框架已识别（Unit + Integration）
• [ ] 环境变量依赖已扫描（包含文件位置）
• [ ] 外部服务依赖已识别（数据库/缓存）
• [ ] 依赖配置文件已检查（package.json/requirements.txt）
• [ ] 报告已生成（包含依赖分析）

通过标准：

• 6项中≥5项通过（≥83%）
• 必过项：环境变量包含文件位置

---

L3-RIGOROUS

检查清单（8项，≥88%通过）：

• [ ] 项目类型已识别（Language + Framework + Package Manager）
• [ ] 测试框架已识别（Unit + Integration + E2E）
• [ ] 环境变量依赖已扫描（包含文件位置 + 使用频率）
• [ ] 外部服务依赖已识别（数据库/缓存/消息队列/API）
• [ ] 依赖配置文件已检查（版本约束分析）
• [ ] 安全性扫描（硬编码凭证检测）
• [ ] 技术债务识别（过时依赖/弃用API）
• [ ] 报告已生成（包含风险评估）

通过标准：

• 8项中≥7项通过（≥88%）
• 必过项：安全性扫描无硬编码凭证

---

8. /// 命令

///scaffold-analysis

---

相关 SKILLs

• 前置: 无（这是 Compile ExecSpec 的起点）
• 后续: environment-config-generator（使用分析报告生成环境配置）
• 后续: round-planning（使用技术复杂度评估Round数量）

---