@captain_z/zsk-skills 1.2.0 → 1.3.0

package/README.md

@@ -1,19 +1,19 @@
 # @captain_z/zsk-skills
 
-ZNorth Standard Kit 的内容包：**47 颗原子 skill**，按领域分簇组织，通过 `npx @captain_z/zsk add` 可安装到 Claude / Codex / Gemini 等多 harness。
+ZNorth Standard Kit 的内容包：**51 颗原子 skill**，按领域分簇组织，通过 `npx @captain_z/zsk add` 可安装到 Claude / Codex / Gemini 等多 harness。
 
 ## 合规审查（ARCHITECTURE §4.4 硬指标）
 
 | 检查项                                                                                   | 结果    | 说明                                                  |
 | ---------------------------------------------------------------------------------------- | ------- | ----------------------------------------------------- |
-| frontmatter 完整（`name` / `description` / `category` / `domain` / `tier` / `triggers`） | ✓ 47/47 | 结构化 lint 通过                                      |
-| `name` 以 `zsk:` 前缀，扁平 slug                                                         | ✓ 47/47 | 命名空间统一                                          |
-| `description` 使用直接陈述风格，触发词放入 `triggers`                                   | ✓ 47/47 | 触发语义由 description + triggers 共同承担            |
-| `category` / `domain` / `tier` 枚举值合法                                                | ✓ 47/47 | stage/workflow/standard/resource/meta · core/optional |
-| `triggers` 数组非空                                                                      | ✓ 47/47 | 每颗至少 4 个关键词                                   |
+| frontmatter 完整（`name` / `description` / `category` / `domain` / `tier` / `triggers`） | ✓ 51/51 | 结构化 lint 通过                                      |
+| `name` 以 `zsk:` 前缀，扁平 slug                                                         | ✓ 51/51 | 命名空间统一                                          |
+| `description` 使用直接陈述风格，触发词放入 `triggers`                                   | ✓ 51/51 | 触发语义由 description + triggers 共同承担            |
+| `category` / `domain` / `tier` 枚举值合法                                                | ✓ 51/51 | stage/workflow/standard/resource/meta · core/optional |
+| `triggers` 数组非空                                                                      | ✓ 51/51 | 每颗至少 4 个关键词                                   |
 | 无硬编码项目名 / 技术栈（统一 `{{config.*}}` 占位符）                                    | ✓       | harness-neutral                                       |
 | `related:` 相对路径合法（build 已重写）                                                  | ✓       | 无孤儿引用                                            |
-| 单文件 ≤ 300 行                                                                          | ✓ 47/47 | `lint-frontmatter` 作为 error 强制                    |
+| 单文件 ≤ 300 行                                                                          | ✓ 51/51 | `lint-frontmatter` 作为 error 强制                    |
 
 当前 `max-lines` 已由 `tools/lint-frontmatter.ts` 作为 error 强制；新增或修改 skill 不应超过 300 行。
 
@@ -32,6 +32,14 @@ zsk skill 是 LLM **按需自动触发**的资产：
 - `~/.codex/skills/<domain>/<slug>/SKILL.md` — Codex
 - `@captain_z/zsk-skills/<domain>/<slug>/SKILL.md` — 通过 npm 读
 
+## 和项目知识工作区的关系
+
+`zsk init` 生成的 `SYSTEM-SPEC.md`、`zsk.config.yaml`、`.raws/`、`docs/` 和 `.issues/` 是这些 skills 的默认项目上下文。CLI 负责创建模板、维护 schema、刷新 `.raws/manifest.json`，并通过 `zsk config check` / `zsk check` 做确定性校验。
+
+Skills 负责更需要判断的部分：理解 SRS、API 契约、Figma/MCP 快照和测试资产，发现模块边界，做跨事实源冲突分析，使用 Computer Use / Browser Use 验证运行时行为，并把问题写入 `.issues/{module}/`。原始测试用例放在 `.raws/testing/`，模块用 `docs/{module}/module.yaml` 映射 raw cases、derived cases、automated tests 和 TDD 要求。
+
+每个阶段都要把确认过的决策、约束、例外和验证结果写回持久文件。缺少 Documentation Feedback 时，`zsk check` 可以把它作为阶段未收口的证据。
+
 ## 领域总览
 
 | 领域              | skill 数 | 职责                                       |
