construction-blueprintlisted

# 施工蓝图 本 skill 是**任务级详细设计的施工层**，用户级通用，可跨项目使用。 它解决的问题：直接从设计跳到代码，评审只能发生在代码写完之后——错误已扩散进几十个文件，大 diff 评审有疲劳和沉没成本，范围蔓延和漏改反而最难看出来。施工蓝图把评审前移： > **作用 = 代码镜像 + 施工指南**：开工前把"动哪些文件、按什么顺序、关键处长什么样"钉死，让对抗评审打在图纸上。蓝图评审拦"方向错"，代码后检查拦"手抖错"，两道闸缺一不可。 与轻量设计方案（`lightweight-design` skill）的海拔分工： ``` 轻量设计方案 ── 决策海拔 ── 人看的，用户审核拍板 ↓ 施工蓝图 ────── 代码海拔 ── AI 看的，开工前对抗评审（本 skill） ↓ 施工 → 回补七层文档 ``` **关键性质：一次性消耗品。** L5/L6 禁止代码镜像是因为它们是长期真值、代码一改就腐烂；蓝图施工完即归档，**来不及腐烂**，所以文件清单、方法签名、伪代码在本层全部合法。 --- ## 1. 输入与何时用 **输入**（按优先级）： 1. 轻量设计方案（首选——已拍板的决策是蓝图的裁判标准） 2. 七层正式文档（任务直接基于现存设计施工时） 3. 需求 + 用户当轮聊天确认（必须在蓝图里显式登记为"真值来源"） **用**：中大任务施工前必经；凡是写了轻量设计方案的任务，默认接一份蓝图。 **可跳过**： - 小改动（计划模式足够） - 纯文档任务 - 轻量设计方案本身已足够简单、变更面只有一两个文件时（此时计划模式即蓝图） --- ## 2. 粒度铁律（防"代码写两遍"反模式） 蓝图写得太细 = 把代码写两遍，又慢又没增益。粒度卡死在： | 内容 | 粒度 | |---|---| | 变更清单（主体） | **文件级**：一文件一行，新增/修改/删除 + 一句"改成什么样" | | 关键实现点 | 仅歧义点/风险点下沉到**逻辑级**（允许方法签名、伪代码） | | 纯透传 / CRUD / 标准操作 | 只列文件，不展开 | **判定句**：蓝图字数接近预估代码量 → 写过头了，砍。 --- ## 3. 文档模板 ```markdown # 施工蓝图：{任务名} > 上游输入：{轻量设计方案路径 / 七层文档 / 用户决策} > 状态：待评审 / 已评审通过 / 施工中 / 已归档 ## 1. 任务边界 改什么 + 明确不改什么（负面清单，限制范围的主力） ## 2. 变更清单 ★代码镜像主体 逐文件三分类（含 DB migration、配置、脚本）： ### 新增 - `path/to/NewFile`：一句意图 ### 修改 - `path/to/File`：改哪部分、改成什么样（一句） ### 删除 - `path/to/OldFile`：为什么退出 ## 3. 关键实现点（仅少数点，逻辑级） 对有歧义/有风险的点写到逻辑级；允许签名与伪代码 ## 4. 施工切片 | 切片 | 内容 | 前置 | 完成判定 | 每片独立可编译/可验证；判定写得可执行，不写"完成即完成" ## 5. 历史资产退出（重构/替换类任务必写） 旧表 / 旧代码 / 旧格式 / 旧接口语义：删什么、何时删、是否留兼容层 ## 6. 红线自检 项目分层方向 / 域边界 / 工