@dsh-cove/dsh-web-all 0.0.0-stage → 0.4.3

package/presets/code-vibe/skills/wish-programming/SKILL.md

@@ -0,0 +1,150 @@
+---
+name: wish-programming
+description: 许愿编程/愿望/从零构建系统应用工具平台网站/继续完成补全收尾； Use when a user gives a high-level product wish expecting a runnable implementation (develop or build a system, app, tool, platform, or website without a detailed spec), or when continuing, finishing, or extending an existing implementation in this preset workspace.
+---
+
+# Wish Programming
+
+把愿望变成可运行、可验证的最小可用产品。禁止用提案、脚手架或托管第三方生成器替代用户要的软件。
+
+> **性质（诚实声明）**：本 skill 是纪律约定 + 便利脚本 + 组织模式，不是运行时强制。真正的强制来自：DSH 审批栈（人闸）、沙箱（写码授权）、plan mode（方案闸）。脚本只帮自律的 agent 不自欺——别把脚本当安全边界。防自欺的终局防线是真人 co-sign + 真实渲染（截图）+ 机械对照，不是 AI 评 AI。
+
+## 原话优先原则（宪法）
+
+用户原话是唯一 ground truth，高于一切转述、设计、评审结论：
+
+1. **原话永不被改写**：愿望入库即把用户原话逐字落盘为 `docs/wish/<id>/quote.md`（一等工件）；下游产物只能「引用 + 解读」，不能「替代」。PM 转述必须标注，不得冒充原话。
+2. **冲突时原话赢**：任何转述/设计/结论与原话冲突 → 以原话为准，冲突显式登记并回用户裁决，禁止静默覆盖。
+3. **每道闸都对照原话**：确认包（§0 回显段）、需求清单（§0 原话节）、设计规范单（覆盖矩阵）、机械验收（落点核对）全部锚定原话。
+4. **原话与理解并置**：确认包必须「你的原话 ↔ 我的理解」对照呈现，让用户低注意力也能发现语义漂移。
+5. **原话外的定性词默认降级**：原话里没有的定性/范围词（如「推倒重画」）一律标〔PM 推断〕，未经用户确认不得进入任何下游承诺。
+
+## 五阶段流程
+
+> 质量内建在生成层，不靠事后检测。每一阶段的「质量后果」是它存在的唯一理由——说不出真实后果的环节，删。
+
+### 阶段 1 · 需求理解（不拆，conductor 主上下文执行）
+
+- 输入：`docs/wish/<id>/quote.md`（先读）+ 用户口述补充 + 存量页面/功能盘点（旧页面代码与现有入口）。
+- 动作：对照原话逐句消化；盘点存量功能（升级/迁移/重设计类愿望必做，逐条编号 O1…）；按 `references/templates/requirements.md.tpl` 产出 `docs/wish/<id>/requirements.md`（需求清单 N 编号 + 存量功能清单 O 编号 + ≤3 个澄清问题 + 语义不变量）；按 `references/templates/confirmation-pack.md` 产出确认包（§0 原样回显原话 + 场景故事 + 〔原话〕/〔PM 推断〕标注 + PM 推断清单 + 拍板点）。
+- 用 `references/roles/pm-reviewer.md` 作为**内建自查清单**（对照原话逐条核 + 存量保留核），不再单独派评审 agent。
+- 用户确认（人闸 ①）→ `journey.sh --confirm --by <用户>` 落 `.confirmed` 工件并**锁定 quote.md 指纹**（`.quote-hash`）；quote.md 内容一旦被改动（含只改一字），check_spec 凭指纹拦截——**quote 更新流程：quote.md 版本 +1 → 下游（requirements/confirmation-pack/design-spec）重新对齐 → 重新 `--confirm`（重落指纹），三步缺一不可**。
+- **质量后果**：需求从源头逐条有编号，存量功能逐条在案，后面一切对照它们——W3「4 项真丢」在此阶段就不可能被漏掉。
+
+### 阶段 2 · 设计规范单（不拆，conductor 主上下文执行 + 用户拍板）
+
+- 输入：requirements.md + 平台组件盘点（读组件目录与设计系统，列出可复用件）+ 用户认可的对标页面。
+- 动作：按 `references/templates/design-spec.md.tpl` 产出 `docs/wish/<id>/design-spec.md`——页面树 / 每页区块 / 每块指定组件 / 组件白名单 / 共享件清单 / 状态与响应式断点 / 需求覆盖矩阵 / **备选方案 Alternatives considered**。一次连续思考完成，禁止拆给多个 agent。
+- **前端/UX 类愿望必须先加载 `frontend-design`**：LOAD-MAP 字段门是硬门（Job Brief 三必填未齐不得定视觉）；其字段（UI surface/Design Read/page_kind/anchor/knobs）与本模板节（页面树/每页区块/白名单/…）的映射见 frontend-design SKILL.md「术语映射」节——两套术语在加载时对照执行，不各写各的。
+- 用 `references/roles/design-reviewer.md` 作为内建自查清单。技术架构类愿望（迁移/拆分/选型）额外做 arch.md 包（`arch.md.tpl` + arch-reviewer 内建自查）；页面/前端类愿望不做。
+- 用户对规范单（或线框）拍板（人闸 ②）。
+- **质量后果**：全部设计决策集中一次锁死；实现切片零设计决策权，互抄与口径漂移从机制上消失。
+
+### 阶段 3 · 实现（按页面族拆 2~4 片）
+
+- 第一片 = anchor（pro）：先建共享件 + 一个完整页面样板，锁模式。
+- 后续片：按 `references/templates/brief.md.tpl` 派发，brief 只含 规范单引用 + 本片页面清单 + 组件白名单；默认 flash。
+- **禁发明（硬规则）**：新组件/新布局/新样式是需要用户拍板的例外；禁止手写等价实现绕过白名单组件。
+- 每片完成即保持可运行；lint/type-check 每片必过（journey `--assert lint|typecheck --dir <切片>`）。
+- 每个切片 brief 必含：规范单引用 + 本片页面清单 + 组件白名单 + 原话对照 + **用户视角行**（目标用户是谁 + 做完后用户能看到/感受到什么变化；本片无用户可见面则显式说明）。
+- **质量后果**：复用是默认动作；一致性由白名单机械保障；页面族共享一份规范与样板，不再各画各的。
+
+### 阶段 4 · 机械验收（独立 agent，只做对照）
+
+- **先加载 `quality-review`**：其证伪纪律与证据契约适用本阶段（先证伪再 Pass；Evidence Kind 与 coverage.tsv 的对接见 quality-review SKILL.md「证据落点对接」节）。
+- 独立 fresh subagent（deny 写工具）执行：
+  1. **需求落点核对**：requirements.md 每条 N → 在新页面找落点，逐条回填；
+  2. **存量落点核对**：每条 O → 新落点 + 证据，写成 `.sdd/acceptance/<id>/coverage.tsv`，`coverage_check.py` 机械数数——缺条目 exit 1；
+  3. **多视口真实渲染**：1280/1440/窄分栏三视口截图落 `.sdd/acceptance/<id>/shots/`——**文件名以前缀标记**（`1280-` / `1440-` / `narrow-`，如 `1280-home.png`），**必须为 PNG 且实际像素宽度落在对应视口物理范围**（1280-* ≥1200px / 1440-* ≥1366px / narrow-* ≤1000px；容差覆盖 retina 2x）——同图复制冒充三视口、非浏览器产物都会被 width 断言拦下。非 UI 愿望（纯后端/库）在确认阶段用 `journey.sh --confirm --by <用户> --no-ui` 显式声明豁免截图（`.no-ui` 文件，用户动作，不做默认）——豁免仅跳过截图，coverage.tsv 照查；
+  4. **证伪刀**：按 falsify-checklist 默认证伪刀（翻页/无界滚动/表单/边界）至少一刀，失败 = Fail，不许 smoke 覆盖。
+- **质量后果**：丢功能、不响应式在交付前被数出来，不是用户投诉后发现。
+
+### 阶段 5 · 用户 judge（真实渲染迭代）
+
+- 用户看截图说「丑/挤/不对」→ 改 → 再截图，循环到点头。
+- 代码交付前：加载 `code-review` 做切片评审（缺陷+位置+影响+证据；门禁已覆盖的不重复提）；验收包按 `quality-review` 的 human-acceptance-pack 格式组织（产品级验收证据，与实证截图对应）。
+- 用户批准 → `journey.sh --approve --by <用户>` 落 `.approved`，然后 `--transition acceptance-passed`。
+- **质量后果**：用户反馈从「交付后投诉」变成「交付前迭代」。
+
+### 迷你复盘（用户打回 ≥2 次时）
+
+阶段 5 被打回 ≥2 次 → 写 `.sdd/acceptance/<id>/mini-postmortem.md`：哪道闸漏了（确认门/规范单/白名单/验收/截图）→ 为什么漏 → 补什么防线（回写 SKILL.md / check_spec / 模板）。只有重复出现的失败模式才写（防复盘通胀）；单次打回不写。
+
+## 拆分原则
+
+- **按认知边界拆，不按页面/文件拆**：需求理解不拆；设计决策不拆；实现按页面族拆（2~4 片）；验收机械拆。
+- **设计中心化、实现分布式**：切片 agent 零设计决策权。
+- **共享件先行**：anchor 片先建共享件与样板，后续片只用不造。
+- **并行只在实现层**：阶段 1/2 串行（质量核心），阶段 3 并行（机械铺开）。
+- **委托判据（反割裂）**：见 `agent-operation` skill——绝不委托需求理解、设计决策、产品判断、方案收敛；conductor 本身就是 pro，这些环节自己执行。
+
+## 减法与通用纪律（引用）
+
+- 涉及既有代码/存量逻辑：优先净删除；候选三态（不可达行为/收窄行为显式损失/证据不足）；「把复杂度搬家不算简化」——加载 `dsh-find-simplifications`。
+- 模型路由（继承优先、同族换档）与委托判据：加载 `agent-operation`。
+- 写作/措辞/确认包语言：加载 `dsh-prose-standard`（原话/〔PM 推断〕标注之外的通用文案纪律，含思维链泄漏清理 `dsh-trim-cot-leakage`）。
+- 切片测试可靠性：加载 `dsh-ci-test-reliability`（防 flake、确定性、负对照）。
+
+## 报告协议（防假报绿）
+
+- **通用报告纪律（只报实跑命令、pending 报 pending、retries/skips 不称 passing）见 `agent-operation`「报告纪律」——本节点它的名，不重复全文。**
+- 流程特有部分：`journey.sh --confirm/--approve --by <用户>` 只能由用户在确认交互中提供；agent 不得代填「用户已确认」；未运行的验证报告为 pending。
+
+## 门禁与脚本
+
+```bash
+WISH="<预设>/scripts/wish.sh"          # --new --title "…" [--quote "用户原话"]；--start <id>
+CHECK="<预设>/scripts/check_spec.py"   # <ws> <id> [--phase design|build|close]：机械结构门（下限，不是质量）
+COVER="<预设>/scripts/coverage_check.py"  # <ws> <id>：存量功能落点完整性（阶段 4 用）
+JOURNEY="<预设>/scripts/journey.sh"    # --confirm/--approve/--status/--transition acceptance-passed|blocked|stuck [--root <dir>]
+```
+
+- 人闸工件：`.sdd/acceptance/<id>.confirmed`（阶段 1 后）、`.sdd/acceptance/<id>.approved`（阶段 5 后）、`.sdd/acceptance/<id>.no-ui`（非 UI 愿望的截图豁免声明，仅 `--confirm --no-ui` 时生成）。
+- 终态：`acceptance-passed | blocked（可复现外部阻断）| stuck（修复预算耗尽）`；blocked/stuck 仅人 `--set` 恢复。`--transition acceptance-passed` 无验收证据（`.sdd/acceptance/<id>/` 与 `.no-ui` 均缺）→ 机械拒绝。
+- `--assert deploy` 永远失败：生产动作必须本回合真人授权。
+- gate-lock：改 scripts/ 后必须重跑 `gate-lock.sh`，否则 verify/journey 拒信。
+
+## 仓库体系路由规则（既有权威仓库适用）
+
+工作区是带权威 AGENTS.md 与四维 docs 体系的既有仓库（如 data-sage）时：
+1. 本预设 = 前置理解层（原话锚定 + 需求清单 + 设计规范单）；
+2. 最终交付走仓库既定轨（vibe-coding 五件套 `docs/specs/<id>/`）；禁止从愿望直接编码；条件式降级：插件不可用时本预设闸门承担全责并向用户明示；
+3. 回填对齐仓库回填矩阵与 handoff 纪律，不另立第二套。
+
+## 调研/评审模式分轨
+
+调研、探查类任务不套五阶段：产出白名单 = findings + Gap 登记 + 方向缺口对照表；禁越界产出新蓝图。调研前强制读已立项产品方向文档；结论逐条标 符合/偏离/缺口。
+
+## 产品判断软约束
+
+1. 先问再画：答不全「谁用、干什么、何时用、现在怎么解决」先问 1~3 个澄清。
+2. 用户视角是必选维度：persona × 任务旅程组织发现。
+3. 决策点只允许「用户价值取舍」；权限/技术决策内部收敛。
+4. 自助耗尽再升级：凭证/账号/环境先耗尽 .env*/种子/历史会话/memoir/artifacts；技术验证（lint/浏览器/登录）是 agent 职责，永远不是暂停点。
+5. 单点阻塞不停摆：blocked 切片挂起、其余继续，并行汇报。
+6. 主对话常驻语义不变量清单（含 Out-of-scope 一句话版）。
+
+## 模型路由
+
+完整路由表与委托判据见 `agent-operation` skill（继承优先、同族换档；拿不准就继承；不跨族）。
+
+## Delivery target
+
+| Target | 含义 |
+|---|---|
+| code-ready | 代码+契约完成，未部署 |
+| dev-effective | dev/preview 真实可用 |
+| production-delivered | 生产真实可用（目标环境 smoke 后） |
+
+`acceptance-passed` 是完成声明不是交付目标；上生产永远需要本回合真人授权。
+
+## Construction channel（谁做什么）
+
+| 工作 | 谁 |
+|---|---|
+| 需求理解、设计规范单、拆分、裁决 | conductor（pro） |
+| 确认门 / 最终验收 | 用户（人闸，judge） |
+| 实现切片 | 按页面族拆 2~4 片，anchor 先行；conductor 主上下文推进或用浅层 subagent 并行；workflow 仅用户点名时用 |
+| 机械验收对照 | 独立 fresh subagent（deny 写工具） |
+| 门禁脚本运行与证据合成 | conductor |
+| 长跑修复 | goal 续跑；ralph 仅用户点名 |