@@ -39,21 +47,21 @@ zsk skill 是 LLM **按需自动触发**的资产：
 | `sdlc/`           | 18       | 7 阶段 SDLC + 3 变更工作流 + task 执行框架 |
 | `frontend/`       | 16       | React + Web 层实现规范                     |
 | `quality/`        | 5        | 跨栈质量原则                               |
-| `design-handoff/` | 2        | 设计交付方法论                             |
-| `system/`         | 5        | 工程宪法级资源                             |
+| `design-handoff/` | 5        | 设计交付方法论                             |
+| `system/`         | 6        | 工程宪法级资源                             |
 | `meta/`           | 1        | 元信息                                     |
-| **总计**          | **47**   |                                            |
+| **总计**          | **51**   |                                            |
 
 ## 安装套件（bundles.yaml）
 
 | name                           | skills | 场景                                          |
 | ------------------------------ | ------ | --------------------------------------------- |
-| `sdlc-only`                    | 10     | 纯流程骨架（7 阶段 + 3 工作流），不涉及技术栈 |
-| `frontend-project`（推荐）     | 29     | SDLC 10 + Frontend 16 + Quality 3             |
-| `frontend-with-design-handoff` | 31     | frontend-project + Figma 交付 2               |
+| `sdlc-only`                    | 11     | 纯流程骨架（7 阶段 + 3 工作流 + Agent 编排），不涉及技术栈 |
+| `frontend-project`（推荐）     | 30     | SDLC 10 + Agent 编排 + Frontend 16 + Quality 3 |
+| `frontend-with-design-handoff` | 35     | frontend-project + 设计交付 5                  |
 | `custom`                       | 交互   | 通过 `zsk add` 任意多选                       |
 
-<!-- Auto-generated by tools/catalog.ts — do not edit manually. Total: 47 skills -->
+<!-- Auto-generated by tools/catalog.ts — do not edit manually. Total: 51 skills -->
 
 ## Skill 清单（按领域）
 
@@ -74,8 +82,8 @@ zsk skill 是 LLM **按需自动触发**的资产：
   触发：`technical design` · `solution design` · `architecture decision` · `current state scan`
 
 - **`zsk:coding`** *[stage 4 · stage · core]*
-  Implementation execution after design freeze — smallest viable change, task-by-task delivery, test-first where risk is high, continuous evidence capture, and local quality gates before review. Stage 4 of the 7-stage SDLC.
-  触发：`implementing design` · `task by task delivery` · `local quality gates` · `smallest viable change`
+  Implementation execution after design freeze — smallest viable change, auditable delivery batches, explicit TDD rules by change type, continuous evidence capture, and local quality gates before review. Stage 4 of the 7-stage SDLC.
+  触发：`implementing design` · `auditable delivery batches` · `local quality gates` · `smallest viable change`
 
 - **`zsk:reviewing`** *[stage 5 · stage · core]*
   PR 代码审查与 AI 多维审查核心规范。包含 Scope 偏移检测、多视角 Sub-Agent 审查、测试执行流分析、代码整洁/重构纪律、置信度校准以及按严重性排序的判定协议。
@@ -114,7 +122,7 @@ zsk skill 是 LLM **按需自动触发**的资产：
   触发：`task granularity` · `task estimation` · `T-shirt sizing` · `story points`
 
 - **`zsk:task-tracking`** *[core]*
-  Task execution tracking — dependencies (Mermaid graph), blockers (dated log with severity H/M/L and escalation rules), milestones (stage exits with committed dates), and task state transitions (TODO → DOING → DONE, with BLOCKED requiring log entry).
+  Task execution tracking — dependencies (Mermaid graph), blockers (dated log with severity H/M/L and escalation rules), milestones, auditable LLM execution batches, and task state transitions (TODO → DOING → DONE, with BLOCKED requiring log entry).
   触发：`task dependency graph` · `blocker log` · `milestones` · `task state flow`
 
 - **`zsk:bugfix`** *[workflow · core]*
