@xulthekl/team-flow 0.22.4

package/skills/prototype/references/craft/laws-of-ux.md

@@ -0,0 +1,60 @@
+# 构图法则（认知/感知/行为启发式）
+
+> 这些法则决定 **WHAT to compose**——页面放什么、放多少、放在哪；
+> 不决定 **how to render**——颜色、字体、阴影的渲染细节见其余 craft 规则。
+
+## 感知：格式塔
+
+- **接近性**：相关元素靠近、无关元素远离。用间距分组，不靠画框——边框越多页面越噪
+  （见 `anti-ai-slop.md` 七大罪 ⑤ AI 瓷砖）
+- **相似性**：同类元素共享视觉属性（颜色、形状、尺寸），用户学一次即可迁移理解
+- **闭合性**：大脑自动补全不完整图形——无 borders 仅有背景色分隔的卡片依然被读作卡片，
+  不必把每个容器都描出来
+
+## 决策：希克定律
+
+- 决策时间随选项数量对数增长：**每个决策点 ≤3 个选项**
+- 选择过载杀死转化——5 个 CTA 并排 = 用户选择离开
+- 手段：合并同类选项、低频选项收进"更多"、分步渐进呈现（见下方表单绑定）
+
+## 记忆：米勒与考恩
+
+- **米勒 7±2**：导航项 ≤7 个，超出则分组为下拉
+- **考恩 4**：真实工作记忆容量约 4 组块——仪表盘 KPI 分组 ≤4 组，
+  更多则用 tab / 视图切换分层承载
+
+## 动作：费茨定律
+
+- 到达目标的时间 = f(距离 / 尺寸)：**主 CTA 尺寸最大、距用户光标路径最近**
+  （桌面端通常在内容区右下）
+- 破坏性操作（删除、退订）远离主路径，增加操作成本
+- 贴屏边缘的按钮天然易达（光标可甩到边），通栏底部操作可利用此特性
+
+## 行为：冯·雷斯托夫与多尔蒂
+
+- **冯·雷斯托夫（隔离效应）**：每页一个突出元素——即 `../checklist.md` P1.1
+  "一个决断性亮点"。全部强调 = 没有强调
+- **多尔蒂阈值**：系统反馈 <400ms 时交互才有"跟手感"；
+  超过 400ms 必须给加载反馈（见 `state-coverage.md` 加载阈值表）
+
+## 页面类型绑定
+
+| 页面类型 | 主用法则 | 构图含义 |
+|---------|---------|---------|
+| 仪表盘 | 考恩 4 + 费茨 | KPI 分组 ≤4；主操作（新建/导出）最大且最近光标 |
+| 表单 | 希克 + 渐进呈现 | 每步 ≤3 组字段；条件字段按选择展开；主提交按钮大且唯一 |
+| 列表/表格 | 格式塔分组 | 用间距分组、行 hover 高亮；批量操作条仅选中后出现 |
+| 定价/套餐对比 | 冯·雷斯托夫 | 推荐套餐单独高亮（边框 + 徽章 + 放大 CTA），禁止三档同时高亮 |
+| 空态/错误态 | 多尔蒂 + 希克 | 即时反馈；引导动作 ≤2 个 |
+
+## 一句话总结
+
+> 法则决定放什么、放多少；craft 规则决定怎么画。两者缺一：
+> 只有法则 = 正确但平庸；只有渲染 = 精致但无逻辑。
+
+## 关联参考
+
+- `../checklist.md` — P1.1 决断性亮点（冯·雷斯托夫）、P1.5 CTA 说明动作
+- `state-coverage.md` — 多尔蒂阈值与加载阈值表
+- `anti-ai-slop.md` — 80/20 灵魂法则（20% 独特选择往往就是那个冯·雷斯托夫元素）
+- `typography-hierarchy.md` — 间距即层级（格式塔接近性的落地）

package/skills/prototype/references/craft/state-coverage.md

