Menu
证据驱动的创作设计总控。当需要定稿交互、视觉、排版设计，或提到"设计""最佳实践""证据""design"
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Baseado na classificação ocupacional SOC
结构化脑暴——发散探索 + 收敛评估。当想法模糊、面临开放性问题或需要方案对比，或提到"脑暴""想法""方案对比""怎么办"
恢复保存的工作上下文。当新 session 需要继续之前的工作，或提到"恢复""restore""继续上次"
保存工作上下文。当需要保存当前工作状态供后续 session 恢复，或提到"保存""save""checkpoint""挂起"
架构决策记录（ADR）。当面临技术选型、架构决策、方案取舍需要记录，或提到"ADR""决策记录""为什么这样做"
发布或导出检查 → Go/No-Go → 归档。当审查通过后需要上线或交付最终产物，或提到"发布""上线""ship""Go/No-Go"
合并 PR → 等待 CI → 验证生产。当 PR 已创建需要合并到主分支并验证部署，或提到"合并""merge""PR""land"
| name | design-workflow-design |
| description | 证据驱动的创作设计总控。当需要定稿交互、视觉、排版设计，或提到"设计""最佳实践""证据""design" |
| argument-hint | [artifact-type: software|document|article|deck|visual] |
01-spec.md 已批准，且任务会产生用户可感知产物docs/features/YYYYMMDD-<name>/02-design.md + 用户批准；项目根 DESIGN.md 同步更新；纯后端/脚本/迁移允许 skipbuild-workflow-plan；设计探索不足时回到 define-workflow-refinereferences/design-best-practices.md、references/design-inspiration-catalog.md、references/design-pattern-extract.md、项目根 DESIGN.md（如果存在）一定需要 design： document / article / deck / visual；software 且涉及页面/组件/交互/视觉/信息架构/用户路径。
可以 skip： software 纯后端、纯脚本/迁移/CI。Skip 时记录：Design Status: skipped, Skip Reason: [理由]。
define：定义问题/目标/范围。design：定稿交互/视觉/排版/剧本/导演。plan：拆任务/排依赖。build：实现产物。设计阶段不写实现代码、不写 Task N、不决定 DB/API/服务架构。
/design 由阶段技能按 artifact_type 选择 persona；persona 不能绕过本技能直接进入 plan/build。
agents/requirements-analyst.md：Step 1 的 design required / skipped 判断agents/content-writer.md：document / article / deck 的剧本、叙事、内容结构设计agents/visual-designer.md：software + UI、deck、visual 的交互、视觉方向、排版agents/design-reviewer.md：审查 02-design.md 的证据质量、边界和实施前置条件codex:codex-rescue：可选视觉生成增强，不替代上述 persona 和证据门references/design-inspiration-catalog.md（按领域索引 73 个真实网站）和 references/design-pattern-extract.md（高频设计模式提炼）references/design-pattern-extract.md 的通用 Don'ts 作为验证基线DESIGN.md 是此层载体（Google Stitch token 格式）；优先级最高外部模式只能作为证据进入 Adopt，不能直接变成设计决策。Local 与外部冲突时以 Local 为准，外部写入 Reject。
读取 artifact_type、目标用户、使用场景、成功标准、Scope 边界。判断是否有用户可感知产物且需要在实现前锁定方向。
| 场景 | 需要加载 |
|---|---|
software + UI | design-experience-interaction + design-visual-direction |
document / article | design-content-script + design-content-layout |
deck | design-content-script + design-content-direction + design-content-layout |
visual | design-visual-direction + design-content-layout |
围绕当前轨道执行创作与呈现层扫描：Interaction（流程/状态/信息架构）、Visual direction（品牌/视觉系统/层级）、Layout（栅格/构图/阅读路径）、Script（叙事结构/消息线）、Direction（页序/揭示/节奏）。
灵感来源优先级： design-inspiration-catalog.md → design-pattern-extract.md → 项目根 DESIGN.md → Web search 兜底。
固定输出：Design References / Pattern Synthesis / Design Inferences / Adopt / Reject / Design Evidence Quality。检索不可用时记录 Search unavailable，关键决策仍缺证据时 STOP。
codex:codex-rescue agent 可用，且 artifact_type 为 software（有 UI）、visual 或 deck 时触发。产物包括 mockup PNG 和 assets/design-tokens-extracted.json。需要执行时读取 visual-generation.md。
02-design.md必须包含：设计来源证据、模式综合、设计推导、Adopt / Reject、证据质量、设计目标、关键决策、设计边界、设计批准标准、实施前置条件、按类型的设计内容。
多方案（visual comparison applicable）： software(有 UI)、visual、deck 时产出 2-3 个设计方向，各方向在最有影响力的维度差异化，独立记录后进入 Step 4.5 交互式对比。不适用时产出单一草案，跳过 Step 4.5。
仅当 Step 4 产出 alternatives 时执行。调用 design-interactive-preview：启动本地 HTTP 服务 → 生成对比 HTML → 多轮对比 → 捕获选择 → 精炼 02-design.md → 关闭服务。
向 human partner 展示设计稿，确认方向、证据、Adopt / Reject、缺失项、不做清单。没有批准不得进入 /plan。
读取已批准的 02-design.md，提取跨 feature 的项目级设计 token 写入 DESIGN.md。详细合并规则见 design-sync.md。
| 失败场景 | 处理方式 |
|---|---|
| 设计目标和 spec 冲突 | 回到 define-workflow-refine 修正目标或边界 |
| 无法判断是否需要 design | 保守处理：需要 design |
| 缺少 best-practice scan | 补扫并写入 Design References / Adopt / Reject |
| 关键决策缺证据 | STOP，补证据或降级设计决策 |
| 设计稿写实现步骤 | 删除实现步骤，回到创作决策层 |
| 用户认为方向不对 | 保留已有判断，修改后重新审查 |
| 说辞 | 现实 | 后果 |
|---|---|---|
| "先把代码写出来再调设计" | 创作决策伪装成实现细节，返工更贵。 | 交互路径被实现锁定 → 改方向重写 UI >50% |
| "排版/剧本/交互都可以 build 里顺手做" | 顺手做 = 没有阶段门，没有定稿依据。 | 每位开发者自由发挥 → 视觉/交互不一致 |
| "只是小 UI，不需要设计" | 用户看得见/用得到，就可能需要先定主路径和状态。 | 跳过设计 → 遗漏空态/错误态/加载态 → 上线后用户看到空白 |
| "设计就是把实现写详细一点" | 设计定方向，plan 拆任务，build 才落实现。 | 混淆创作决策和技术执行 → 审查失效 |
| "参考几个案例就够了" | 案例必须转成 Pattern / Adopt / Reject。 | 灵感堆砌 → 无证据链 → 关键决策无法回溯 |
02-design.md 里写测试/实现步骤或提交命令/plan02-design.md02-design.md 包含 Design References / Pattern Synthesis / Design Inferences / Adopt-Reject / Evidence Quality### Design 交付记录 — <feature-name>
**Design Status**: [required / skipped — 跳过原因]
**artifact_type**: [software / document / article / deck / visual]
**设计轨道**: [交互 / 视觉方向 / 排版 / 剧本 / 导演]
**Design Best-Practice Scan**:
- Design References: [来源列表]
- Pattern Synthesis: [综合模式]
- Adopt / Reject: [采纳/拒绝清单 + 理由]
- Evidence Quality: [评分 / 来源数]
**关键决策**: [决策1 / 决策2 / ...]
**设计边界**: [不做清单 + trade-off]
**实施前置条件**: [前提条件列表]
**用户批准**: [已批准 / 待批准]
**DESIGN.md 同步**: [已同步 / 未同步]