@@ -130,8 +138,8 @@ zsk skill 是 LLM **按需自动触发**的资产：
   触发：`refactor workflow` · `Fowler refactoring` · `characterization test` · `Parallel Change`
 
 - **`zsk:standard-dev-flow`** *[workflow · core]*
-  交互式标准开发工作流，包含 9 个核心节点（Prepare, Proposal, Spec, Design, Task, Coding, Review, Verify, Commit）。通过强门禁和 Sub-Agent 审查机制，保障高质量的开发落地。
-  触发：`standard dev flow` · `start a new feature workflow` · `execute enterprise workflow` · `9 node development`
+  交互式标准开发工作流，包含 Prepare 预检 + 7 阶段 SDLC（Proposal, Spec, Design, Coding, Reviewing, Verify, Archive）。通过强门禁、可审计批次和多视角审查，保障高质量开发落地。
+  触发：`standard dev flow` · `start a new feature workflow` · `execute enterprise workflow` · `7 stage development`
 
 ### `frontend/` — Frontend · React + Web 层实现规范 (16)
 
@@ -221,7 +229,7 @@ zsk skill 是 LLM **按需自动触发**的资产：
   Cross-language test strategy & discipline — test pyramid ratio (unit 70 / integration 20 / e2e 10), AAA/GWT structure, coverage targets, and the three hard principles (evidence before assertion, Red-Green-Refactor, bug confidence questioning). Stack-specific tooling (Jest/RTL/MSW/Playwright) is in frontend/testing-web.md.
   触发：`test pyramid` · `TDD discipline` · `test coverage target` · `AAA GWT structure`
 
-### `design-handoff/` — Design Handoff · 设计交付方法论 (2)
+### `design-handoff/` — Design Handoff · 设计交付方法论 (5)
 
 - **`zsk:figma-to-code`** *[optional]*
   Figma design node → production code via MCP — 7-step workflow (locate → extract structure → extract annotations → naming conversion → layout decoding → states → tokens), plus the 4-dimension "100% fidelity" verification (visual / interaction / semantic / responsive). Styling specifics live in zsk:styling-system.
@@ -231,12 +239,28 @@ zsk skill 是 LLM **按需自动触发**的资产：
   Design Source capture & MCP readout for modules with Figma/design input — Design Source (URL/node-id), MCP readout status, module-specific UE deviations from system baselines, and implementation mapping. Produces docs/{module}/ue-mcp.md + structured description.md snapshot in design-assets. Only records deviations, not duplicated baseline rules.
   触发：`UE MCP context` · `figma snapshot` · `design source reference` · `module UE deviation`
 
-### `system/` — System · 工程宪法级资源 (5)
+- **`zsk:ux-wireframe`** *[optional]*
+  UX wireframe workflow before high-fidelity design — turns spec scenarios into task flows, information architecture, low-fidelity layouts, and state coverage. Supports Pencil, Excalidraw, Mermaid, or text wireframes when Figma is not ready.
+  触发：`wireframe` · `low fidelity design` · `Pencil design` · `UX flow`
+
+- **`zsk:design-system`** *[standard · optional]*
+  Design system governance for Figma and frontend alignment — records tokens, component states, naming, responsive rules, accessibility baselines, and anti-generic visual constraints before high-fidelity generation or implementation.
+  触发：`design system` · `design tokens` · `Figma variables` · `component variants`
+
+- **`zsk:figma-generate-hifi`** *[workflow · optional]*
+  Figma high-fidelity generation workflow from spec, UX wireframes, and design-system rules — creates or updates production-oriented Figma pages with state matrices, responsive variants, annotations, and anti-generic visual checks.
+  触发：`generate Figma` · `high fidelity design` · `figma generate design` · `hifi UI`
+
+### `system/` — System · 工程宪法级资源 (6)
 
 - **`zsk:adr`** *[optional]*
   Cross-module long-lived architectural decision record — context, decision, rationale, alternatives considered, and consequences. Produces docs/system/adrs/ADR-NNNN-{slug}.md. Not for single-module implementation choices.
   触发：`architecture decision record` · `ADR template` · `MADR` · `cross-module decision`
 