@@ -0,0 +1,81 @@
+# 五状态覆盖契约
+
+> AI 设计最可靠的失败是只画了有数据态。
+
+有数据态（Populated）只是五个状态之一。只演示"happy path"的原型无法验证产品逻辑完整性，
+而真实世界的用户一定会遇到空屏、错误与极端数据。**每个页面、每个关键组件必须覆盖五状态。**
+
+## 五个必备状态
+
+| 状态 | 触发条件 | 必备内容 |
+|------|---------|---------|
+| **Loading 加载中** | 数据请求进行中 | 骨架屏（与真实布局同构）或 spinner；占位保住布局，不跳动 |
+| **Empty 空态** | 数据为零（新用户 / 筛选无结果） | 插画或图标 + 一行解释 + 主行动按钮 |
+| **Error 错误** | 请求失败 / 校验失败 / 无权限 | 发生了什么 + 为什么 + 怎么办 + 重试入口 |
+| **Populated 有数据** | 正常数据 | 真实感业务数据、真实感数量（不是恰好 3 条） |
+| **Edge 极端** | 极限数据 | 超长文本、超大数字、单条记录、满页（分页边界）、特殊字符 |
+
+## 表单专属状态
+
+表单在五状态之外额外覆盖三态：
+
+- **untouched 未触碰**：初始态，无校验提示；主 CTA 禁用或可点按设计系统约定
+- **dirty 已修改**：字段级校验反馈——错误色 + 文字说明，不能只靠颜色（无障碍要求）
+- **submitted-pending 提交中**：按钮 loading 态防重复提交，表单整体只读
+
+## 空状态构成
+
+三要素缺一不可：
+
+1. **插画/图标** — 内联 SVG，风格与页面一致（单色线稿优先，禁止 emoji）
+2. **一行解释** — 说明为何为空："暂无符合条件的工单"，不是"暂无数据"
+3. **主行动** — 引导下一步："创建第一张工单"，而非只有"刷新"
+
+筛选后的空状态必须提供"清除筛选"入口。
+
+## 错误必须回答的三个问题
+
+- **发生了什么**："无法连接服务器"，不是"系统错误"
+- **为什么**（已知时）："网络可能不稳定" / "该字段为必填项"
+- **怎么办**："请重试" / "请检查标红字段"
+
+禁止向用户暴露技术堆栈；须保留错误 ID 供支持引用。
+
+## 重试纪律
+
+- 第 1 次重试：立即（用户手动触发）
+- 自动重试：2s → 4s → 8s 退避
+- 连续 3 次失败：停止自动重试，展示"请联系支持" + 错误 ID
+- 长任务（上传 / 报表生成）须展示进度，不能只有 spinner
+
+## 加载阈值
+
+| 时长 | 策略 |
+|------|------|
+| 0–300ms | 不展示任何加载态（防闪烁） |
+| 300ms–1s | 骨架屏（与真实内容布局同构） |
+| 1s+ | 骨架 + spinner，或转入明确加载态 |
+| 60s+ | 停止等待，转错误态并提供重试 |
+
+## 测试矩阵模板
+
+每页交付前逐格填写，作为原型验收项：
+
+| 页面/组件 | Loading | Empty | Error | Populated | Edge |
+|----------|---------|-------|-------|-----------|------|
+| 订单列表 | ☐ 骨架屏 | ☐ 插画+创建入口 | ☐ 重试+错误ID | ☐ 47 条 | ☐ 标题 50 字 |
+| KPI 仪表盘 | ☐ | ☐ | ☐ | ☐ | ☐ 数字过亿 |
+| 新建表单 | — | — | ☐ 字段级+摘要 | ☐ | ☐ 备注 500 字 |
+
+## ARIA 与状态切换
+
+- 加载容器 `aria-busy="true"`，完成后置 `false`
+- 动态注入的错误信息 `aria-live="polite"`（紧急错误用 `assertive`）
+- 状态切换管理焦点：提交失败后焦点回到第一个错误字段；弹层打开后焦点移入弹层
+- 禁止用 `alert()` 呈现错误
+
+## 关联参考
+
+- `../checklist.md` — P0/P1/P2 质量检查清单
+- `accessibility-baseline.md` — ARIA 纪律与焦点管理细则
+- `laws-of-ux.md` — 多尔蒂阈值（反馈 <400ms）

package/skills/prototype/references/craft/typography-hierarchy.md