package/presets/code-vibe/skills/wish-programming/references/roles/arch-reviewer.md

@@ -0,0 +1,26 @@
+# arch 内建自查清单 — 技术架构附加自查
+
+> 用途：本清单由**阶段 2 的 pro agent 仅对技术架构类愿望附加内建自查**使用（生成 `docs/wish/<id>/arch.md` 后、阶段 3 之前），替代原「派发 2 个非作者独立只读 subagent 对抗对、conductor 组装 review-arch.md」的评审仪式（AI 评 AI 不产生质量后果）。自查须逐项覆盖下方清单，每条结论附证据/理由。
+> 建议档位：同 provider 强档（默认继承；换档用同族兄弟档）。
+
+## 公共输入
+- `docs/wish/<id>/quote.md`（用户原话逐字转录，最高优先级，必读）
+- `docs/wish/<id>/arch.md`（必读）+ requirements.md（交叉验证技术方案是否违背语义不变量）
+- 仓库 `docs/architecture/09-decisions/` 历史 ADR（防决策回退）
+- 已立项产品方向文档（验证「方向对齐」段属实）
+
+## 自查清单（逐项 通过/问题+证据）
+0. **原话对照（最高优先级）**：读 `docs/wish/<id>/quote.md`，逐句核对本包是否忠实——命中以下任一 → 记 blocker：① 用户原话中的限定词/前提在复述中丢失或被替换（如「在 X 基础上升级」变成「推倒重画」）；② 转述与原话语义冲突；③ 原话里未出现的新增定性词/范围扩大未标注「PM 推断」且未经用户确认。
+1. **现状盘点 vs 结论**：盘点真实（Verified/Unverified 标注）？有没有「用现状差异否定收敛方向」的反向结论？
+2. **方向对齐**：逐条标 符合/偏离/缺口？「偏离」有显式论证与用户拍板记录？
+3. **方案选项**：≥2 方案？权衡矩阵覆盖 用户影响/迁移成本/回滚能力/演进空间？有没有把「工程上最安全」当唯一方案？
+4. **语义不变量违背检查**：违背 requirements.md §4 语义不变量（凭证零失效/外部集成零打断/数据可恢复/存量功能零丢失）？不可逆方案是否书面论证「零失效/可恢复方案为何不可行」？
+5. **语义不变量**：实现是否保持产品语义（空结果=成功等）？有无为「机器可读性」牺牲用户语义？
+6. **影响面**：调用方/接口/数据/回滚点列全？有「用户可见变化」一行（等待时间/体积/失败率/失效面）？
+7. **ADR 完整性**：决策/背景/选项/后果/状态齐全？不可逆决策登记 `09-decisions/`？
+8. **边界纪律**：跨面/跨域操作（SR 引擎面 vs 服务面）显式 Out-of-scope？「评估/降级/登记」弱化项逐条列明？
+9. **架构定位四问**：归属/债务（预算+偿还时机）/路线图联动/前瞻扩展点——四问全部有答案？
+
+## 自查纪律（吸收自原对抗对的攻击性检查）
+- **反事实**：对每条结论问一句「若 X 相反会怎样？」，结论须在反面论证下仍站得住。
+- **事故路径/补丁检测**：对每个方案问「让它在生产出事故的最短路径是什么？」「这是架构动作还是补丁？若是补丁，正确的最小架构动作是什么？」；找不到问题时逐项说明攻击面与事故路径为何走不通。

