code-to-7layerlisted

# 从代码冷启动生成七层文档反推总控 > **交付物边界（必读）**：本 skill 的交付物是 Phase 0–2（扫描 + 骨架确认 + 任务总控文档创建）。具体层的文档撰写属于 Phase 3，通过 `/control` 逐子任务推进。本 skill 是编排器，不是文档生成器。**代码、实时数据库和运行行为只能形成候选规格与冲突证据；正式 L1~L7 必须经层内裁决与当前态重写后才能冻结。** **不适用场景**： - 代码与现有文档的增量同步 → 用 `doc-layer-system` skill - 仅补写 L1 需求层 → 用 `docs-from-code` skill **依赖 skill**（子任务执行时按需引用，不需要预加载）： - `doc-layer-system` §0.2（项目形态与层裁剪）— 决定哪些层适用 - `doc-layer-system` §0.3（业务域与功能模块）— 域/模块等价性约定 - `docs-from-code`（L1 反推方法论）— L1 层子任务执行时引用 - `control`（总控文档格式与推进机制）— Phase 2 生成总控文档时引用 --- ## §1 冷启动流程总览 ``` Phase 0 Phase 0.5 Phase 1 Phase 2 Phase 3（总控驱动） 扫描代码 → 活跃面识别 → 一次性骨架确认 → 生成总控文档 → 逐层逐域逐子任务产出文档 ↑ 本 skill 止步于此 ``` **Phase 3 的执行**：通过 `/control <关键词> Tn` 按子任务推进，每个子任务的提取指南见 §5。 --- ## §2 Phase 0：自动扫描项目结构 进入 skill 后，**无需用户输入**，直接扫描： ### 2.1 项目形态检测（三层检测） **第一层：仓库级**（是否为 monorepo/多子仓） | 信号 | 判断 | |---|---| | `pnpm-workspace.yaml` / `lerna.json` / `nx.json` / `rush.json` | monorepo，进入子项目级检测 | | `packages/` / `apps/` / `services/` 下存在多个独立子目录（各自有构建文件） | 多子仓，每个子目录独立判断 | | 无上述信号 | 单仓，直接进入子项目级检测 | **第二层：子项目级**（每个子仓/单仓判断框架） | 信号文件 | 框架/语言 | 初步形态 | |---|---|---| | `pom.xml` / `build.gradle` | Java/Kotlin 后端 | 纯后端候选 | | `requirements.txt` / `pyproject.toml` | Python 后端 | 纯后端候选 | | `go.mod` | Go 后端 | 纯后端候选 | | `package.json` 含 `express`/`koa`/`fastify`/`nestjs` | Node 后端 | 纯后端候选 | | `package.json` 含 `react`/`vue`/`angular`/`next`/`nuxt` | 前端框架 | 前端候选 | | `.wxml`