pdlc-adoptlisted

# 旧项目接入 PDLC <!-- @include templates/prompts/iron-law.md（已内联于下方，无需另读） --> ⛔ **IRON LAW · 不可违反的硬门禁** 以下规则为**不可协商**的执行约束： 1. **文件必须落盘**：所有带编号（功能ID / 缺陷ID）的文档，必须作为实际文件写入磁盘，不可仅在对话中输出。 2. **阶段必须落章**：每个阶段完成后必须在状态机 `docs/.pdlc-state/<feature-id>.json` 追加 history，不可跳过。 3. **测试必须存在**：进入 `/pdlc-implement` 前，对应测试必须存在且处于红灯状态。违反则中止。 4. **自检必须执行**：段二自检为强制步骤，不得以"已经很好了"为由跳过。 5. **防循环**：段三修复为单次，不递归。无法自动修复的问题记录到报告，继续往下走。 6. **状态必推进**：成功执行某 phase 后 `current_stage` 必须变更。收尾时若发现 `current_stage` 未推进，视为失败并报错，**不得静默返回**（防止外层循环拿滞后的状态空转烧额度）。唯一例外：命中人工点主动 block 时，`current_stage` 保持不变但必须写 `last_phase_result.ok=false` + `blocked_reason`。 **违反任一条 = 立即中止当前命令，输出违规详情，等待人工介入。** <!-- @include-end templates/prompts/iron-law.md --> 扫描现有项目结构，逆向生成基线文档，并进行健康检查发现潜在问题。让旧项目平滑接入 PDLC 流程。 ## 核心原则 - **只生文档，不动代码**：不修改任何现有代码，仅生成基线文档 - **增量接入**：旧代码标记为"已接入基线"，只有新功能走完整 PDLC - **守卫畅通**：生成的基线文档满足守卫检查，后续命令不再被阻断 ## 子命令解析 从本命令的参数中解析子命令： | 子命令 | 说明 | |--------|------| | `scan` | 扫描项目，输出接入报告 + 健康检查报告（不写任何文件，只读分析） | | `init` | 根据扫描结果，逆向生成基线文档到 docs/ 目录 | 如果未提供子命令或无法识别，输出以上帮助信息后停止。 --- ## scan 子命令 **全程只读，不创建/修改任何文件，只在终端输出报告。** ### 第一步：项目结构识别 1. **技术栈检测** - 检查特征文件：`package.json`、`pom.xml`、`build.gradle`、`go.mod`、`requirements.txt`、`Pipfile`、`Cargo.toml`、`mix.exs` 等 - 识别框架：Spring Boot、Express、NestJS、FastAPI、Gin、Echo、Django、Rails 等 - 检查前端框架：`react`、`vue`、`next`、`angular`（从 package.json 依赖推断） 2. **服务/应用识别** - 微服务：扫描 `backend/services/` 或具有独立启动入口的子目录 - 单体服务：根目录即为服务 - 前端应用：扫描 `frontend/`、`web/`、`app/` 或具有前端框