package/presets/code-vibe/skills/wish-programming/references/roles/design-reviewer.md

@@ -0,0 +1,32 @@
+# design 内建自查清单 — 设计规范单自查
+
+> 用途：本清单由**阶段 2 设计规范单 agent**（pro）在生成设计规范单后**内建自查**使用，替代原「派发 2 个非作者独立只读 subagent 对抗对、conductor 组装 review-design.md」的评审仪式（AI 评 AI 不产生质量后果）。自查须逐项覆盖下方清单（产品架构段 + UX 段），每条结论附证据/理由。
+> 建议档位：阶段 2 agent 用同 provider 强档（默认继承；换档用同族兄弟档）。
+
+## 公共输入
+- `docs/wish/<id>/quote.md`（用户原话逐字转录，最高优先级，必读）
+- `docs/wish/<id>/requirements.md`（必读）+ confirmation-pack.md（若存在）
+- 仓库设计系统文档 / 既有页面设计包（检查是否对齐，而非另起炉灶）
+- 历史失败样本（自声明已读）
+
+## 自查清单（产品架构段 + UX 段，逐项 通过/问题+证据）
+
+0. **原话对照（最高优先级）**：读 `docs/wish/<id>/quote.md`，逐句核对本包是否忠实——命中以下任一 → 记 blocker：① 用户原话中的限定词/前提在复述中丢失或被替换（如「在 X 基础上升级」变成「推倒重画」）；② 转述与原话语义冲突；③ 原话里未出现的新增定性词/范围扩大未标注「PM 推断」且未经用户确认。
+
+### A. 产品架构
+1. **信息架构**：导航层级/页面树/模块归属单独成节且合理？「管理功能」是否被默认塞进 admin？
+2. **模块定位**：每页/每区块回答「承载哪条任务流」？有无大杂烩页面？
+3. **任务流完整性**：核心端到端链路（如 SQL→存为数据服务→绑定凭证→消费）作为主线设计？
+4. **收敛一致性**：与统一/收敛方向一致？引用旧文档结论是否标注收敛前/后时效？
+
+### B. UX
+5. **用户语言**：界面文案用用户词汇而非治理/工程词汇（scope 表单即反例）？
+6. **交互规格**：关键页面逐页交互规格（状态机/二次确认/乐观更新/快捷键），非「布局+字段」线框？
+7. **四态覆盖**：空/加载/错误/权限逐页设计？「已达标/复用现网」每处附实测证据路径？
+8. **触发时机**：用户何时进入、带什么上下文？事件/任务驱动还是浏览型 KPI 墙？
+9. **对标纪律**：对标产品是「从用户任务出发选择性借鉴」还是逐条搬运？每条标 adopt/adapt/defer+落地约束？
+10. **一致性**：跨页概念（状态词/入口/权限口径）统一？
+
+## 自查纪律（吸收自原对抗对的攻击性检查）
+- **反事实**：对每条结论问一句「若 X 相反会怎样？」，结论须在反面论证下仍站得住。
+- **补丁检测**：对每个设计决策问「这是在满足需求，还是在给系统打补丁？若是补丁，最短的正确设计动作是什么？」。

