要把产品 UX 愿景固化成 DESIGN.md（外观）与…

当用户提出「做 UX 设计」「写 UX 规范」「帮我规划 UX」时，通过提取而非代笔的方式，产出视觉识别与体验行为两份对等的 UX 契约文档。

适用场景

解决思路

1. 以引导者自居：只提取并记录用户的 UX 愿景，绝不强加自己的想法；不主动给颜色、模式或方向；用创意工具呈现选项，选择权始终归用户。
2. 产出两份对等契约：DESIGN.md（视觉识别，管「长什么样」）与 EXPERIENCE.md（信息架构、行为、状态、交互、无障碍、旅程，管「怎么运作」）；EXPERIENCE.md 用 `{path.to.token}` 语法按名交叉引用 DESIGN.md 的 token。
3. 确立优先级：两条 spine 与任何 mock、线框图或导入稿冲突时，一律以 spine 为准。
4. 写 DESIGN.md 时按 Google Labs spec 组织：YAML frontmatter token（colors、typography、rounded、spacing、components）+ markdown 正文，正文顺序固定为 Brand & Style、Colors、Typography、Layout & Spacing、Elevation & Depth、Shapes、Components、Do's and Don'ts；章节可省略，但存在时顺序锁定；规则见 `references/design-md-spec.md`；形状参考要读遍 `{workflow.design_md_examples}` 的每个条目。
5. 写 EXPERIENCE.md 时始终包含：Foundation（形态因子；有 UI 系统时写明，并以 DESIGN.md 作为视觉识别参考）、Information Architecture、Voice and Tone（微文案；品牌语气在 DESIGN.md.Brand & Style）、Component Patterns（行为；视觉规范在 DESIGN.md.Components）、State Patterns、Interaction Primitives、Accessibility Floor（行为；视觉对比度在 DESIGN.md）、Key Flows（有具名主角、带一个高潮节拍的旅程）。
6. 仅在被触发时加入：Inspiration & Anti-patterns、Responsive & Platform；并可为产品特有顾虑自造章节；形状参考要读遍 `{workflow.experience_md_examples}` 的每个条目。
7. 当 Foundation 指定了 UI 系统（shadcn、MUI、原生 UIKit、Compose、内部设计系统）时，两条 spine 都继承它：DESIGN.md 的 token 引用或扩展系统默认值，EXPERIENCE.md 只写行为差异。
8. Sources 处理：UX 可引领、可跟随、可独立存在；用引用方式继承 `sources:`，让 spine 只承载设计与体验决策，不重复上游产品内容。
9. 激活步骤 1——解析定制化：运行 `uv run {project-root}/_bmad/scripts/resolve_customization.py --skill {skill-root} --project-root {project-root} --key workflow`；若脚本找不到说明 BMad 未安装，提议运行 `bmad` skill 的 setup（没有就先 `npx skills add bmad-code-org/BMAD-METHOD --skill bmad`）再重跑；其它任何失败则直接读 `{skill-root}/customize.toml` 并使用默认值。
10. 激活步骤 2——执行 `{workflow.activation_steps_prepend}`；把 `{workflow.persistent_facts}` 当作基础上下文（`file:` 前缀的条目要加载）；`{workflow.external_sources}` 是组织配置的内部工具注册表，在与通用网络研究相同的触发条件下一并查询，其指令匹配时优先用组织工具。
11. 激活步骤 3——解析配置：`uv run {project-root}/_bmad/scripts/resolve_config.py --project-root {project-root} --key core.project_name --key modules.bmm.planning_artifacts`；`{date}` 取当前系统时间。
12. 激活步骤 4——若为 headless 则按 `references/headless.md` 跑完整轮；否则问候用户，并在问候中告知 `bmad-party-mode` 与 `bmad-advanced-elicitation` 随时可用；然后在第一条消息上做错路由扫描：PRD → `bmad-prd`，架构 → `bmad-architecture`，游戏 UX → BMad GDS，agent/skill → `bmad-workflow-builder`，brief → `bmad-product-brief`。
13. 激活步骤 5——判定意图为 Create、Update 或 Validate；Create 时在绑定新工作区前，扫描 `{workflow.ux_output_path}` 下匹配 `{workflow.run_folder_pattern}` 且 DESIGN.md frontmatter 的 `status` 不为 `final` 的进行中运行，提议续跑而不是重开。
14. 运行 `{workflow.activation_steps_append}`；若 prepend 或 append 非空，逐一确认每个条目都已按序执行完毕，之后才能进入主流程。
15. Create 模式：把 `{doc_workspace}` 绑定到 `{workflow.ux_output_path}/{workflow.run_folder_pattern}/`；创建 `.working/` 与 `imports/`；用 `uv run {project-root}/_bmad/scripts/memlog.py init --workspace {doc_workspace} --field topic="<product/UX>"` 播种 memlog；创建只有 frontmatter 的 DESIGN.md 与 EXPERIENCE.md；然后跑 Discovery → Finalize。
16. Update 模式：读取两条 spine + memlog + sources；若 `.memlog.md` 缺失，用 `uv run {project-root}/_bmad/scripts/memlog.py init --workspace {doc_workspace}` 初始化（这次更新即第一条记录）；主动暴露与既往决策的冲突；然后跑 Finalize。
17. Validate 模式：按 `references/validate.md` 执行。
18. Discovery 的总原则：只捕获、不创作；spine 在 Finalize 阶段向 memlog 蒸馏。
19. 决策写入 `.memlog.md`（唯一权威来源），每条都用 `uv run {project-root}/_bmad/scripts/memlog.py append --workspace {doc_workspace} --type <decision|change|override|assumption|event> --text "…"` 追加，绝不手工编辑；续跑时重新加载它。
20. 创意工具产物放 `.working/`；用户提供的视觉素材（Figma、草图、品牌 deck、图片文件夹）放 `imports/`，每项追加一条 `memlog.py append`。
21. 源扫描：glob `{planning_artifacts}/` 找候选输入路径；只暴露路径，绝不在父级读取内容；由用户确认哪些适用或补充其它输入；确认后再交给 subagent 提取。
22. 先让用户 brain dump（即使用户一开口就是大段文字，那也是 intake）；大文档交 subagent 提取；做一次「还有别的吗？」的追问；判定 stakes：hobby / internal / consumer / regulated。
23. 选择工作模式：Fast path（批量收集缺口，给两条 spine 打 `[ASSUMPTION]` 草稿，跳过创意工具）；Coaching path（逐个决策走，穿插创意工具）；Design handoff（把已捕获的 Discovery 组装成生产者形状的提示词，由用户跑外部工具并把产物按该工具自身格式存到 `{doc_workspace}`；生产者注册表 `{workflow.design_handoffs}`，默认 Google Stitch；EXPERIENCE.md 可在就绪后用 Update 模式补上）。
24. 创意工具：扫描 `{workflow.creative_tools}`，在「看了有帮助」时调用；默认用 HTML 配色主题、设计方向、Excalidraw 线框图，并在 Finalize 时产出关键屏 HTML mock；详见 `references/creative-tools.md`；按需启用研究 subagent，条目匹配时查阅 `{workflow.external_sources}`。
25. 顾虑扫描：逐一念出 UX 要承载的内容——accessibility、platforms、brand、regulated language、motion、i18n、dark mode、offline、content density、input modalities、notifications；这是开放清单，用来驱动自造章节。
26. 旅程采集：让用户叙述一次具名主角的真实使用场景（如 Mary，三个孩子的妈妈、孩子已睡——而不是「用户」）；整理成带编号的步骤并设置一个高潮节拍；源规范已定义名称时逐字沿用。
27. 形态因子：mobile / web / desktop / multi-surface 必须在 IA 收敛前解决；具名主角的旅程常能推出它（Pary 用 iPad 意味着 iPad 表面，Skeeter 用 Android 则追加 multi-surface 需求）；旅程无法消歧时要主动追问。
28. 表面收敛：已陈述的需求经旅程变成屏幕；当每个已陈述需求都有一个表面来承载、且每个表面都有一个旅程落到那里时，IA 才算收敛；收敛失败就追问，绝不凭空发明缺失的一环。
29. Reviewer Gate（Validate 与 Finalize 共用）：opt-in、镜头可选——reviewer 代价高（并行 subagent、大量 token）。Finalize 时先问要不要跑验证（默认提供、可轻松跳过）；Validate 意图下用户已 opt-in，跳过该提问；两种情况下都呈现镜头菜单，让用户选全部 / 子集 / 一个不选。菜单为：rubric walker（`references/validate.md`）+ `{workflow.finalize_reviewers}` + ad-hoc（consumer/regulated 加 accessibility，其余按 stakes 与内容决定）。选中的镜头以并行 subagent 派发，各自写 `review-{slug}.md` 并返回精简摘要；只要有镜头跑过，就执行 `references/validate.md` 中的 synthesis pipeline。
30. Finalize 第 1 步——蒸馏 spine：subagent 读 `.memlog.md`、`.working/`、`imports/`、sources，按 `## The DESIGN.md spine` 与 `## The EXPERIENCE.md spine`（含各自的 examples）产出 `DESIGN.md` 与 `EXPERIENCE.md`；主动跑 rubric walker 的 Pass 1 覆盖检查（见 `references/validate.md`）；暴露缺口，绝不发明。
31. Finalize 第 2 步——对账输入：每个用户提供的输入派一个 subagent → `reconcile-{slug}.md`；把被丢弃的定性想法暴露出来。
32. Finalize 第 3 步——再次提供 Reviewer Gate（见上条）：若问出「要」，就呈现镜头菜单让用户挑；只要有镜头跑过，先解决 findings 再进入打磨，否则直接继续。
33. Finalize 第 4 步——分诊未决项：Open Questions、`[ASSUMPTION]`、`[NOTE FOR UX]`；阶段阻塞项一次处理一条，非阻塞项用 `memlog.py append` 记下。
34. Finalize 第 5 步——渲染关键屏 mock：用关键屏工具产出到 `.working/`，针对「布局驱动行为或锚定视觉语言」的表面。
35. Finalize 第 6 步——确认 mock 覆盖：遍历 IA 里的每个表面，分类为 mocked 或 spine-only；问用户「这些将仅凭 spine 表格来构建——有需要视觉参考的吗？」；被点名就补渲染；记录 spine-only 的选择。
36. Finalize 第 7 步——抽取布局、提升产物：蒸馏 subagent 重读每个 `.working/` 与 `imports/` 产物，把视觉决策提升进 DESIGN.md、行为决策提升进 EXPERIENCE.md；把 `.working/` 中要保留的晋升到 `mockups/`（HTML）或 `wireframes/`（Excalidraw），imports 原地保留；在相关 spine 章节内联相对链接；并声明一次「冲突时以 spine 为准」。
37. Finalize 第 8 步——打磨、交付、收尾：按顺序应用 `{workflow.doc_standards}`；执行 `{workflow.external_handoffs}` 并给出 URL；把两个文件的 `status` 设为 `final`、`updated` 设为 `{date}`；用 `uv run {project-root}/_bmad/scripts/memlog.py append --workspace {doc_workspace} --type event --text "spines finalized"` 记录收尾；分享文件路径；常见下一步为 `bmad-architecture`、`bmad-create-epics-and-stories`、`bmad-build`；最后运行 `{workflow.on_complete}`。

适用边界 · 注意事项

• 需要的是产品需求（PRD）、架构或产品 brief 而非 UX 设计时，应改走对应流程（`bmad-prd` / `bmad-architecture` / `bmad-product-brief`）。
• 已有权威且完整的视觉与体验规范、只需局部改样式或微调时，不必跑整套 Create 引导流程。
• 未安装 BMad 环境（`uv` 脚本、`memlog.py`、`resolve_*.py` 等不可用）且不愿安装时流程会失败，此时不适用。