@@ -0,0 +1,50 @@
+# 排版层级规则
+
+层级决定三件事：**入口**（用户第一眼落在哪）、**节奏**（信息分块、有呼吸）、**张力**（主次形成视觉动势）。
+
+## 两种失败模式
+
+| 模式 | 症状 | 解法 |
+|------|------|------|
+| 扁平层级 | 所有文字大小接近，页面没有焦点 | 建立三级模型，拉大一级标题 |
+| 噪声层级 | 字号过多互相打架，一页 8 种字号 | 收敛到三级，合并相近级别 |
+
+## 三级工作模型
+
+| 级别 | 承担 | 建议字号 | 字重 |
+|------|------|---------|------|
+| **一级** | h1 / hero 主标题 | 40–56px | 600 |
+| **二级** | h2 / 分区标题 | 28–32px | 600 |
+| **三级** | h3 / 卡片标题 | 18–20px | 600 |
+
+正文 15–16px / 字重 400；辅助文字 13–14px。
+相邻级别字号比 ≥1.25，否则层级不显。
+
+## 细节规则
+
+- **ALL CAPS 必加字距** — 全大写英文标签（eyebrow、tag、按钮）letter-spacing ≥0.06em。
+  这是最可靠的 AI-slop 信号之一：AI 生成的全大写标签几乎从不加字距。
+  中文无大小写之分，此规则仅约束英文标签。
+- **Display 48px+ 负字距** — letter-spacing: -0.02em，大字需要收紧，否则显得松散。
+- **行长 50–75ch** — 正文 `max-width: 65ch`；行过长回扫困难；卡片内说明可更短（45ch）。
+- **三字重系统** — 400（正文）/ 550（强调，字体缺失时回退 500）/ 600（标题）。
+  不用 300（过细，B 端屏幕可读性差）与 700+（过重，噪声层级）。
+- **禁止两端对齐** — `text-align: justify` 在中英混排中产生大词隙（河流效应），统一 `left`。
+- **标题字体用 `var(--font-display)`** — 见 `../checklist.md` P0.2。
+
+## 间距即层级
+
+间距比字号更能建立层级：
+
+- **区块间距**（section 之间）：64–96px
+- **元素间距**（区块内卡片/表单组之间）：16–24px
+- **行内间距**（label 与 input、图标与文字之间）：4–8px
+
+间距层级必须与信息层级一致：**区块 > 元素 > 行内**。
+分不清段落边界时，问题往往不在字号，而在间距——见 `laws-of-ux.md` 格式塔接近性。
+
+## 关联参考
+
+- `../checklist.md` — P0.2 标题字体、P1.3 标题词数、P1.4 lead 宽度
+- `anti-ai-slop.md` — 衬线误用（七大罪 ④）
+- `laws-of-ux.md` — 格式塔接近性（间距即分组）

package/skills/prototype/references/layouts.md