package/presets/code-vibe/skills/wish-programming/references/roles/pm-reviewer.md

@@ -0,0 +1,26 @@
+# pm 内建自查清单 — 需求理解（PRD）自查
+
+> 用途：本清单由**阶段 1 需求理解 agent**（pro）在生成 `docs/wish/<id>/requirements.md` 后**内建自查**使用，替代原「派发 2 个非作者独立只读 subagent 对抗对、conductor 组装 review-pm.md」的评审仪式（AI 评 AI 不产生质量后果）。自查须逐项覆盖下方清单，每条结论附证据/理由。
+> 建议档位：阶段 1 agent 用同 provider 强档（默认继承；换档用同族兄弟档）。
+
+## 公共输入
+- `docs/wish/<id>/quote.md`（用户原话逐字转录，最高优先级，必读）
+- `docs/wish/<id>/requirements.md`（必读）
+- `docs/wish/<id>/confirmation-pack.md`（若存在，交叉验证理解一致性）
+- 仓库 `docs/product/` 已立项方向文档与模块 README（本 wish 是否与已定方向冲突）
+- 历史失败样本（gap-register / decisions，自查时自声明「已读」）
+
+## 自查清单（逐项 通过/问题 + 证据）
+0. **原话对照（最高优先级）**：读 `docs/wish/<id>/quote.md`，逐句核对本包是否忠实——命中以下任一 → 记 blocker：① 用户原话中的限定词/前提在复述中丢失或被替换（如「在 X 基础上升级」变成「推倒重画」）；② 转述与原话语义冲突；③ 原话里未出现的新增定性词/范围扩大未标注「PM 推断」且未经用户确认。
+1. **模块定位**：定位是否具体到是什么/服务谁/边界？与已立项方向（收敛/退役/迁移）对齐？
+2. **用户画像**：≥2 行且覆盖人类用户+下游消费方双层？Job-to-be-done 证据来源必填或标 Unverified？
+3. **场景旅程**：≥3 条含 when/why/what？覆盖消费主线与治理支撑？「何时使用」有答案？
+4. **IA 与收敛**：UI 类 wish 有导航层级/页面树/模块归属？与收敛框架关系显式标注？
+5. **产品原则**：≥1 条不可违背承诺？每条映射至少一个设计决策？
+6. **语义不变量**：≥1 条？与历史决策记录一致（防语义回退）？
+7. **范围纪律**：Out-of-scope 显式？无越界新功能蓝图？
+8. **决策记录**：用户拍板/纠偏逐条登记且含反方最强论点？
+
+## 自查纪律（吸收自原对抗对的攻击性检查）
+- **反事实**：对每条结论问一句「若 X 相反会怎样？」，结论须在反面论证下仍站得住。
+- **攻击面声明**：找不到问题时逐项说明「查过什么、风险面在哪、为何安全」，不得以「没发现问题」代替「没有问题」。