+- **`zsk:agent-orchestration`** *[core]*
+  Agent orchestration protocol for all zsk skills — assigns independent work to specialized Sub-Agents, defines main-agent ownership, role boundaries, review integration, and fallback behavior when delegation is unavailable.
+  触发：`sub agent orchestration` · `parallel agents` · `multi agent workflow` · `agent responsibilities`
+
 - **`zsk:architecture`** *[optional]*
   Project system architecture documentation — C4 context diagram, tech stack baseline, module boundaries, routing, auth flow, data flow (request/state/contract), deployment topology, related ADRs. Frontend micro-frontend topology is an optional add-on section.
   触发：`system architecture` · `C4 model` · `tech stack baseline` · `module boundaries`

package/bundles.yaml

@@ -20,6 +20,8 @@ bundles:
       - zsk:feature
       - zsk:bugfix
       - zsk:refactor
+      # System orchestration
+      - zsk:agent-orchestration
 
   frontend-project:
     label: 前端项目（推荐）
@@ -36,6 +38,8 @@ bundles:
       - zsk:feature
       - zsk:bugfix
       - zsk:refactor
+      # System orchestration
+      - zsk:agent-orchestration
       # Frontend 16 (5 SDLC overlays + 11 standards)
       - zsk:spec-frontend
       - zsk:design-frontend
@@ -73,6 +77,8 @@ bundles:
       - zsk:feature
       - zsk:bugfix
       - zsk:refactor
+      # System orchestration
+      - zsk:agent-orchestration
       # Frontend 16
       - zsk:spec-frontend
       - zsk:design-frontend
@@ -94,7 +100,10 @@ bundles:
       - zsk:testing-pyramid
       - zsk:security-owasp
       - zsk:a11y-principles
-      # Design-handoff 2
+      # Design-handoff 5
+      - zsk:ux-wireframe
+      - zsk:design-system
+      - zsk:figma-generate-hifi
       - zsk:figma-to-code
       - zsk:ue-mcp
 

package/design-handoff/design-system/SKILL.md