@@ -0,0 +1,223 @@
+# Layouts（B 端 section 骨架库 · v0.18.0）
+
+> 把 section 直接落入 `template.html` 的 `<main id="content">`。**不要从零写 section**——
+> 选最接近的 layout，整段粘贴，再换文案。所有片段只用下方「class 契约」里列出的类，
+> 结构元素一律带 `data-testid`（页面级 `P-{xx}-{slug}` / 场景级 `S-{nn}-{slug}`）。
+> B 端导向：管理后台 / 表单 / 仪表盘 / 文档索引，而非 C 端营销落地页。
+
+## Class 契约（inventory · 与 template.html 的 `<style>` 一一对应）
+
+| 分组 | 类名 |
+|------|------|
+| 布局原语 | `section` `container` `stack` `row` `row-between` `rule` `grid-2` `grid-3` `grid-4` `grid-2-1` `grid-1-2` |
+| 文字辅助 | `eyebrow` `lead` `num` `meta` |
+| Hero | `hero` `hero-center` `hero-split` `hero-cta` |
+| 按钮 | `btn` `btn-primary` `btn-secondary` `btn-ghost` |
+| 卡片/特性/数据 | `card` `card-flat` `feature` `feature-mark` `stat` `stat-num` `stat-label` |
+| 引言 | `quote` `quote-mark` `quote-author` `pull` |
+| 徽标 | `pill` `tag` |
+| 表单 | `field` `input` `textarea` |
+| 表格 | `ds-table` `num-col` |
+| 占位/日志 | `ph-img` `log-row` |
+| 页面框架 | `topnav` `pagefoot` |
+
+**硬规则**：如果你想用一个不在这张表里的 class，**先在 `<style>` 里把它定义出来**。
+绝不允许凭空发明一个没有 CSS 支撑的全局类。宁可定义，不可漂移。
+
+---
+
+## 1. hero（居中）
+
+**use-when**：页面开场，一句话主张 + 两个动作。概览页 / 文档索引页首选。
+
+```html
+<section class="hero section" data-testid="P-01-hero">
+  <div class="container hero-center">
+    <p class="eyebrow">模块名 · 分组</p>
+    <h1>一句话主张，不超过 14 个字</h1>
+    <p class="lead">一句补充说明，点出对使用者的价值，不堆砌形容词。</p>
+    <div class="hero-cta">
+      <a class="btn btn-primary" href="#">主操作</a>
+      <a class="btn btn-secondary" href="#">次要操作</a>
+    </div>
+  </div>
+</section>
+```
+
+**纪律**：h1 ≤14 字；eyebrow 用作面包屑式分组；CTA 最多两个，主次分明。
+
+## 2. hero-split（左文右图）
+
+**use-when**：需要展示界面截图 / 示意图的开场。左文案，右 16:9 占位图。
+
+```html
+<section class="hero section" data-testid="P-02-hero-split">
+  <div class="container hero-split">
+    <div class="stack">
+      <p class="eyebrow">能力分组</p>
+      <h1>左栏主张，简短有力</h1>
+      <p class="lead">右栏放界面截图或流程示意，文图各占一半。</p>
+      <div class="hero-cta">
+        <a class="btn btn-primary" href="#">进入</a>
+        <a class="btn btn-ghost" href="#">了解文档</a>
+      </div>
+    </div>
+    <div class="ph-img" data-testid="P-02-shot">界面截图占位 16:9</div>
+  </div>
+</section>
+```
+
+**纪律**：图用 `ph-img`（16:9）占位；不要把营销插画放进 B 端后台。
+
+## 3. features（三联特性）
+
+**use-when**：并列说明 3 项能力 / 字段 / 入口。
+
+```html
+<section class="section" data-testid="P-03-features">
+  <div class="container grid-3">
+    <div class="feature">
+      <div class="feature-mark" aria-hidden="true">
+        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round"><path d="M4 6h16M4 12h16M4 18h10"/></svg>
+      </div>
+      <h3>特性一</h3>
+      <p>一句话说明这项能力解决什么。</p>
+    </div>
+    <div class="feature">
+      <div class="feature-mark" aria-hidden="true">
+        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="8"/><path d="M12 8v4l3 2"/></svg>
+      </div>
+      <h3>特性二</h3>
+      <p>一句话说明这项能力解决什么。</p>
+    </div>
+    <div class="feature">
+      <div class="feature-mark" aria-hidden="true">
+        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round"><path d="M5 13l4 4L19 7"/></svg>
+      </div>
+      <h3>特性三</h3>
+      <p>一句话说明这项能力解决什么。</p>
+    </div>
+  </div>
+</section>
+```
+
+**纪律**：图标统一单线 SVG（`stroke-width="1.6"`、`stroke="currentColor"`）。
+**不要给每个标题都配图标**——三个一行可以，满屏图标即噪声。
+
+## 4. stats（数据行）
+
+**use-when**：用真实数字建立信任 / 概览。**只用真实数字，不臆造指标。**
+
+```html
+<section class="section" data-testid="P-04-stats">
+  <div class="container grid-3">
+    <div class="stat"><span class="stat-num num">1,284</span><span class="stat-label">本月处理工单</span></div>
+    <div class="stat"><span class="stat-num num">99.2%</span><span class="stat-label">SLA 达成率</span></div>
+    <div class="stat"><span class="stat-num num">3.4h</span><span class="stat-label">平均响应时长</span></div>
+  </div>
+</section>
+```
+
+**纪律**：数字用 `num`（等宽 tabular-nums）；一行 ≤3 个；**不要编造指标**——没有真实来源就不放 stats。
+
+## 5. quote（引言）
+
+**use-when**：一句用户 / 业务方背书，调节节奏。**一页一条，绝不连放两条。**
+
+```html
+<section class="section" data-testid="P-05-quote">
+  <div class="container">
+    <figure class="quote" style="margin:0">
+      <div class="quote-mark" aria-hidden="true">&ldquo;</div>
+      <p>这套流程把跨部门对齐从两天压到了半小时。</p>
+      <figcaption class="quote-author">—— 某业务负责人</figcaption>
+    </figure>
+  </div>
+</section>
+```
+
+**纪律**：每页最多一条；不要 quote 紧跟 quote；用真实归属，不写假名人名言。
+
+## 6. cta-strip（行动召唤条）
+
+**use-when**：页面收口，一个决定性动作。留白要足。
+
+```html
+<section class="section" data-testid="P-06-cta">
+  <div class="container hero-center">
+    <h2>准备好开始了吗</h2>
+    <p class="lead">一个决定性诉求，一句话讲清下一步。</p>
+    <div class="hero-cta">
+      <a class="btn btn-primary" href="#">立即开始</a>
+    </div>
+  </div>
+</section>
+```
+
+**纪律**：只放一个主按钮；上下留白用 `--section-pad`，别挤。
+
+## 7. log（列表 / 变更记录）
+
+**use-when**：变更记录 / 操作流水 / 文档条目列表。日期 + 内容，**边框只在上方，不围一圈。**
+
+```html
+<section class="section" data-testid="P-07-log">
+  <div class="container stack">
+    <h2>变更记录</h2>
+    <div>
+      <div class="log-row"><span class="num">2026-07-25</span><span class="body">上线工单批量导出。<span class="tag">feature</span></span></div>
+      <div class="log-row"><span class="num">2026-07-18</span><span class="body">修复 SLA 统计口径偏差。<span class="tag">fix</span></span></div>
+      <div class="log-row"><span class="num">2026-07-10</span><span class="body">新增仪表盘暗色主题。<span class="tag">feature</span></span></div>
+    </div>
+  </div>
+</section>
+```
+
+**纪律**：日期用 `num`；状态用 `tag`；行间分隔靠 `log-row` 的 top border，**不要给整列加外框**。
+
+## 8. pricing（对比表）
+
+**use-when**：套餐 / 规格 / 字段对比。细边框、等宽数字、高亮一列。
+
+```html
+<section class="section" data-testid="P-08-pricing">
+  <div class="container">
+    <table class="ds-table">
+      <thead>
+        <tr><th>规格</th><th class="num-col">席位</th><th class="num-col">存储</th><th>支持</th></tr>
+      </thead>
+      <tbody>
+        <tr><td>团队版 <span class="pill">推荐</span></td><td class="num-col">50</td><td class="num-col">200GB</td><td>工作日</td></tr>
+        <tr><td>企业版</td><td class="num-col">不限</td><td class="num-col">2TB</td><td>7×24</td></tr>
+      </tbody>
+    </table>
+  </div>
+</section>
+```
+
+**纪律**：边框走 hairline（`ds-table` 已定义）；数字列右对齐 + `num-col`；**只高亮一列**（用 `pill` 标注推荐项）。
+
+---
+
+## 页面类型节奏表（B 端）
+
+| 页面类型 | section 节奏（自上而下） |
+|----------|--------------------------|
+| 管理后台列表页 | `hero-center` → `log`/列表（`ds-table`） → `stats` 汇总 |
+| 表单页 | `hero-center` → 表单分组（`field`/`input`/`textarea`） → `cta-strip` |
+| 仪表盘 | `stats` → `grid-2-1` 图表区 → `log` 最近动态 |
+| Landing / 概览 | `hero` → `features` → `stats`/`quote` → `cta-strip` |
+| 文档索引 | `hero-center` → `log` 条目列表 → `cta-strip` |
+
+## 抗疲劳规则（anti-fatigue）
+
+**两个 stats 行连放、两个 features 三联连放——都会造成视觉疲劳。必须交替。**
+节奏靠「数据 → 文字 → 列表 → 图」的强弱交替来维持；连续同型 section 是默认错误。
+
+## 起飞前检查清单（pre-flight）
+
+- [ ] 通读 `template.html` 直到 `</style>`，确认要用的类都已在契约里。
+- [ ] **先定 section 清单，再写文案**（结构先于文字）。
+- [ ] 每屏单一 accent，使用处 ≤2（主按钮 + 一处强调，够了）。
+- [ ] 所有结构元素带 `data-testid`；只引用契约内的类，缺类先定义再用。
+- [ ] stats 全为真实数字；quote 每页一条；同型 section 不连放。