package/presets/code-vibe/skills/wish-programming/references/roles/qa-reviewer.md

@@ -0,0 +1,16 @@
+# qa-reviewer — 测试设计评审帽（条件触发）
+
+> 触发：wish 含测试矩阵/复杂状态机/数据面（列表/排序/过滤/分页/边界语义）时挂载。
+> 只读、非作者、blocker ≤3 附证据；产出 `review-qa.md`（交锋段格式，末行 结论：pass|blocker）。
+
+## rubric
+1. **Oracle 强度**：每个验收检查有 success + failure/permission 两态？数据面有两态可区分证据（不同 offset/param → 不同行）？
+2. **边界语义**：空结果/取消/超时/权限拒绝四类边界语义各有断言？与语义不变量清单一致？
+3. **失败变体**：grader 必须构造 ≥3 个失败变体（空/取消/403/超时）并全部按预期失败——只测成功路径的 pass 无效。
+4. **V2.5 四态**：scenario 覆盖 空/加载/错误/权限 四态 + ≥1 边界语义行？
+5. **红绿重放**：每项自动化检查在改动前基线是红的（先红后绿），否则无信息量。
+
+## mandate（否决方）
+攻击以上每项；必须输出 ≥1 条「测试矩阵会漏掉的用户可见缺陷」反事实；零问题须声明攻击面。
+
+> 建议档位：qa/证据收集类用同 provider 快档（narrow 任务）；判读类用强档（默认继承；换档用同族兄弟档）。

package/presets/code-vibe/skills/wish-programming/references/roles/security-reviewer.md

@@ -0,0 +1,16 @@
+# security-reviewer — 凭证/权限评审帽（条件触发）
+
+> 触发：wish 触碰凭证、Key、鉴权、权限模型、明文敏感数据时挂载。
+> 只读、非作者、blocker ≤3 附证据；产出 `review-security.md`（交锋段格式，末行 结论：pass|blocker）。
+
+## rubric
+1. **明文暴露面**：Key/密码/令牌任何界面或日志出现明文 = 一票 blocker；哈希存储核对（sha256 全仓唯一真源）。
+2. **权限口径**：admin/operator/普通用户/下游消费方四类角色逐接口核对；403 而非 500；越权反例实测。
+3. **最小授权**：新功能默认最小权限？scope 推导不出服务时拒绝而非放行？
+4. **审计**：敏感操作（签发/吊销/删除）留审计记录？
+5. **零失效承诺**：改动不得使已签发凭证/外部集成断连；重签发类方案必须有书面不可行论证。
+
+## mandate（否决方）
+攻击以上每项；必须构造「攻击者最短得手路径」≥1 条；零问题须声明攻击面。
+
+> 建议档位：证据收集类用同 provider 快档（narrow 任务）；security 判读用强档（默认继承；换档用同族兄弟档）。

package/presets/code-vibe/skills/wish-programming/references/roles/sre-reviewer.md

@@ -0,0 +1,16 @@
+# sre-reviewer — 迁移/性能/配额评审帽（条件触发）
+
+> 触发：wish 含数据迁移、性能改动、限流配额、缓存、任务队列、延迟敏感路径时挂载。
+> 只读、非作者、blocker ≤3 附证据；产出 `review-sre.md`（交锋段格式，末行 结论：pass|blocker）。
+
+## rubric
+1. **用户可见延迟**：改动后用户感知的等待时间/吞吐变化量化了没有？前端超时阈值核对过没有？
+2. **迁移安全**：双写/宽限/回滚路径？不可逆点（重签发/删除）有书面论证吗？「用户已有凭证零失效」原则核对？
+3. **配额与优先级**：key/用户优先级、并发、资源组（RG）行为与现网路由兼容？
+4. **容量与清理**：数据量增长、缓存淘汰、失败历史清理、重试风暴（幂等）？
+5. **可观测**：新改动有告警/审计/日志入口？静默失败面？
+
+## mandate（否决方）
+攻击以上每项；必须构造「生产事故最短路径」≥1 条；零问题须声明攻击面与事故路径为何不通。
+
+> 建议档位：证据收集类用同 provider 快档（narrow 任务）；sre 判读用强档（默认继承；换档用同族兄弟档）。

package/presets/code-vibe/skills/wish-programming/references/roles/ux-adversary.md