@@ -0,0 +1,124 @@
+---
+name: zsk:design-system
+description: Design system governance for Figma and frontend alignment — records
+  tokens, component states, naming, responsive rules, accessibility baselines,
+  and anti-generic visual constraints before high-fidelity generation or
+  implementation.
+category: standard
+domain: design-handoff
+tier: optional
+related:
+  - ../../system/agent-orchestration/SKILL.md
+  - ../figma-generate-hifi/SKILL.md
+  - ../figma-to-code/SKILL.md
+  - ../../frontend/styling-system/SKILL.md
+  - ../../frontend/a11y-web/SKILL.md
+  - ../../system/nfr-baseline/SKILL.md
+triggers:
+  - design system
+  - design tokens
+  - Figma variables
+  - component variants
+  - visual language
+  - anti generic UI
+---
+
+# Design System · 设计系统治理
+
+> **定位**：Figma 与前端之间的共同语言。它定义 token、组件状态、命名、响应式和视觉约束，避免高保真与实现各说各话。
+> **不做**：不绑定特定 UI 库；具体库名来自 `project-config.md`。
+
+## 最低基线
+
+没有完整设计系统时，也必须建立最低可用基线：
+
+1. Color tokens：brand / semantic / surface / text / border / state
+2. Typography：font family、scale、line-height、用途
+3. Spacing：4/8 系或项目既有节奏
+4. Radius / shadow：使用场景，不按审美随意加
+5. Components：button、input、select、table/list、modal、toast、empty/error
+6. Responsive：项目断点和布局规则
+7. A11y：contrast、focus-visible、keyboard、reduced motion
+
+## Token 记录模板
+
+```md
+# Design System Baseline
+
+## 来源
+- Figma variables:
+- 代码 token:
+- UI library:
+
+## Color
+| Token | 用途 | Figma | Code |
+| --- | --- | --- | --- |
+
+## Typography
+| Token | 用途 | Figma | Code |
+| --- | --- | --- | --- |
+
+## Spacing / Radius / Shadow
+
+## Components
+| Component | Variants | States | Figma | Code |
+| --- | --- | --- | --- | --- |
+```
+
+## 命名规则
+
+- Figma 节点名表达语义，不表达视觉：`UserTable/Header` 优于 `Blue Box`
+- Component variant 用稳定维度：`size`, `variant`, `state`, `density`
+- Code class / token 与 Figma 变量保持可搜索映射
+- 旧命名保留 alias 期，避免设计稿改名导致实现断链
+
+## 组件状态基线
+
+每个组件至少说明：
+
+- default
+- hover
+- focus-visible
+- active / selected
+- disabled
+- loading
+- error
+- readonly（表单类）
+
+缺状态时不得声称“高保真完整”。
+
+## 视觉差异化约束
+
+设计系统必须写明本产品**不应该长什么样**：
+
+```md
+## Visual Red Lines
+- 禁止：
+- 谨慎使用：
+- 本产品优先：
+```
+
+判断标准：
+
+- 是否服务真实用户任务，而不是装饰
+- 是否承载真实数据密度
+- 是否能容纳长文本、多语言、权限差异
+- 是否与同类产品有可解释差异
+- 是否能被现有代码 token 实现
+
+## 与前端实现的关系
+
+- Figma token → `zsk:styling-system` 的代码 token
+- Component variant → React / Vue / Web 组件 props 或状态
+- Focus / contrast → `zsk:a11y-web`
+- 响应式断点 → `zsk:nfr-web`
+- 特殊偏离 → ADR 或模块 `design.md`
+
+## 质量门禁
+
+- [ ] 最低 token 基线齐全
+- [ ] 核心组件状态矩阵齐全
+- [ ] Figma 与代码命名可互查
+- [ ] 视觉红线写明，避免 AI 化同质方案
+- [ ] a11y / responsive / i18n expansion 有明确规则
+- [ ] 高保真生成和实现都引用同一基线

package/design-handoff/figma-generate-hifi/SKILL.md