package/skills/prototype/references/orchestration-flow.md

@@ -0,0 +1,101 @@
+# Prototype 内部编排流程（v0.15.0，v0.18.0 工艺升级）
+
+> 本 skill 主代理只编排不实施。所有非交互步骤（探查/绘制/评审/设计系统产出）派子代理，遵循 §18.1 subagent 结构化交接协议（status/deliverable/blockers/outstanding_questions/summary）。人工评审/路由由主代理用阻塞问题工具执行（subagent 不能 AskUserQuestion）。
+
+## 子代理决策点中继（v0.21.0，§22.1.1 stop-and-resume）
+
+子代理（scout / builder）**没有 AskUserQuestion**。当其在决策点经 `SendMessage(to: "main")` 发来结构化提问请求（`<agent-message>` 含 `{ question, why, options[] }`）并停止时，主代理**负责中继**：
+
+1. **收通知识别**：经 `task-notification` 收到子代理提问请求（**不要用 TaskOutput 轮询**，对齐 §22.2 等待范式）。识别其为「中继请求」而非终态交接（子代理末条消息会明示「已发问、等待回传」）。
+2. **代问用户**：用 `AskUserQuestion` 把问题转给 LT（包装措辞、给选项）；属主代理权限内的技术决策可自行拍板。并行多子代理提问可**合并为一个多问弹窗**一次问完。
+3. **回传即唤醒**：拿到答案后 `SendMessage(to: <agentId>)` 回传——该调用**自动 resume 已停止的子代理**带答案续跑。
+
+**请求-应答匹配纪律（实证暴露的真风险，必守）**：
+- 维护每子代理的「未决提问请求」台账，**仅回传子代理实际提出过的提问**；**不要自发追加问题**再把答案错配回传（实录中主代理曾把无主答案回传给未发追问的子代理，被子代理按「正确优先」拒绝）。
+- 回传时附上下文（「这是你关于 X 提问的回答：Y」），便于子代理校验对应性。
+- harness 不支持 resume 时，降级为读子代理 `blocked` 返回 + 携答案**重新派发**。
+
+## 步骤 ① 环境探查 + 方案设计（子代理）
+
+派发插件 agent `prototype-env-scout`（只读，tools 硬限 Read/Bash/Grep/Glob），传入：PRD 路径、config 的 `prototype.designSystem`/`prototype.entry`、当前 git 分支。简报写在 response，主代理按需落盘。
+
+子代理探查并产出环境简报：
+- **设计系统现状**：`design-system.md` 是否存在？9 段 schema 完整度？缺失哪些段？
+- **原型仓库分支**：当前分支、是否已有 `prototype/`、与 PRD 版本分支是否对齐
+- **PRD 版本**：`iteration_version`、冻结状态、UI 功能点清单（§4/§7）
+- **已有页面**：现有 prototype/ 页面/组件清单（迭代时）
+- **原型方案设计建议**：页面结构、组件复用、导航 flow 草案
+- **差异化方向（v0.18.0）**：产出 2-3 个差异化方向（布局策略 / 视觉侧重 / 风险权衡），附推荐方向 + 理由
+
+子代理按 §18.1 返回。若发现 `.team-flow/design-system/` 缺失 → 在 `outstanding_questions`/`blockers` 标注，主代理转入设计系统创建（见下）。
+
+## 步骤 ①b 设计系统创建（条件，调用独立 skill，v0.19.0）
+
+环境简报显示设计系统缺失/不完整时：
+1. 主代理调用 `/team-flow:design-system` skill（独立入口，用户主导交互创建）。
+2. design-system skill 内部执行：需求收集（≤5 个预填推荐问题）→ 确定性 token 派生 → 草稿生成（base.md + 变体）→ 预览生成（preview.html）→ 用户评审确认 → 落盘 `.team-flow/design-system/` + guard 校验。
+3. 创建完成后回 ① 补齐环境简报。
+
+> **v0.19.0 变更**：①b 从"内部派 design-system-architect 种子代理"升级为"调用独立 design-system skill"。architect 迁移为 design-system skill 的内部执行引擎。存储从 `prototype/design-system.md` 迁移到 `.team-flow/design-system/`（base.md + 变体）。
+
+## 步骤 ② 方案评审 + 人工评审（主代理）
+
+主代理评审 ① 的环境简报 + 原型方案设计，然后用 AskUserQuestion 与 LT 确认：
+- **方向选定（v0.18.0）**：呈现 2-3 个差异化方向对比，LT 选定一个锁定
+- 原型方案（页面结构/导航）是否认可
+- 设计系统/分支/版本是否明确
+- 是否进入绘制
+
+LT 确认后进入 ③。**confirmed_plan 序列化**：将 scout 简报的选定方向（布局策略/视觉侧重）+「Prototype Plan」段（页面清单/组件清单/导航流）+ 人工确认结论（含明确的设计系统路径/分支/版本）拼为 `confirmed_plan`，作为 ③ prototype-builder 的入参。
+
+## 步骤 ③ 原型绘制（子代理）
+
+派发插件 agent `prototype-builder`（有 Write），传入：已确认的原型方案（含选定方向）、`design-system.md` 路径、目标分支/版本、PRD 路径。
+
+**prompt 组装顺序契约（v0.18.0）**：`design-system.md → references/template.html → references/layouts.md → references/checklist.md → references/craft/（按页面类型选择注入）→ PRD`。craft 注入策略：仪表盘→laws-of-ux+state-coverage；表单→state-coverage+accessibility-baseline；列表→typography-hierarchy；通用→anti-ai-slop（始终注入）。
+
+prototype-builder **从种子模板组合**（template.html + layouts.md 骨架），先报 section 列表，再填充真实文案，P0/P1/P2 自检后提交。零外部依赖、复用设计系统 token、禁止内联样式漂移。按 §18.1 返回 deliverable = prototype/ 入口绝对路径。
+
+**主代理严禁在此步直接 Write/Edit 原型文件。**
+
+**交接后产物校验（v0.20.0，defense in depth，设计 §22.1）**：收到 builder 交接、**派 reviewer 之前**，主代理**不信 `status=done` 字面值**，先机械校验入口产物真实落盘：
+
+```bash
+test -f <prototype_path>/index.html && test -s <prototype_path>/index.html && echo OK
+```
+
+- `OK` → 进入 ④ 评审。
+- 缺失/为空（builder 谎报 done 或中途耗尽预算）→ **不派 reviewer（避免对空目录空转评审）**，`SendMessage` resume builder 续写（指出缺失文件），或按 builder 返回的 `blockers` 裁决。
+- 此校验与 builder 的 Deliverable Hard Gate 互为冗余：即便个别 agent 未守闸门谎报 done，编排层仍在此截断缺陷向下游传导。
+
+## 步骤 ④ 原型评审（子代理）
+
+派发插件 agent `prototype-reviewer`（只读，独立上下文），**传入：`prd_path`、`prototype_path`（及当前轮次 N）**，执行：
+- PRD 6 维度（D1-D6，D6 含五状态契约）
+- **P0 工艺机械检查（v0.18.0）**：裸 hex / 靛蓝黑名单 / emoji / 填充文案 / scrollIntoView / data-testid / accent 超限——P0 违规 = Critical
+- **Craft Quality 4 席 rubric（v0.18.0）**：工艺(×0.4)+品牌(×0.2)+无障碍(×0.2)+文案(×0.2) 加权合成
+
+报告写 response，主代理落盘到 `prd/vN/prototype-auto-review.md`。
+
+判定（v0.18.0 升级）：
+- **PASS**：Critical=0 且 Important=0 且 craft 合成 ≥6.0
+- **PASS_WITH_WARNINGS**：Critical=0 且（Important>0 或 craft 合成 <6.0），无未清 must-fix
+- **FAIL**：Critical>0（含 P0 违规）或有未清 must-fix
+
+## 步骤 ⑤ 循环编排（主代理）
+
+- FAIL → 主代理把不一致项交给 prototype-builder 修正（回 ③），重新 ④ 评审，**≤3 轮**。
+- **收敛检测**：连续两轮不一致项集合无缩小（修正无效/误报死循环）→ 立即转人工，不等满 3 轮。
+- PASS / PASS_WITH_WARNINGS → 进入 ⑥。
+
+## 步骤 ⑥ 人工评审路由（主代理）
+
+主代理用 AskUserQuestion 呈现评审结论 + 争议项，LT 选择：
+- **PRD 有问题** → 回 orchestrator S2 修订 PRD（**vN 内修订 + 变更履历，非升版**；见 feedback-loops 设计）→ PRD 更新后再回 ① 更新原型。**独立调用 fallback**（非 orchestrator 触发时）：无 S2 可回，直接提示 LT 修订 `prd/vN/prd.md` 后重入本 skill。
+- **原型需调整**（美观/体验/品牌/信息密度等自动评审查不到的维度）→ 回 ③ 派 prototype-builder 实施调整
+- **通过** → 冻结：PRD frontmatter `frozen: true`（frozen_downstream），prototype 定版
+
+## 子代理阻断处理（§18.1）
+
+- 子代理返回 `done_with_questions` → 主代理批量确认 `outstanding_questions`（可合并为一次 AskUserQuestion）。
+- 子代理返回 `blocked` → 主代理裁决 `blockers[]` 后续跑/重启该子代理（如设计系统缺失、PRD 未冻结等阻断）。

