# workflow: id: brownfield-ui name: 棕地 UI/前端增强 description: >- 用于通过新功能、现代化或设计改进来增强现有前端应用程序的代理工作流程。处理现有 UI 分析和安全集成。 type: brownfield project_types: - ui-modernization - framework-migration - design-refresh - frontend-enhancement sequence: - step: ui_analysis agent: architect action: 分析现有项目并使用任务 document-project creates: 每个 document-project 模板的多个文档 notes: "审查现有前端应用程序、用户反馈、分析数据，并识别改进领域。" - agent: pm creates: prd.md uses: brownfield-prd-tmpl requires: existing_ui_analysis notes: "创建专注于 UI 增强和现有系统分析的综合 PRD。保存输出：将最终的 prd.md 复制到您项目的 docs/ 文件夹中。" - agent: ux-expert creates: front-end-spec.md uses: front-end-spec-tmpl requires: prd.md notes: "创建与现有设计模式集成的 UI/UX 规范。保存输出：将最终的 front-end-spec.md 复制到您项目的 docs/ 文件夹中。" - agent: architect creates: architecture.md uses: brownfield-architecture-tmpl requires: - prd.md - front-end-spec.md notes: "创建包含组件集成策略和迁移规划的前端架构。保存输出：将最终的 architecture.md 复制到您项目的 docs/ 文件夹中。" - agent: po validates: all_artifacts uses: po-master-checklist notes: "验证所有文档的 UI 集成安全性和设计一致性。可能需要更新任何文档。" - agent: various updates: any_flagged_documents condition: po_checklist_issues notes: "如果 PO 发现问题，请返回相关代理进行修复，并将更新后的文档重新导出到 docs/ 文件夹。" - agent: po action: shard_documents creates: sharded_docs requires: all_artifacts_in_project notes: | 为 IDE 开发分片文档： - 选项 A：使用 PO 代理分片：@po 然后要求分片 docs/prd.md - 选项 B：手动：将 shard-doc 任务 + docs/prd.md 拖到聊天中 - 创建包含分片内容的 docs/prd/ 和 docs/architecture/ 文件夹 - agent: sm action: create_story creates: story.md requires: sharded_docs repeats: for_each_epic notes: | 故事创建周期： - SM 代理（新聊天）：@sm → *create - 从分片文档创建下一个故事 - 故事以“草稿”状态开始 - agent: analyst/pm action: review_draft_story updates: story.md requires: story.md optional: true condition: user_wants_story_review notes: | 可选：审查并批准故事草稿 - 注意：story-review 任务即将推出 - 审查故事的完整性和一致性 - 更新故事状态：草稿 → 已批准 - agent: dev action: implement_story creates: implementation_files requires: story.md notes: | 开发代理（新聊天）：@dev - 实施已批准的故事 - 使用所有更改更新文件列表 - 完成后将故事标记为“审查” - agent: qa action: review_implementation updates: implementation_files requires: implementation_files optional: true notes: | 可选：QA 代理（新聊天）：@qa → review-story - 具有重构能力的高级开发人员审查 - 直接修复小问题 - 为剩余项目留下清单 - 更新故事状态（审查 → 完成或保持审查） - agent: dev action: address_qa_feedback updates: implementation_files condition: qa_left_unchecked_items notes: | 如果 QA 留下未检查的项目： - 开发代理（新聊天）：处理剩余项目 - 返回 QA 进行最终批准 - repeat_development_cycle: action: continue_for_all_stories notes: | 对所有史诗故事重复故事周期（SM → 开发 → QA） 继续直到 PRD 中的所有故事都完成 - agent: po action: epic_retrospective creates: epic-retrospective.md condition: epic_complete optional: true notes: | 可选：史诗完成后 - 注意：epic-retrospective 任务即将推出 - 验证史诗是否正确完成 - 记录经验教训和改进 - workflow_end: action: project_complete notes: | 所有故事都已实施和审查！ 项目开发阶段完成。 参考：{root}/data/bmad-kb.md#IDE Development Workflow flow_diagram: | ```mermaid graph TD A[开始：UI 增强] --> B[分析师：分析现有 UI] B --> C[项目经理：prd.md] C --> D[用户体验专家：front-end-spec.md] D --> E[架构师：architecture.md] E --> F[产品负责人：使用 po-master-checklist 验证] F --> G{产品负责人发现问题？} G -->|是| H[返回相关代理进行修复] G -->|否| I[产品负责人：分片文档] H --> F I --> J[Scrum Master：创建故事] J --> K{审查故事草稿？} K -->|是| L[分析师/项目经理：审查并批准故事] K -->|否| M[开发人员：实施故事] L --> M M --> N{QA 审查？} N -->|是| O[QA：审查实施] N -->|否| P{更多故事？} O --> Q{QA 发现问题？} Q -->|是| R[开发人员：处理 QA 反馈] Q -->|否| P R --> O P -->|是| J P -->|否| S{史诗回顾？} S -->|是| T[产品负责人：史诗回顾] S -->|否| U[项目完成] T --> U style U fill:#90EE90 style I fill:#ADD8E6 style J fill:#ADD8E6 style M fill:#ADD8E6 style C fill:#FFE4B5 style D fill:#FFE4B5 style E fill:#FFE4B5 style L fill:#F0E68C style O fill:#F0E68C style T fill:#F0E68C ``` decision_guidance: when_to_use: - UI 增强需要协调的故事 - 需要更改设计系统 - 需要新的组件模式 - 需要用户研究和测试 - 多个团队成员将参与相关的更改 handoff_prompts: analyst_to_pm: "UI 分析完成。创建包含 UI 集成策略的综合 PRD。" pm_to_ux: "PRD 已准备就绪。将其另存为您项目中的 docs/prd.md，然后创建 UI/UX 规范。" ux_to_architect: "UI/UX 规范已完成。将其另存为 docs/front-end-spec.md，然后创建前端架构。" architect_to_po: "架构已完成。将其另存为 docs/architecture.md。请验证所有工件的 UI 集成安全性。" po_issues: "PO 发现 [文档] 有问题。请返回 [代理] 进行修复并重新保存更新后的文档。" complete: "所有规划工件都已验证并保存在 docs/ 文件夹中。移动到 IDE 环境以开始开发。"