@@ -0,0 +1,131 @@
+---
+name: zsk:figma-generate-hifi
+description: Figma high-fidelity generation workflow from spec, UX wireframes,
+  and design-system rules — creates or updates production-oriented Figma pages
+  with state matrices, responsive variants, annotations, and anti-generic visual
+  checks.
+category: workflow
+domain: design-handoff
+tier: optional
+related:
+  - ../../system/agent-orchestration/SKILL.md
+  - ../ux-wireframe/SKILL.md
+  - ../design-system/SKILL.md
+  - ../ue-mcp/SKILL.md
+  - ../figma-to-code/SKILL.md
+  - ../../frontend/spec-frontend/SKILL.md
+triggers:
+  - generate Figma
+  - high fidelity design
+  - figma generate design
+  - hifi UI
+  - AI design not generic
+  - design from spec
+---
+
+# Figma Generate Hifi · 从规格生成高保真
+
+> **定位**：把 `proposal/spec/ux-wireframe/design-system` 转成可交付、可实现、可验收的 Figma 高保真。
+> **核心原则**：高保真不是漂亮截图。必须带状态、响应式、批注、token 依据和可实现约束。
+
+## 输入顺序
+
+1. `proposal.md`：目标、非范围、品牌/业务语气
+2. `spec.md`：US / FR / AC / Scenario / NFR
+3. `ux-wireframe.md`：任务流、信息架构、低保真布局（如有）
+4. `design-system.md`：token、组件、状态、禁用模式
+5. 现有产品截图或 Figma 基线（如有）
+
+缺少 Spec 时禁止直接生成高保真；缺设计系统时先走 `zsk:design-system` 建立最低基线。
+
+## 生成协议
+
+### 1. 先定设计方向，不先画页面
+
+```md
+## 设计方向
+- 用户场景：
+- 信息密度：低 / 中 / 高
+- 品牌语气：克制 / 专业 / 消费级 / 数据密集 / 创作型 / 其他
+- 交互节奏：快速录入 / 扫描比较 / 深度编辑 / 决策审批
+- 视觉差异化原则：
+```
+
+### 2. 反 AI 化检查
+
+禁止把下列模式作为默认方案：
+
+- 大面积紫蓝渐变、发光边框、玻璃拟态
+- 无业务信息的卡片堆叠
+- 过大的 marketing hero 套进业务系统
+- 与产品无关的装饰插画
+- 所有页面同一种圆角、阴影、间距节奏
+- 假数据密度过低，真实文案一上来就溢出
+
+必须至少选择 3 个来自产品本身的差异化来源：
+
+| 来源 | 例子 |
+| --- | --- |
+| 领域对象 | 表格、树、时间线、地图、编辑器、审批流 |
+| 用户节奏 | 高频录入、扫描比较、批量处理、异常处理 |
+| 真实内容 | 长标题、多语言、权限状态、异常数值 |
+| 品牌约束 | 色彩、字体、语气、图标风格 |
+| 设备环境 | 桌面密集、移动单手、触屏、投屏 |
+
+### 3. Figma 页面结构
+
+每个模块至少建立：
+
+- Cover / index（模块名、事实源、版本）
+- Main flow（主路径）
+- States（状态矩阵）
+- Responsive（关键断点）
+- Components / variants（仅模块新增或覆写）
+- Notes（交互、a11y、实现注意）
+
+### 4. 状态与响应式
+
+高保真必须覆盖：
+
+- default / loading / empty / error
+- hover / focus-visible / disabled / selected
+- permission denied（如适用）
+- long text / overflow / i18n expansion
+- desktop / tablet / mobile 或项目配置断点
+
+### 5. 批注规则
+
+Figma 批注必须写清：
+
+- 触发条件
+- 动效 / 延迟 / 防抖
+- 键盘行为
+- a11y 语义
+- 失败反馈
+- 与现有组件或 token 的映射
+
+## 输出
+
+```md
+## High-fidelity Design Handoff
+- Figma URL:
+- Page:
+- Node IDs:
+- Design system baseline:
+- Generated from:
+  - proposal:
+  - spec:
+  - ux-wireframe:
+- Open questions:
+```
+
+生成后必须更新 `docs/{module}/ue-mcp.md`，让后续 `zsk:figma-to-code` 有稳定事实源。
+
+## 质量门禁
+
+- [ ] 设计方向来自产品场景，不是通用 AI 模板
+- [ ] 至少 3 个差异化来源已写明
+- [ ] 状态矩阵和响应式断点齐全
+- [ ] 组件 / token 映射到 `zsk:design-system`
+- [ ] 批注覆盖交互、a11y、失败反馈
+- [ ] Figma URL / node-id 已登记到 `ue-mcp.md`

package/design-handoff/figma-to-code/SKILL.md

@@ -9,6 +9,7 @@ category: resource
 domain: design-handoff
 tier: optional
 related:
+  - ../../system/agent-orchestration/SKILL.md
   - ../ue-mcp/SKILL.md
   - ../../frontend/styling-system/SKILL.md
   - ../../frontend/a11y-web/SKILL.md

package/design-handoff/ue-mcp/SKILL.md

@@ -9,6 +9,7 @@ category: resource
 domain: design-handoff
 tier: optional
 related:
+  - ../../system/agent-orchestration/SKILL.md
   - ../figma-to-code/SKILL.md
   - ../../frontend/a11y-web/SKILL.md
   - ../../sdlc/spec/SKILL.md

package/design-handoff/ux-wireframe/SKILL.md