package/skills/prototype/references/prototype-scaffold/assets/design-tokens.css

@@ -0,0 +1,19 @@
+:root{
+  /* A1-identity：由 design-system.md 渲染覆盖，此处为骨架占位 */
+  --color-primary: #c96442;   /* 占位，渲染时替换为品牌主色 */
+  --color-neutral-900: #1a1916;
+  --bg: #fafaf7; --surface: #ffffff; --fg: #1a1916; --muted: #6b6964; --border: #e8e5df;
+  --accent: #c96442;
+  --font-display: 'Iowan Old Style', Charter, Georgia, serif;
+  --font-body: -apple-system, 'Segoe UI', system-ui, sans-serif;
+  /* A2-derived：由 color-mix 公式派生 */
+  --accent-hover: color-mix(in oklab, var(--accent), black 8%);
+  --accent-active: color-mix(in oklab, var(--accent), black 14%);
+  /* B-slot 别名层 */
+  --fg-2: var(--fg); --meta: var(--muted); --border-soft: var(--border);
+  /* structure */
+  --space-1: 4px; --space-2: 8px; --space-3: 12px; --space-4: 16px;
+  --radius-1: 4px; --radius-2: 8px;
+  --font-base: 16px;
+  /* 由 design-system.md 渲染；修改走 design-system，不在此硬编码新值 */
+}