@@ -0,0 +1,16 @@
+# ux 走查清单 — 阶段 4/5 走查（条件触发）
+
+> 用途：本清单由**阶段 4/5 的 pro agent**在验收前对高交互 UI 愿望（编辑器/工作台/拖拽/多 Tab/表单流）做**真实浏览器走查**使用，替代原「体验对抗者帽 + 产出 review-ux.md 交锋段」的仪式。走查须逐项覆盖，卡点须复现并附截图/步骤。
+> 建议档位：机械走查/截图收集可用同 provider 快档；卡点判读用强档（默认继承；换档用同族兄弟档）。
+
+## 公共输入
+- `docs/wish/<id>/quote.md`（用户原话逐字转录，最高优先级，必读）
+
+## 走查清单
+0. **原话对照（最高优先级）**：读 `docs/wish/<id>/quote.md`，逐句核对本包是否忠实——命中以下任一 → 记 blocker：① 用户原话中的限定词/前提在复述中丢失或被替换（如「在 X 基础上升级」变成「推倒重画」）；② 转述与原话语义冲突；③ 原话里未出现的新增定性词/范围扩大未标注「PM 推断」且未经用户确认。
+1. **找卡点**：走查必须找到 ≥1 个「用户会卡住的点」并**复现**（附截图/步骤）；空手而归必须**声明搜索过的空间**（测了哪些路径、哪些态、哪些角色）——「没找到问题」≠「没有问题」。
+2. **四态实测**：空/加载/错误/权限逐页实测，「已达标/复用现网」每处附实测证据路径，断言项不得进 P0。
+3. **边界语义实测**：空结果=成功、取消终态、403 非 500——各构造一次真实触发。
+4. **用户语言**：界面文案逐个过——治理/工程词汇（scope 等）出现即记 blocker。
+5. **多视口走查**：1280 / 1440 / 窄分栏各截图一次，固定宽度/溢出/挤爆即记录问题。
+6. blocker ≤3 附证据。

package/presets/code-vibe/skills/wish-programming/references/templates/arch.md.tpl

@@ -0,0 +1,51 @@
+# <wish 标题> · 架构包（技术方案）
+
+> 复制本模板到 `docs/wish/<id>/arch.md` 并逐节填写。
+> 完成后必须先过 arch-reviewer 评审（非作者独立 subagent，产出 review-arch.md 且结论 pass）
+> 才能 planning → building。
+> 占位 `<...>` 必须替换；无法回答的节写明「N/A + 理由」。
+
+## 1. 现状盘点（只读探查产物）
+
+| 项 | 现状 | 证据级（Verified/Unverified/Assumption） |
+|---|---|---|
+| …… | …… | …… |
+
+## 2. 方向对齐（先读已立项产品方向文档，逐条标注）
+
+| 已立项方向（出处） | 符合 | 偏离 | 缺口 |
+|---|---|---|---|
+| 例：mcp_api_keys 并入 gateway_api_keys（agent-cli-access §5） | | | 迁移硬点：key_raw 重签发 vs 零失效 |
+
+> 规则：现状盘点只是输入，评审方向以产品决策文档为准；「现状不同」≠「不该收敛」。
+
+## 3. 缺口分析（现状离方向的差距；禁直接跳结论/蓝图）
+
+- 差距 1：……
+- 差距 2：……
+
+## 4. 方案选项（≥2 个）× 权衡矩阵
+
+| 维度 | 方案 A：…… | 方案 B：…… |
+|---|---|---|
+| 用户影响 | | |
+| 迁移成本 | | |
+| 回滚能力 | | |
+| 演进空间 | | |
+
+## 5. ADR（决策/背景/选项/后果/状态）
+
+- 决策：……
+- 背景：……
+- 选项：A / B（见 §4）
+- 后果：正面 / 负面 / 不可逆点
+- 状态：proposed | accepted | superseded
+- 【动作】不可逆决策须同步登记仓库 `docs/architecture/09-decisions/NNN-*.md`。
+
+## 6. 影响面评估
+
+| 受影响调用方/接口/数据 | 回滚点 | 用户可见变化（一行） |
+|---|---|---|
+| 例：AgentDeck provision | 回滚到迁移前镜像 | 无（凭证零失效） |
+
+## 7. 演进路线（可选；调研/评审类任务禁产出本节约界蓝图）

package/presets/code-vibe/skills/wish-programming/references/templates/brief.md.tpl

@@ -0,0 +1,36 @@
+# 切片 brief：<slice id>
+
+> 阶段 3 实现片。**本片 agent 零设计决策权，只照规范单施工。**
+
+## 背景
+
+- 愿望：<id>
+- 规范单：`docs/wish/<id>/design-spec.md`（**先读**，本片对应其中第 2 节哪几块）
+- 需求清单：`docs/wish/<id>/requirements.md`（对照，本片承载哪些 N/O 编号）
+
+## 本片页面清单
+
+- （页面族：路由路径 → 规范单第 2 节对应区块）
+
+## 允许使用的组件（白名单，从规范单第 3 节复制）
+
+-
+
+## 共享件（从规范单第 4 节复制）
+
+- 本片若为 anchor：需新建的共享件清单与签名；
+- 非 anchor：**只用不造**；发现缺件 → 停下报告 conductor，禁止自行新增。
+
+## 禁发明（硬规则）
+
+1. 禁止新建组件/布局模式/样式体系——白名单外的任何 UI 原语都算发明；
+2. 禁止手写等价实现绕过白名单组件（如自写 table 代替 AppDataTable、自写弹层代替 Popover）；
+3. 复用已有组件时禁止改变其视觉默认（改样式 = 改规范单，先报告）；
+4. 禁止使用固定像素宽度/高度硬编码布局（响应式规则见规范单第 5 节）。
+
+## 完成后（自检，逐项）
+
+- [ ] 对照需求清单：本片承载的每个 N/O 编号在页面有落点（写落点清单）；
+- [ ] lint / type-check 通过（跑真实命令，附输出）；
+- [ ] 浏览器打开真实渲染，多视口截图放 `.sdd/acceptance/<id>/shots/`（本片页面各 1 张 + 窄分栏 1 张）；
+- [ ] 未发明任何白名单外组件（若有，列出并说明）。

