dwf-design

用途

dwf-design 用于单独执行 DWF 工作流的“设计稿”阶段。它只负责收集、生成或记录设计稿信息，产出目标 spec 目录下 02-设计稿/设计稿.md。独立运行时不启动完整开发工作流；工作流模式下按 .dwf/state.json 继续当前阶段。

主要能力

只处理设计稿阶段，默认只创建或更新目标 spec 目录下 02-设计稿/设计稿.md，以及必要的 02-设计稿/images/ 图片目录。
不创建其它阶段文档或代码，不主动创建 01-需求/、03-需求分析/、04-技术方案/、05-实现清单/，也不修改已有需求文档。
支持多种设计稿来源：用户提供的链接（Figma、网页、飞书等）、图片素材、基于需求文档和用户描述的 AI 生成，或选择跳过。
生成文档遵循本技能目录下 references/design_template.md 模板，结构包括项目名称、设计稿来源、链接、设计稿图片、设计说明、响应式适配和待确认项。
全程使用中文，除非用户明确要求其他语言。代码、文件路径、命令、API 名、技术术语、第三方库名、设计工具名和用户提供的原文内容可保留英文。

使用方式

运行模式与目标 spec 目录

目标 spec 目录由运行模式决定，不由本技能臆造。

工作流模式：读取 .dwf/state.json，在 specs 数组中找 status: "active" 且 current_step: "design" 的 spec，以 .dwf/specs/{spec.name} 作为目标 spec 目录。若该 spec 的 shared_ref 非空（兄弟 spec），优先读取 .dwf/specs/{shared_ref}/01-需求/需求文档.md 作为需求依据。
独立模式：.dwf/state.json 不存在或不存在满足条件的 active spec。用 question 询问用户目标目录，默认提议 .dwf/specs/{今日日期}-{seq}-feat-{描述}，其中 seq 扫描 .dwf/specs/ 现有 spec 目录名中的最大序号 +1（无则 001），由用户确认或修改。

独立模式下不要创建或推进 .dwf/state.json，只写目标 spec 目录下的设计稿与该 spec 的 _meta.json（如本技能创建该 spec），不要把项目推进到 breakdown、plans、todos 或 code。只有工作流模式下才在用户确认后更新 state.json 中该 spec 的 current_step。

触发后流程

探查上下文：检查 .dwf/state.json 是否存在；若目标 spec 目录下 02-设计稿/设计稿.md 存在，先读取并按“已有文档处理”执行；读取需求依据；处理用户提供的本地文件路径、图片或外部链接；若用户只给出简短想法，先澄清会影响设计方向的最少信息。
判断运行模式与目标 spec 目录。
判断设计稿来源：链接、图片、AI 生成或跳过。
澄清缺失信息：信息不足时一次只问一个问题，优先澄清目标端（PC 端、移动端或双端）、设计稿来源、关键页面数量与页面名称、期望风格/品牌色/字体/参考产品、关键交互与响应式要求。如果可以合理假设，先明确写入“待确认项”。
生成设计稿文档：读取 references/design_template.md 作为模板保存到目标 spec 目录下 02-设计稿/设计稿.md。项目名称优先来自需求文档，缺失时从用户描述中提取，仍不明确则写“待确认”。设计说明应覆盖整体风格、主色调、字体、间距规范、关键页面描述和关键交互。如果没有真实图片，不要伪造截图路径，可写“暂无图片”并在待确认项中标注。
请求用户确认：生成文档后展示保存位置和简要摘要并请求确认。用户确认后，独立模式停止；工作流模式更新该 spec 的 current_step 为 "breakdown"、把 design 追加到 confirmed_stages，同步 _meta.json 与 updated_at，由 dwf-orchestrator 推进。

已有文档处理

如果目标文件已存在：读取 {目标 spec 目录}/02-设计稿/设计稿.md，总结当前文档的项目名称、设计稿来源和主要设计内容，询问用户要如何处理：保留现有设计稿仅查看或总结、基于现有设计稿修改、替换为新设计稿。只有用户明确选择修改或替换后，才能写入文件。修改已有文档时保留原有结构，除非用户要求重写；不要创建 设计稿-v2.md 之类的新版本文件，除非用户明确要求。

跳过设计稿

工作流模式下若 spec.design_skipped 为 true（用户在需求阶段已选择跳过设计稿），直接在目标 spec 目录下 02-设计稿/设计稿.md 写“设计稿阶段已跳过，无设计稿。”，把 design_skipped: true 与 design 加入 affected_stages 排除后确认推进。

适用场景

需要在 DWF 工作流中单独执行或推进设计稿阶段。
已有需求文档，需要据此生成或记录设计稿说明。
用户提供 Figma、网页、飞书等设计链接或图片素材，需要整理进设计稿文档。
用户只给出简短设计要求，需要澄清并生成设计稿文档。
用户明确选择跳过设计稿阶段。

限制

只处理设计稿阶段，不创建其它阶段文档或代码。
独立模式下不创建或推进 .dwf/state.json，不推进后续阶段。
确认前不覆盖已有设计稿文档。
不伪造截图路径；没有真实图片时写“暂无图片”并在待确认项中标注。
不创建完整工作流目录，除目标 spec 目录下 02-设计稿/ 外不主动创建其它阶段目录。
不修改已有需求文档。
遵循 dwf-orchestrator 的确认机制，不跳过用户确认。
关于收费、价格、平台支持范围等具体信息，资料中暂未提供。