package/skills/prototype/references/prototype-scaffold/components/button.html

@@ -0,0 +1,3 @@
+<button class="btn btn--primary">Primary</button>
+<button class="btn btn--ghost">Ghost</button>
+<!-- 样式来自 assets/design-tokens.css + design-system components 规范 -->

package/skills/prototype/references/prototype-scaffold/design-system.md

@@ -0,0 +1,7 @@
+# Design System（已迁移到 .team-flow/design-system/，v0.19.0）
+
+> **v0.19.0 变更**：设计系统存储位置从 `prototype/design-system.md` 迁移到 `.team-flow/design-system/`（base.md + 变体文件）。
+> 请使用 `/team-flow:design-system` skill 创建和管理设计系统。
+> 本文件仅作迁移提示占位，不再作为 token 真相源。
+>
+> 新位置：`.team-flow/design-system/base.md`（品牌共享层）+ `b-end.md` / `c-end.md`（端变体）

package/skills/prototype/references/prototype-scaffold/flow.md

@@ -0,0 +1,11 @@
+# User Flow
+
+> 页面跳转与用户流说明；随 PRD 版本演进。
+
+## 首页 → 列表
+- 触发：点击导航"列表"
+- 目标页：pages/list.html
+
+## 列表 → 详情
+- 触发：点击列表项
+- 目标页：pages/detail.html