package/presets/code-vibe/skills/wish-programming/references/templates/confirmation-pack.md

@@ -0,0 +1,54 @@
+# confirmation-pack — 用户故事包（确认门工件）
+
+> 用途：前台 PM 与用户确认需求理解的**唯一格式**。写完先过内部 red-team（「用户会在哪里误解这份包？」），再发给用户。
+> 用户确认后：conductor 执行 `journey.sh --confirm --by <用户>` 落工件，并把确认结论逐条登记进 product.md 决策记录。
+> 禁用词汇表：本文件出现 scope / adminOnly / 治理动作 / 路由 / Schema / 命名空间 / Endpoint / 限流配额 / Gateway 管理 等工程词汇时，必须同段附「（白话：…）」解释——check_spec 机检。
+
+# <wish 标题> · 用户故事包
+
+## 0. 你的原话（原样回显）
+
+> **quote 版本：vN**（对应 `docs/wish/<id>/quote.md` 头部版本；若 quote.md 已更新到 vN+1，本包作废需重做——版本不齐 = stale，check_spec 检出。）
+
+> 从 `docs/wish/<id>/quote.md` **原样复制**用户原话正文到这里，一字不改。禁止改写、禁止省略、禁止「概括」——只做逐字转录。
+
+> 下面第 1 节是我的理解，请对照本节逐句核验：凡第 1 节与本节不一致处，以本节（你的原话）为准。
+
+## 1. 我理解你要的是
+
+> 转述来源标注规则：本节每一句关键复述必须标注 〔原话〕（用户原话里确实出现的）或 〔PM 推断〕（我自行补充的理解）。凡用户原话里没有出现的定性词 / 范围词（如「推倒重画」「全部重做」「重设计」这类），一律标 〔PM 推断〕，不得混在原话复述里。
+
+（一段话。然后必须给 2~3 个具体使用场景故事——具体场景是理解验证的核心：抽象复述用户都会点头，具体场景才能逼出偏差。）
+
+- 场景 1：「如果我是<角色>，我会：<具体步骤，用产品词汇描述，不出现技术词汇>」
+- 场景 2：……
+- 场景 3：……
+
+## 2. 做完后你能看到什么
+
+（文字线框 + 验收清单，全部用户语言）
+
+- 界面上：……
+- 我能做到：……
+- 验收清单（用户可自己验证的口语化条目）：
+  1. ……
+  2. ……
+
+## 3. 需要你拍板的点（≤3 个）
+
+> 纪律：只允许「用户价值取舍」（新手 vs 老手、开放 vs 管控、快 vs 全）；权限/技术实现类决策不下放，团队内部收敛。
+
+| # | 拍板点 | 选项 | 推荐 | 影响（白话） |
+|---|---|---|---|---|
+| 1 | …… | A：…… / B：…… | A | 选 B 会…… |
+
+## 4. 这次不做什么
+
+（Out-of-scope 一句话版，白话。）
+
+## 5. PM 推断清单（需你逐条确认或否决）
+
+> 我在上面第 1 节里自行补充的定性词 / 范围判断，逐条列出，一行一条。未获你确认的推断不得进入设计与实现。
+
+- 〔PM 推断〕……（若含工程词汇，同条附「白话：…」）
+- ……

package/presets/code-vibe/skills/wish-programming/references/templates/design-spec.md.tpl

@@ -0,0 +1,49 @@
+# <wish id> · 设计规范单
+
+> 阶段 2 产出（1 个 pro agent，一次连续思考完成）。**全部设计决策集中于此；实现切片零设计决策权。**
+> 用户拍板后才进入阶段 3。禁拆给多个 agent。
+
+## 1. 页面树与导航
+
+（页面/区块层级；每页标注承载哪条需求编号 Nx）
+
+## 2. 每页区块设计
+
+（逐页：区块 → 内容 → **指定组件（必须引用平台已有组件路径）** → 状态样式。找不到已有组件 → 标「需新建，待用户拍板」，禁止默认发明。）
+
+## 3. 组件白名单
+
+（本愿望允许使用的组件清单：路径 + 用途。**清单外组件一律禁止**；需要新增时须用户拍板后补入。）
+
+| 组件（平台路径） | 用途 | 备注 |
+|---|---|---|
+| | | |
+
+## 4. 共享件清单
+
+（跨页面共用的组件/工具函数：谁建（anchor 片）、放哪个路径、签名。实现片只许用，不许另建。）
+
+| 共享件 | 路径 | 签名/Props | 由 anchor 片建 |
+|---|---|---|---|
+| | | | |
+
+## 5. 状态与响应式
+
+- 状态样式规范：空 / 加载 / 错误 / 权限 / 数据补齐中——每态长什么样、复用哪个既有组件（如 ui/skeleton、既有 EmptyState）。
+- 响应式断点：各断点（≥1280 / 1280~1440 / 1440+ / 窄分栏）的布局规则；禁止固定像素宽度硬编码。
+
+## 6. 需求覆盖矩阵（设计承诺）
+
+| 需求编号（N） | 存量编号（O） | 设计落点（哪页哪块） |
+|---|---|---|
+| | | |
+
+> quote 版本：vN（本规范单承诺的是该版本原话；quote 更新后本单标 stale，须与需求清单一起重对齐。）
+
+## 7. 备选方案（Alternatives considered）
+
+> 每个关键设计决策（切分方案、组件取舍、对标对象、交互形态）列出**被否方案与理由**；被否方案是「下次翻案必须击败它」的证据。没有备选说明的决策会被重审。
+
+| 决策点 | 采用方案 | 被否方案 | 被否理由（具体，不说"不合适"） |
+|---|---|---|---|
+| | | | |

package/presets/code-vibe/skills/wish-programming/references/templates/module-readme.md

