lightweight-designlisted
Install: claude install-skill BackToCimaCoppi/Praxis
# 轻量设计方案
本 skill 是**一次任务里高风险大决策的「清算层」**,用户级通用,可跨项目使用。
它解决的问题:大量任务是**局部修改/改造**,不值得每次重写整域 L5/L6;但只拿需求直接开工,AI 会在最危险的几个取舍上"看似合理地选错"。轻量设计就是补在中间的那一层——**把会出事故的决策,在动工前、在人能拍板的地方,逐个清算到唯一选择。**
> **与下游的分界线是【风险】,不是【海拔】。**
> 做错会出事故(拆不动 / 牵一发动全身 / 漏钱 / 白送权益 / 越权 / 丢数据)→ 本层清算钉死;
> 做错只是返工(参数名 / 方法互调 / 字段内部实现)→ **不进任何文档**,代码自由范围。
```
轻量设计方案 ── 高风险决策清算 + 影响面勘察 + 验收映射 ── 人工拍板闸(本 skill)
↓ 清算结论冻结为只读输入
测试用例设计 ── 完整用例直接写正式 L7 + 断言编号(待统一冻结)
↓
真值收敛与规格冻结 ── SD → 正式规格 → AC 对账全绿,七层一次冻完
↓
goal 章程 ───── 把裁决转成执行契约(目标+验证器+边界+切片) ── 接受红队评审(goal-charter)
↓
goal 执行 ───── 自主生产精确候选:代码 → 提交 → 测试 → 执行证据清单 → CANDIDATE_READY
↓ 候选 commit/tree + 真值基线 + 证据
候选终审 ──── 独立验收真实断言、边界形状与实现语义;闭环整改后才允许任务完成
```
> **施工蓝图已退役**(它自己跟自己打架:同一份 938 行文件相隔 264 行给出相反的施工指令)。它的两个器官各有新家:**影响面勘察 + 验收映射 → 本层 §7**;**施工切片 → goal 章程的里程碑**。
> 而它的第三部分「逐文件施工指令书」**没有新家,是被删掉的**——那是全链条唯一无上游、只能靠猜的内容,必然腐烂。
> ⚠️ **这一层防的是"空心设计"——决策表填满了、却把最危险的取舍一句话糊过或下放给没人细看的下游。**
> 防空心**不靠更厚的模板**(模板越厚越容易被"逐项 N/A 扫一遍"形式合规糊过),靠两件事:
> **① 事实基线**(每个高风险决策必须锚定"我在真实代码/业务真值里读到了什么",而非"列了哪些文件");
> **② 失败标准**(自检每一项都有明确的"什么算不合格",写几个字不算过)。
---
## 0. 触发、分档与两层边界
### 0.1 什么时候用 / 不用
**用**(满足任一即考虑):局部功能开发 / 局部重构 / 单链路改造,且**存在会出事故的决策点**;或任务跨多文件易范围蔓延;或用户要求"先出设计再动手"。
**不用**:
| 场景 | 改用 |
|---|---|
| 小改动(修 bug、加字段、单文件小改,无事故级决策) | 计划模式,零文档成本 |
| 整域级设计 / 新域立项 | 直接写七层正式文档 |
| 纯执行、无决策点的机械任务 | 直接做 |
| 跨会话、多 agent 超大任务 | `task-control-doc` 总控(标准模式七阶段,本层是其第 ③ 阶段) |
**反向升级**(轻量设计也不够用,必须升正式七层 / 专项):资金/权益/权限**整链路重构** · 跨多业务域 · 不可逆数据迁移 · **阻塞级决策相互耦合、无法在一次拍板内独立收敛**。