@@ -0,0 +1,129 @@
+---
+name: zsk:ux-wireframe
+description: UX wireframe workflow before high-fidelity design — turns spec
+  scenarios into task flows, information architecture, low-fidelity layouts, and
+  state coverage. Supports Pencil, Excalidraw, Mermaid, or text wireframes when
+  Figma is not ready.
+category: resource
+domain: design-handoff
+tier: optional
+related:
+  - ../../system/agent-orchestration/SKILL.md
+  - ../../sdlc/spec/SKILL.md
+  - ../../sdlc/proposal/SKILL.md
+  - ../figma-generate-hifi/SKILL.md
+  - ../ue-mcp/SKILL.md
+triggers:
+  - wireframe
+  - low fidelity design
+  - Pencil design
+  - UX flow
+  - information architecture
+  - prototype before Figma
+---
+
+# UX Wireframe · 低保真体验设计
+
+> **定位**：Spec 到高保真设计之间的体验结构层。先确认用户任务、信息层级、状态和交互路径，再进入 Figma 高保真。
+> **适用**：没有 Figma、Figma 只有草图、或需要先用 Pencil / Excalidraw / Mermaid 快速对齐流程。
+> **不做**：不定义最终视觉风格、不替代 design system、不输出可编码的视觉 token。
+
+## 工作流
+
+```text
+Spec 场景 → 用户任务流 → 信息架构 → 低保真布局 → 状态覆盖 → 交互批注 → 高保真输入
+```
+
+### 1. 输入检查
+
+必须读取：
+
+- `proposal.md` 的目标、非范围和风险
+- `spec.md` 的 US / FR / AC / Scenario
+- 现有产品页面或系统约束（如有）
+
+如果 Spec 缺关键路径，先回 `zsk:spec` 补 Delta，不靠线框图私自发明需求。
+
+### 2. 任务流
+
+每个 P0 用户目标至少一条主路径：
+
+```md
+## 用户任务流
+
+| Flow | 角色 | 入口 | 关键步骤 | 成功结果 | 失败/退出 |
+| --- | --- | --- | --- | --- | --- |
+| F-1 |  |  | 1 → 2 → 3 |  |  |
+```
+
+### 3. 信息架构
+
+先决定信息优先级，再画布局：
+
+- 用户做决策必须看到什么
+- 哪些信息可折叠 / 延迟加载
+- 哪些操作是主操作、次操作、危险操作
+- 空 / 错 / 加载状态是否仍能解释下一步
+
+### 4. 低保真表达方式
+
+优先使用团队已有工具；没有约定时按速度选择：
+
+| 场景 | 推荐表达 |
+| --- | --- |
+| 快速对齐流程 | Mermaid flowchart / sequence |
+| 页面布局草图 | Pencil / Excalidraw |
+| 文档内轻量表达 | ASCII wireframe |
+| 需要点击原型 | Figma low-fi prototype |
+
+Pencil 适合低保真，不承担 token、组件状态、响应式和高保真验收。
+
+### 5. 状态覆盖
+
+每个可交互区域至少检查：
+
+- default
+- loading
+- empty
+- error
+- disabled
+- hover / focus-visible
+- selected / active（如适用）
+- long text / overflow
+- permission denied（如适用）
+
+### 6. 交付模板
+
+```md
+# {模块} UX Wireframe
+
+## 事实源
+- Spec:
+- Proposal:
+
+## 用户任务流
+
+## 信息架构
+
+## 低保真布局
+- 工具：Pencil / Excalidraw / Mermaid / ASCII / Figma low-fi
+- 文件 / 链接：
+
+## 状态矩阵
+
+| 区域 | 状态 | 触发条件 | 预期反馈 |
+| --- | --- | --- | --- |
+
+## 待进入高保真的输入
+- 关键路径：
+- 必须保留的信息层级：
+- 需要设计系统确认的组件：
+```
+
+## 质量门禁
+
+- [ ] 每个 P0 Scenario 都有任务流
+- [ ] 信息优先级明确，不只画布局
+- [ ] 状态矩阵覆盖 loading / empty / error / disabled / focus
+- [ ] 没有新增 Spec 未声明的行为
+- [ ] 可作为 `zsk:figma-generate-hifi` 的输入

package/frontend/a11y-web/SKILL.md

@@ -10,6 +10,7 @@ category: standard
 domain: frontend
 tier: optional
 related:
+  - ../../system/agent-orchestration/SKILL.md
   - ../react-components/SKILL.md
   - ../i18n/SKILL.md
   - ../testing-web/SKILL.md

package/frontend/api-contract-ts/SKILL.md

@@ -10,6 +10,7 @@ category: standard
 domain: frontend
 tier: optional
 related:
+  - ../../system/agent-orchestration/SKILL.md
   - ../typescript/SKILL.md
   - ../testing-web/SKILL.md
   - ../../sdlc/spec/SKILL.md

package/frontend/design-frontend/SKILL.md

@@ -13,11 +13,15 @@ variants:
   - bugfix
   - refactor
 related:
+  - ../../system/agent-orchestration/SKILL.md
   - ../../sdlc/design/SKILL.md
   - ../spec-frontend/SKILL.md
   - ../performance-web/SKILL.md
   - ../nfr-web/SKILL.md
   - ../react-components/SKILL.md
+  - ../../design-handoff/ux-wireframe/SKILL.md
+  - ../../design-handoff/design-system/SKILL.md
+  - ../../design-handoff/figma-generate-hifi/SKILL.md
   - ../../design-handoff/figma-to-code/SKILL.md
 triggers:
   - frontend design
@@ -97,6 +101,8 @@ Spec 的每个 UE 状态必须说明**由哪个容器 / class / 分支渲染**
 
 **原则**：引用 `docs/{module}/ue-mcp.md` 的命名映射表（[`zsk:figma-to-code`](../../design-handoff/figma-to-code/SKILL.md) Step 4 产物），不重复。
 
+若本模块没有现成 Figma，高保真输入必须先通过 [`zsk:ux-wireframe`](../../design-handoff/ux-wireframe/SKILL.md) + [`zsk:figma-generate-hifi`](../../design-handoff/figma-generate-hifi/SKILL.md) 生成；视觉 token 和组件状态引用 [`zsk:design-system`](../../design-handoff/design-system/SKILL.md)。禁止在 Design 阶段凭空补视觉行为。
+
 ### D. 性能预算（Core Web Vitals）
 
 继承 [`frontend/nfr-web`](../nfr-web/SKILL.md) 的系统基线，模块级可加严：

package/frontend/dor-dod-frontend/SKILL.md

@@ -12,6 +12,7 @@ variants:
   - bugfix
   - refactor
 related:
+  - ../../system/agent-orchestration/SKILL.md
   - ../../sdlc/dor-dod/SKILL.md
   - ../spec-frontend/SKILL.md
   - ../design-frontend/SKILL.md

package/frontend/feature-tasks-frontend/SKILL.md

@@ -8,6 +8,7 @@ domain: frontend
 tier: optional
 change_type: feature
 related:
+  - ../../system/agent-orchestration/SKILL.md
   - ../../sdlc/task-structure/SKILL.md
   - ../../sdlc/task-evidence/SKILL.md
   - ../../sdlc/task-tracking/SKILL.md
@@ -33,7 +34,7 @@ triggers:
 - **测试驱动优先**：能 TDD 就 TDD（`superpowers:test-driven-development`）
 - **契约驱动**：Props / Event / API 类型引自 Spec，不自造
 - **强制 7 类任务**：组件类需求至少覆盖下述 7 个类别
-- **证据先于断言**：每任务完成必须有验证链接
+- **证据先于断言**：每个任务组 / 可审计批次完成必须有验证链接
 
 ## 7 类强制任务
 

package/frontend/i18n/SKILL.md

@@ -9,6 +9,7 @@ category: standard
 domain: frontend
 tier: optional
 related:
+  - ../../system/agent-orchestration/SKILL.md
   - ../react-naming/SKILL.md
   - ../a11y-web/SKILL.md
   - ../../system/nfr-baseline/SKILL.md

package/frontend/nfr-web/SKILL.md

@@ -10,6 +10,7 @@ category: resource
 domain: frontend
 tier: optional
 related:
+  - ../../system/agent-orchestration/SKILL.md
   - ../performance-web/SKILL.md
   - ../a11y-web/SKILL.md
   - ../security-web/SKILL.md