package/skills/prototype/references/prototype-scaffold/index.html

@@ -0,0 +1,20 @@
+<!DOCTYPE html>
+<html lang="zh">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Prototype · {project}</title>
+  <link rel="stylesheet" href="assets/design-tokens.css">
+  <style>/* 页面级仅做布局骨架；组件样式走 design-system tokens */</style>
+</head>
+<body>
+  <nav id="nav"><!-- 全局导航：链接各页面 --></nav>
+  <main id="app"><!-- 页面内容容器 --></main>
+  <!-- Tweaks 控件：替代云端工具栏，纯本地 -->
+  <div id="tweaks">
+    <label>主题 <select id="theme"><option>light</option><option>dark</option></select></label>
+    <label>密度 <input type="range" id="density" min="0" max="2" value="1"></label>
+  </div>
+  <script>/* 页面内交互，无远程依赖。tweaks 控件用原生 JS + localStorage */</script>
+</body>
+</html>

package/skills/prototype/references/prototype-scaffold/pages/index.html

@@ -0,0 +1,11 @@
+<!DOCTYPE html>
+<html lang="zh">
+<head>
+  <meta charset="UTF-8">
+  <link rel="stylesheet" href="../assets/design-tokens.css">
+</head>
+<body>
+  <h1>首页</h1>
+  <!-- 示例页面；多页面时在 pages/ 增加 list.html / detail.html 等 -->
+</body>
+</html>