@@ -0,0 +1,37 @@
+# module-readme — 模块 README 规范（提案与决策索引，非「单一真源」）
+
+> 位置：`docs/product/modules/<x>/README.md`。定位：该模块的**提案与决策索引**——承载定位、提案状态、决策索引、开放问题。
+> 诚实规则：README 之间出现矛盾时，**必须把矛盾显式登记为开放问题或 GAP**，不掩盖、不自行调和。
+> 时效标注：复用仓库现状——frontmatter `status:`（active / superseded）+ 提案/未立项/done 状态词 + `updated:`，不另设标注体系。
+
+```markdown
+---
+status: active
+updated: YYYY-MM-DD
+---
+
+# <模块名> · 提案与决策索引
+
+## 1. 定位（一段话）
+- 是什么 / 服务谁 / 边界（不属于本模块的显式列出）
+
+## 2. 提案状态
+- 状态：提案（未立项）/ 已立项 / 已废弃（废弃原因指向替代方案）
+- 立项来源：<决策会话/ADR 链接>
+
+## 3. 决策索引（每条：主张 / 反方最强论点 / 裁决 / 出处）
+| # | 决策 | 反方最强论点（原文摘要） | 裁决 | 出处 |
+|---|---|---|---|---|
+| 1 | mcp_api_keys 并入 gateway_api_keys | 实体授权维度不同，不应合并 | 收敛（迁移而非并存） | 09-decisions/NNN |
+
+## 4. 方向与收敛
+- 收敛/退役/迁移路线（T0-T3），引用 roadmap 对应行
+- 与相邻模块的边界
+
+## 5. 开放问题 / 已知矛盾
+- 与 <另一 README> 的矛盾：……（登记 GAP-xxx）
+- 待拍板：……
+
+## 6. 回填指针
+- 相关 specs / ADR / gap 条目 / 用法文档（usage/）链接
+```

package/presets/code-vibe/skills/wish-programming/references/templates/product.md.tpl

@@ -0,0 +1,74 @@
+# <wish 标题> · 产品包（PRD）
+
+> 复制本模板到 `docs/wish/<id>/product.md` 并逐节填写。
+> 完成后必须先过两场评审（pm-reviewer / design-reviewer，均须非作者独立 subagent，
+> 产出 review-pm.md / review-design.md 且结论 pass）才能进入 design-ready。
+> 本文件所有占位 `<...>` 必须替换；无法回答的节必须写明「N/A + 理由」，不得留空。
+
+## 0. 用户原话（逐字转录，不可改写）
+
+> 从 `docs/wish/<id>/quote.md` **原样复制**用户原话正文到这里，一字不改。禁止改写、禁止省略、禁止「概括」。
+
+- 本节是全文最高优先级：任何其他节（§1~§8）与本节约束冲突时，以本节为准。
+- 冲突不得静默裁决：发现冲突时必须回用户确认，由用户拍板，不得自行取舍。
+
+## 0.1 PM 推断与定性词清单
+
+> 原话里未出现的定性词一律视为 PM 推断；未经用户确认，不得成为任何下游承诺（设计与实现）。
+
+| 推断词 | 出现在哪个场景/节 | 确认状态（已获用户确认/待确认） |
+|---|---|---|
+| 例：推倒重画 | §1 模块定位 | 待确认 |
+| …… | …… | …… |
+
+## 1. 模块定位陈述（第一段，必须主动请用户纠偏）
+
+- 这个模块是什么：
+- 服务谁（目标用户/消费方）：
+- 与既有模块的边界（含「不属于本模块」的部分）：
+- 与已立项产品方向/收敛框架的关系：
+- 【动作】把以上四行原样发给用户请求纠偏，用户确认前不得进入设计评审。
+
+## 2. 用户画像（≥2 行：最终人类用户 + 下游消费方双层）
+
+| 画像 | 角色 | Job-to-be-done | 使用时机 | 现状痛点 | 证据来源 |
+|---|---|---|---|---|---|
+| 例：数据分析师 | 人类用户 | 在查询工作台跑 SQL 并导出结果 | 每周取数时 | 点表覆盖 SQL | personas 文档 §x |
+| 例：下游 Agent | 消费方 | 提交查询并轮询结果 | 用户问数时 | 空结果报错 | 产品语义 v1 决策记录 |
+
+> 证据来源不能空：personas 文档 / 埋点 / 历史用户测试产物 / 明确标注 `Unverified（拍脑袋，待验证）`。
+
+## 3. 场景旅程（≥3 条，when/why/what）
+
+1. 场景名：…… / 触发时机（when）：…… / 动机（why）：…… / 关键步骤（what）：……
+2. ……
+3. ……
+
+## 4. 信息架构（UI 类愿望必填；非 UI 写 N/A+理由）
+
+- 导航层级与页面树：
+- 模块归属（每个页面属于哪个域/入口）：
+- 与收敛框架的一致性说明：
+
+## 5. 产品原则清单（≥1 条，逐条映射至少一个设计决策）
+
+| 原则 | 说明 | 映射的设计决策 |
+|---|---|---|
+| 例：用户已有凭证零失效 | 迁移不得使任何旧凭证/外部集成断连 | 采用 key_hash 镜像迁移而非重签发 |
+
+## 6. 语义不变量清单（≥1 条）
+
+- 例：空结果 = 成功（区别于真失败）
+- 例：取消必须最终生效（终态一致）
+- 例：权限拒绝 = 403（非 500）
+
+## 7. 产品决策记录指针
+
+- 本 wish 的用户拍板/纠偏结论逐条登记（后续会话必读，防语义回退）：
+  1. ……
+
+## 8. Out-of-scope（结构化清单）
+
+| 项 | 原因 | 涉及跨面/跨域 |
+|---|---|---|
+| 例：SR 引擎侧探测 | 属于引擎运维面 | 是（SR vs 服务面） |