sinapse-ai 5.0.8 → 6.0.1

package/docs/zh/sinapse-workflows/greenfield-fullstack-workflow.md

@@ -1,796 +0,0 @@
-# 绿地全栈工作流
-
-**版本:** 1.0.0
-**类型:** 绿地项目
-**最后更新:** 2026-02-04
-**源文件:** `.sinapse-ai/development/workflows/greenfield-fullstack.yaml`
-
----
-
-## 概述
-
-**绿地全栈工作流** 是 SINAPSE 从概念到开发的主要工作流,用于构建全栈应用。本工作流既支持复杂项目的全面规划,也支持简单项目的快速原型设计。
-
-### 支持的项目类型
-
-| 类型 | 描述 |
-|------|------|
-| `web-app` | 现代网络应用 |
-| `saas` | 软件即服务 |
-| `enterprise-app` | 企业应用 |
-| `prototype` | 原型和概念验证 |
-| `mvp` | 最小可行产品 |
-
-### 何时使用本工作流
-
-- 构建生产就绪的应用
-- 多团队成员项目
-- 复杂功能需求
-- 需要全面文档
-- 长期维护预期
-- 企业或客户应用
-
----
-
-## 工作流总体图表
-
-```mermaid
-flowchart TB
-    subgraph PHASE0["第 0 阶段: 环境引导"]
-        A[开始: 绿地项目] --> A1{环境就绪?}
-        A1 -->|否| A2["@devops: *environment-bootstrap"]
-        A2 --> A3[CLIs 已安装 + GitHub 仓库已创建]
-        A1 -->|是| A3
-    end
-
-    subgraph PHASE1["第 1 阶段: 发现和规划"]
-        A3 --> B["@analyst: project-brief.md"]
-        B --> C["@pm: prd.md"]
-        C --> D["@ux-expert: front-end-spec.md"]
-        D --> D2{生成 v0 提示?}
-        D2 -->|是| D3["@ux-expert: 创建 v0 提示"]
-        D2 -->|否| E["@architect: fullstack-architecture.md"]
-        D3 --> D4[用户: 在 v0/Lovable 中生成 UI]
-        D4 --> E
-        E --> F{架构建议更改 PRD?}
-        F -->|是| G["@pm: 更新 prd.md"]
-        F -->|否| H["@po: 验证所有工件"]
-        G --> H
-        H --> I{PO 发现问题?}
-        I -->|是| J[返回相关代理进行更正]
-        I -->|否| K_GATE[第 1 阶段完成]
-        J --> H
-    end
-
-    subgraph PHASE2["第 2 阶段: 文档分片"]
-        K_GATE --> K["@po: 分片文档"]
-        K --> K1[创建: source-tree, tech-stack, coding-standards]
-    end
-
-    subgraph PHASE3["第 3 阶段: 开发循环"]
-        K1 --> L["@sm: 创建故事"]
-        L --> M{审阅故事草稿?}
-        M -->|是| N["@analyst/@pm: 审阅和批准故事"]
-        M -->|否| O["@dev: 实施故事"]
-        N --> O
-        O --> P{质量保证审阅?}
-        P -->|是| Q["@qa: 审阅实现"]
-        P -->|否| R{更多故事?}
-        Q --> S{QA 发现问题?}
-        S -->|是| T["@dev: 解决 QA 反馈"]
-        S -->|否| R
-        T --> Q
-        R -->|是| L
-        R -->|否| U{史诗回顾?}
-        U -->|是| V["@po: 史诗回顾"]
-        U -->|否| W[项目完成]
-        V --> W
-    end
-
-    %% 可选路径
-    B -.-> B1[可选: 头脑风暴]
-    B -.-> B2[可选: 市场研究]
-    D -.-> D1[可选: 用户研究]
-    E -.-> E1[可选: 技术研究]
-
-    %% 样式
-    style A2 fill:#FF6B6B,color:#fff
-    style A3 fill:#FF6B6B,color:#fff
-    style W fill:#90EE90
-    style K fill:#ADD8E6
-    style K1 fill:#ADD8E6
-    style L fill:#ADD8E6
-    style O fill:#ADD8E6
-    style D3 fill:#E6E6FA
-    style D4 fill:#E6E6FA
-    style B fill:#FFE4B5
-    style C fill:#FFE4B5
-    style D fill:#FFE4B5
-    style E fill:#FFE4B5
-    style N fill:#F0E68C
-    style Q fill:#F0E68C
-    style V fill:#F0E68C
-```
-
----
-
-## 工作流阶段
-
-### 颜色说明
-
-| 颜色 | 含义 |
-|------|------|
-| 红色 (#FF6B6B) | 环境引导 |
-| 浅橙色 (#FFE4B5) | 规划和文档 |
-| 浅蓝色 (#ADD8E6) | 开发和分片 |
-| 浅紫色 (#E6E6FA) | AI 生成 UI |
-| 黄色 (#F0E68C) | 审阅和验证 |
-| 绿色 (#90EE90) | 完成 |
-
----
-
-## 第 0 阶段: 环境引导
-
-### 目标
-在启动项目规划前配置开发环境。
-
-### 详细图表
-
-```mermaid
-flowchart TD
-    subgraph FASE0["第 0 阶段: 环境引导"]
-        START([开始]) --> CHECK{环境就绪?}
-
-        CHECK -->|验证| ENV_REPORT[".sinapse/environment-report.json 存在?"]
-        ENV_REPORT -->|是| SKIP[跳过引导]
-        ENV_REPORT -->|否| BOOTSTRAP
-
-        subgraph BOOTSTRAP["@devops: *environment-bootstrap"]
-            B1[检测操作系统]
-            B2[CLIs 审计]
-            B3[交互式安装]
-            B4[服务身份验证]
-            B5[Git 仓库初始化]
-            B6[项目结构搭建]
-            B7[环境报告生成]
-
-            B1 --> B2 --> B3 --> B4 --> B5 --> B6 --> B7
-        end
-
-        SKIP --> DONE
-        B7 --> DONE([第 0 阶段完成])
-    end
-```
-
-### 详细步骤
-
-| 步骤 | 代理 | 任务 | 输入 | 输出 | 必需 |
-|------|------|------|------|------|------|
-| 1 | @devops (Gage) | `environment-bootstrap.md` | `project_name`, `project_path`, `github_org` | `.sinapse/config.yaml`, `.sinapse/environment-report.json`, `.gitignore`, `README.md`, `package.json` | 是 |
-
-### 创建的工件
-
-| 文件 | 描述 |
-|------|------|
-| `.sinapse/config.yaml` | SINAPSE 项目配置 |
-| `.sinapse/environment-report.json` | 完整的环境报告 |
-| `.gitignore` | Git 忽略规则 |
-| `README.md` | 初始项目文档 |
-| `package.json` | NPM 配置 |
-
-### 验证/安装的 CLIs
-
-| 类别 | 工具 | 必需 |
-|------|------|------|
-| 必需 | git | 是 |
-| 必需 | gh (GitHub CLI) | 是 |
-| 必需 | node | 是 |
-| 必需 | npm | 是 |
-| 基础设施 | supabase | 推荐 |
-| 基础设施 | railway | 可选 |
-| 基础设施 | docker | 推荐 |
-| 质量 | coderabbit | 推荐 |
-| 可选 | pnpm | 可选 |
-| 可选 | bun | 可选 |
-
-### 跳过条件
-
-- 仅在项目已有 `.sinapse/environment-report.json` 时跳过
-- 切换机器或新团队成员加入时重新执行
-
----
-
-## 第 1 阶段: 发现和规划
-
-### 目标
-创建所有规划工件: 项目简报、PRD、规范和架构。
-
-### 详细图表
-
-```mermaid
-flowchart TD
-    subgraph FASE1["第 1 阶段: 发现和规划"]
-        ENV_DONE([引导完成]) --> ANALYST
-
-        subgraph ANALYST["@analyst: Atlas"]
-            A1[可选头脑风暴]
-            A2[可选市场研究]
-            A3[创建项目简报]
-            A1 -.-> A3
-            A2 -.-> A3
-        end
-
-        ANALYST --> |project-brief.md| PM
-
-        subgraph PM["@pm: Morgan"]
-            P1[审阅项目简报]
-            P2[使用 prd-tmpl 创建 PRD]
-            P1 --> P2
-        end
-
-        PM --> |prd.md| UX
-
-        subgraph UX["@ux-expert: Uma"]
-            U1[可选用户研究]
-            U2[创建前端规范]
-            U3{生成 v0 提示?}
-            U4[为 v0/Lovable 创建提示]
-            U1 -.-> U2
-            U2 --> U3
-            U3 -->|是| U4
-        end
-
-        UX --> |front-end-spec.md| ARCH
-
-        subgraph ARCH["@architect: Aria"]
-            AR1[可选技术研究]
-            AR2[创建全栈架构]
-            AR3{建议更改 PRD?}
-            AR1 -.-> AR2
-            AR2 --> AR3
-        end
-
-        AR3 -->|是| PM_UPDATE["@pm: 更新 PRD"]
-        AR3 -->|否| PO
-        PM_UPDATE --> PO
-
-        subgraph PO["@po: Pax"]
-            PO1[执行 po-master-checklist]
-            PO2{发现问题?}
-            PO1 --> PO2
-        end
-
-        PO2 -->|是| FIX[返回相关代理]
-        FIX --> PO
-        PO2 -->|否| DONE([第 1 阶段完成])
-    end
-```
-
-### 详细步骤
-
-| 步骤 | 代理 | 任务/模板 | 输入 | 输出 | 必需 |
-|------|------|----------|------|------|------|
-| 1 | @analyst (Atlas) | `project-brief-tmpl.yaml` | 用户需求、研究 | `project-brief.md` | 是 |
-| 2 | @pm (Morgan) | `prd-tmpl.yaml` | `project-brief.md` | `prd.md` | 是 |
-| 3 | @ux-expert (Uma) | `front-end-spec-tmpl.yaml` | `prd.md` | `front-end-spec.md` | 是 |
-| 4 | @ux-expert (Uma) | `generate-ai-frontend-prompt.md` | `front-end-spec.md` | v0/Lovable 提示 | 可选 |
-| 5 | @architect (Aria) | `fullstack-architecture-tmpl.yaml` | `prd.md`, `front-end-spec.md` | `fullstack-architecture.md` | 是 |
-| 6 | @pm (Morgan) | 更新 | `fullstack-architecture.md` | 更新的 `prd.md` | 条件 |
-| 7 | @po (Pax) | `po-master-checklist.md` | 所有工件 | 验证 | 是 |
-
-### 创建的工件
-
-| 文档 | 责任人 | 位置 |
-|------|--------|------|
-| 项目简报 | @analyst | `docs/project-brief.md` |
-| PRD | @pm | `docs/prd.md` |
-| 前端规范 | @ux-expert | `docs/front-end-spec.md` |
-| 全栈架构 | @architect | `docs/fullstack-architecture.md` |
-
-### 可选步骤
-
-| 步骤 | 代理 | 描述 |
-|------|------|------|
-| 头脑风暴 | @analyst | 结构化的想法会议 |
-| 市场研究 | @analyst | 市场和竞争对手分析 |
-| 用户研究 | @ux-expert | 访谈和需求分析 |
-| 技术研究 | @architect | 技术调查 |
-
----
-
-## 第 2 阶段: 文档分片
-
-### 目标
-将 PRD 和架构分割成开发就绪的部分。
-
-### 详细图表
-
-```mermaid
-flowchart TD
-    subgraph FASE2["第 2 阶段: 文档分片"]
-        PHASE1_DONE([第 1 阶段完成]) --> SHARD
-
-        subgraph SHARD["@po: 分片文档"]
-            S1[加载 docs/prd.md]
-            S2[识别 2 级部分]
-            S3[提取每个部分]
-            S4[调整标题级别]
-            S5[创建各个文件]
-            S6[生成 index.md]
-
-            S1 --> S2 --> S3 --> S4 --> S5 --> S6
-        end
-
-        SHARD --> OUTPUT
-
-        subgraph OUTPUT["生成的工件"]
-            O1[docs/prd/index.md]
-            O2[docs/prd/*.md - 部分]
-            O3[docs/architecture/source-tree.md]
-            O4[docs/architecture/tech-stack.md]
-            O5[docs/architecture/coding-standards.md]
-        end
-
-        OUTPUT --> DONE([第 2 阶段完成])
-    end
-```
-
-### 详细步骤
-
-| 步骤 | 代理 | 任务 | 输入 | 输出 | 必需 |
-|------|------|------|------|------|------|
-| 1 | @po (Pax) | `shard-doc.md` | `docs/prd.md` | 包含分片文件的 `docs/prd/` 文件夹 | 是 |
-
-### 分片方法
-
-1. **自动 (推荐)**: 使用 `md-tree explode {input} {output}`
-2. **手动**: 按 2 级标题 (##) 分割
-
-### 创建的工件
-
-| 文件 | 描述 |
-|------|------|
-| `docs/prd/index.md` | 包含所有部分链接的索引 |
-| `docs/prd/*.md` | PRD 的各个部分 |
-| `docs/architecture/source-tree.md` | 项目目录结构 |
-| `docs/architecture/tech-stack.md` | 技术堆栈 |
-| `docs/architecture/coding-standards.md` | 代码标准 |
-
----
-
-## 第 3 阶段: 开发循环
-
-### 目标
-通过质量保证审阅的迭代实施故事。
-
-### 详细图表
-
-```mermaid
-flowchart TD
-    subgraph FASE3["第 3 阶段: 开发循环"]
-        PHASE2_DONE([第 2 阶段完成]) --> STORY_LOOP
-
-        subgraph STORY_LOOP["故事循环"]
-            SM["@sm: *draft"]
-            REVIEW_Q{审阅草稿?}
-            REVIEW["@analyst/@pm: 审阅故事"]
-            DEV["@dev: *develop"]
-            QA_Q{质量保证审阅?}
-            QA["@qa: *review"]
-            QA_ISSUES{发现问题?}
-            FIX["@dev: *apply-qa-fixes"]
-            MORE_Q{更多故事?}
-
-            SM --> REVIEW_Q
-            REVIEW_Q -->|是| REVIEW
-            REVIEW_Q -->|否| DEV
-            REVIEW --> DEV
-            DEV --> QA_Q
-            QA_Q -->|是| QA
-            QA_Q -->|否| MORE_Q
-            QA --> QA_ISSUES
-            QA_ISSUES -->|是| FIX
-            QA_ISSUES -->|否| MORE_Q
-            FIX --> QA
-            MORE_Q -->|是| SM
-        end
-
-        MORE_Q -->|否| RETRO_Q{回顾?}
-        RETRO_Q -->|是| RETRO["@po: 史诗回顾"]
-        RETRO_Q -->|否| DONE
-        RETRO --> DONE([项目完成])
-    end
-```
-
-### 详细步骤
-
-| 步骤 | 代理 | 任务 | 输入 | 输出 | 必需 |
-|------|------|------|------|------|------|
-| 1 | @sm (River) | `sm-create-next-story.md` | 分片的文档 | `{epic}.{story}.story.md` | 是 |
-| 2 | @analyst/@pm | 审阅 | 故事草稿 | 批准的故事 | 可选 |
-| 3 | @dev (Dex) | `dev-develop-story.md` | 批准的故事 | 实现 | 是 |
-| 4 | @qa (Quinn) | `qa-review-story.md` | 实现 | 质量保证反馈 | 可选 |
-| 5 | @dev (Dex) | `apply-qa-fixes.md` | 质量保证反馈 | 应用的更正 | 条件 |
-| 6 | @po (Pax) | 回顾 | 完成的史诗 | 回顾 | 可选 |
-
-### 故事循环
-
-```mermaid
-stateDiagram-v2
-    [*] --> Draft: @sm 创建故事
-    Draft --> Approved: 可选审阅
-    Draft --> InProgress: Dev 接受
-    Approved --> InProgress: Dev 启动
-    InProgress --> Review: Dev 完成
-    Review --> InProgress: QA 发现问题
-    Review --> Done: QA 批准
-    Done --> [*]
-```
-
-### 故事状态
-
-| 状态 | 描述 | 下一步 |
-|------|------|--------|
-| Draft | SM 创建的故事 | 审阅或开发 |
-| Approved | 审阅和批准的故事 | 开发 |
-| In Progress | 开发中 | 质量保证审阅 |
-| Review | 等待审阅 | 质量保证或更正 |
-| Done | 完成和批准 | 下一个故事 |
-
----
-
-## 参与的代理
-
-### 代理表
-
-| 代理 | ID | 图标 | 原型 | 责任 |
-|------|----|----|------|------|
-| Gage | @devops | ⚡ | 操作员 | 环境引导、Git 推送、发布、CI/CD |
-| Atlas | @analyst | 🔍 | 解码器 | 市场研究、头脑风暴、项目简报 |
-| Morgan | @pm | 📋 | 策略师 | PRD、产品策略、史诗 |
-| Uma | @ux-expert | 🎨 | 移情者 | 前端规范、UX、设计系统 |
-| Aria | @architect | 🏛️ | 愿景者 | 全栈架构、技术决策 |
-| Pax | @po | 🎯 | 平衡者 | 工件验证、待办事项、分片 |
-| River | @sm | 🌊 | 促进者 | 故事创建、冲刺规划 |
-| Dex | @dev | 💻 | 建设者 | 代码实现、测试 |
-| Quinn | @qa | ✅ | 守卫者 | 质量审阅、测试、关卡 |
-
-### 代理间交互图表
-
-```mermaid
-graph LR
-    subgraph 规划
-        ANALYST[🔍 Atlas<br>@analyst]
-        PM[📋 Morgan<br>@pm]
-        UX[🎨 Uma<br>@ux-expert]
-        ARCH[🏛️ Aria<br>@architect]
-    end
-
-    subgraph 治理
-        PO[🎯 Pax<br>@po]
-        SM[🌊 River<br>@sm]
-    end
-
-    subgraph 执行
-        DEV[💻 Dex<br>@dev]
-        QA[✅ Quinn<br>@qa]
-        DEVOPS[⚡ Gage<br>@devops]
-    end
-
-    ANALYST -->|project-brief| PM
-    PM -->|prd| UX
-    UX -->|front-end-spec| ARCH
-    ARCH -->|架构| PO
-    PO -->|故事| SM
-    SM -->|故事| DEV
-    DEV -->|实现| QA
-    QA -->|反馈| DEV
-    DEV -->|就绪| DEVOPS
-
-    PM -.->|更新 PRD| ARCH
-    PO -.->|验证| PM
-    PO -.->|验证| ARCH
-```
-
----
-
-## 执行的任务
-
-### 完整任务列表
-
-| 阶段 | 任务 | 代理 | 文件 |
-|------|------|------|------|
-| 0 | 环境引导 | @devops | `environment-bootstrap.md` |
-| 1 | 创建文档 | @analyst、@pm、@ux-expert、@architect | `create-doc.md` |
-| 1 | 促进头脑风暴 | @analyst | `facilitate-brainstorming-session.md` |
-| 1 | 深入研究提示 | @analyst、@pm、@architect | `create-deep-research-prompt.md` |
-| 1 | 生成 AI 前端提示 | @ux-expert | `generate-ai-frontend-prompt.md` |
-| 1 | 执行检查列表 | @po | `execute-checklist.md` |
-| 2 | 分片文档 | @po | `shard-doc.md` |
-| 3 | 创建下一个故事 | @sm | `sm-create-next-story.md` |
-| 3 | 开发故事 | @dev | `dev-develop-story.md` |
-| 3 | 审阅故事 | @qa | `qa-review-story.md` |
-| 3 | 应用质量保证修复 | @dev | `apply-qa-fixes.md` |
-
-### 使用的模板
-
-| 模板 | 代理 | 目的 |
-|------|------|------|
-| `project-brief-tmpl.yaml` | @analyst | 项目简报结构 |
-| `prd-tmpl.yaml` | @pm | PRD 结构 |
-| `front-end-spec-tmpl.yaml` | @ux-expert | 前端规范 |
-| `fullstack-architecture-tmpl.yaml` | @architect | 完整架构 |
-| `story-tmpl.yaml` | @sm | 用户故事模板 |
-
-### 使用的检查列表
-
-| 检查列表 | 代理 | 用途 |
-|---------|------|------|
-| `po-master-checklist.md` | @po | 所有工件验证 |
-| `story-draft-checklist.md` | @sm | 故事草稿质量 |
-| `story-dod-checklist.md` | @dev | 完成定义 |
-
----
-
-## 前置条件
-
-### 系统要求
-
-| 要求 | 最少 | 推荐 |
-|------|------|------|
-| Windows | 10 1809+ | 11 |
-| macOS | 12+ | 14+ |
-| Linux | Ubuntu 20.04+ | Ubuntu 22.04+ |
-| Node.js | 18.x | 20.x |
-| Git | 2.x | 2.43+ |
-
-### 必需工具
-
-| 工具 | 验证命令 | 安装 |
-|------|----------|------|
-| Git | `git --version` | 本地系统 |
-| GitHub CLI | `gh --version` | `winget install GitHub.cli` |
-| Node.js | `node --version` | `winget install OpenJS.NodeJS.LTS` |
-| npm | `npm --version` | 包含在 Node.js 中 |
-
-### 必需的身份验证
-
-| 服务 | 登录命令 | 验证 |
-|------|----------|------|
-| GitHub | `gh auth login` | `gh auth status` |
-| Supabase | `supabase login` | `supabase projects list` |
-| Railway | `railway login` | `railway whoami` |
-
----
-
-## 输入和输出
-
-### 数据流
-
-```mermaid
-flowchart LR
-    subgraph 输入
-        I1[用户需求]
-        I2[市场研究]
-        I3[用户反馈]
-    end
-
-    subgraph 阶段0["阶段 0"]
-        E1[.sinapse/config.yaml]
-        E2[GitHub 仓库]
-    end
-
-    subgraph 阶段1["阶段 1"]
-        P1[project-brief.md]
-        P2[prd.md]
-        P3[front-end-spec.md]
-        P4[fullstack-architecture.md]
-    end
-
-    subgraph 阶段2["阶段 2"]
-        S1[docs/prd/*.md]
-        S2[source-tree.md]
-        S3[tech-stack.md]
-        S4[coding-standards.md]
-    end
-
-    subgraph 阶段3["阶段 3"]
-        D1[故事 .md]
-        D2[源代码]
-        D3[测试]
-    end
-
-    subgraph 输出
-        O1[完整应用]
-        O2[文档]
-        O3[自动化测试]
-    end
-
-    I1 --> E1
-    I2 --> P1
-    I3 --> P1
-
-    E1 --> P1
-    E2 --> P1
-    P1 --> P2
-    P2 --> P3
-    P3 --> P4
-
-    P2 --> S1
-    P4 --> S2
-    P4 --> S3
-    P4 --> S4
-
-    S1 --> D1
-    S2 --> D2
-    S3 --> D2
-    S4 --> D2
-    D1 --> D2
-    D2 --> D3
-
-    D2 --> O1
-    D1 --> O2
-    D3 --> O3
-```
-
-### 按阶段的输入/输出矩阵
-
-| 阶段 | 输入 | 输出 |
-|------|------|------|
-| 0 | 项目名、GitHub 组织 | SINAPSE 配置、Git 仓库、文件夹结构 |
-| 1 | 需求、研究 | 简报、PRD、规范、架构 |
-| 2 | PRD、架构 | 分片文档、索引 |
-| 3 | 故事、分片文档 | 代码、测试、应用 |
-
----
-
-## 决策点
-
-### 决策表
-
-| 阶段 | 决策点 | 选项 | 标准 |
-|------|--------|------|------|
-| 0 | 环境就绪? | 跳过/执行引导 | `.sinapse/environment-report.json` 存在 |
-| 1 | 生成 v0 提示? | 是/否 | 用户想要 AI UI 生成 |
-| 1 | 架构建议更改? | 更新 PRD/继续 | 架构师建议 |
-| 1 | PO 发现问题? | 更正/批准 | 检查列表结果 |
-| 3 | 审阅故事草稿? | 审阅/跳过 dev | 故事复杂性 |
-| 3 | 质量保证审阅? | 是/否 | 故事关键性 |
-| 3 | 更多故事? | 继续/完成 | 史诗待办事项 |
-| 3 | 回顾? | 是/否 | 史诗完成 |
-
-### 决策流程图
-
-```mermaid
-flowchart TD
-    D1{环境就绪?}
-    D1 -->|检查 .sinapse/environment-report.json| D1_CHECK
-    D1_CHECK -->|存在| SKIP[跳过第 0 阶段]
-    D1_CHECK -->|不存在| RUN[执行引导]
-
-    D2{生成 v0 提示?}
-    D2 -->|用户想要 UI 生成| D2_YES[生成提示]
-    D2 -->|不必要| D2_NO[转到架构]
-
-    D3{PRD 中的更改?}
-    D3 -->|架构师推荐| D3_YES[更新 PRD]
-    D3 -->|不必要| D3_NO[继续验证]
-
-    D4{发现问题?}
-    D4 -->|PO 发现问题| D4_YES[与代理更正]
-    D4 -->|一切正常| D4_NO[批准和继续]
-```
-
----
-
-## 故障排除
-
-### 常见问题
-
-#### 第 0 阶段: 环境引导
-
-| 问题 | 原因 | 解决方案 |
-|------|------|---------|
-| `winget` 未识别 | Windows 过期 | 更新 Windows 或使用 `choco`/`scoop` |
-| `gh auth login` 失败 | 连接或代理 | 检查互联网、配置代理 |
-| 仓库权限被拒 | Token 作用域不足 | 使用 `--scopes repo,workflow` 重新认证 |
-| Docker 不启动 | 服务停止 | 启动 Docker Desktop |
-
-#### 第 1 阶段: 规划
-
-| 问题 | 原因 | 解决方案 |
-|------|------|---------|
-| 模板未找到 | 路径错误 | 检查 `.sinapse-ai/development/templates/` |
-| PRD 与架构冲突 | 需求分歧 | 召开 PM 和 Architect 会议对齐 |
-| 检查列表失败 | 工件不完整 | 返回相关代理 |
-
-#### 第 2 阶段: 分片
-
-| 问题 | 原因 | 解决方案 |
-|------|------|---------|
-| `md-tree` 未找到 | 未安装 | `npm install -g @kayvan/markdown-tree-parser` |
-| 未检测到部分 | 格式错误 | 检查文档中的 `##` 标题 |
-| 内容丢失 | 代码块中的 `##` | 使用正确解析的手动方法 |
-
-#### 第 3 阶段: 开发
-
-| 问题 | 原因 | 解决方案 |
-|------|------|---------|
-| 故事不完整 | SM 跳过字段 | 执行 `story-draft-checklist` |
-| 测试失败 | 代码损坏 | @dev 执行 `*run-tests` |
-| QA 阻止 | CRITICAL 问题 | 在继续前与 @dev 解决 |
-| Epic 未在 ClickUp 中找到 | Task 未创建 | 使用正确标签创建 Epic |
-
-### 诊断命令
-
-```bash
-# 检查环境
-cat .sinapse/environment-report.json
-
-# 检查 CLIs
-git --version && gh --version && node --version
-
-# 检查身份验证
-gh auth status
-supabase projects list
-railway whoami
-
-# 检查项目结构
-ls -la .sinapse/
-ls -la docs/
-```
-
----
-
-## 切换提示
-
-### 阶段间转换
-
-| 从 | 到 | 切换提示 |
-|----|-----|----------|
-| 阶段 0 | 阶段 1 | "环境引导完成! Git 仓库已创建,CLIs 已验证,项目结构就绪。使用 @analyst 在新聊天中开始创建项目简报。" |
-| @analyst | @pm | "项目简报完成。将其保存为项目中的 `docs/project-brief.md`,然后创建 PRD。" |
-| @pm | @ux-expert | "PRD 就绪。将其保存为项目中的 `docs/prd.md`,然后创建 UI/UX 规范。" |
-| @ux-expert | @architect | "UI/UX 规范完成。将其保存为项目中的 `docs/front-end-spec.md`,然后创建全栈架构。" |
-| @architect | @po | "架构完成。将其保存为 `docs/fullstack-architecture.md`。您建议对 PRD 故事进行更改或需要新故事吗?" |
-| 阶段 1 | 阶段 2 | "所有规划工件已验证。现在为开发分片文档: @po → *shard-doc docs/prd.md" |
-| 阶段 2 | 阶段 3 | "文档已分片! source-tree.md、tech-stack.md、coding-standards.md 已创建。开始开发: @sm → *draft" |
-| 完成 | - | "所有故事已实施和审阅。项目的开发阶段完成!" |
-
----
-
-## 参考
-
-### 相关文件
-
-| 类型 | 文件 | 描述 |
-|------|------|------|
-| 工作流 | `.sinapse-ai/development/workflows/greenfield-fullstack.yaml` | 工作流定义 |
-| 任务 | `.sinapse-ai/development/tasks/environment-bootstrap.md` | 环境引导 |
-| 任务 | `.sinapse-ai/development/tasks/shard-doc.md` | 文档分片 |
-| 任务 | `.sinapse-ai/development/tasks/sm-create-next-story.md` | 故事创建 |
-| 代理 | `.sinapse-ai/development/agents/*.md` | 代理定义 |
-| 模板 | `.sinapse-ai/development/templates/*.yaml` | 文档模板 |
-| 检查列表 | `.sinapse-ai/development/checklists/*.md` | 验证检查列表 |
-
-### 外部文档
-
-| 资源 | URL |
-|------|-----|
-| GitHub CLI | https://cli.github.com/manual/ |
-| Supabase CLI | https://supabase.com/docs/guides/cli |
-| Railway CLI | https://docs.railway.app/reference/cli-api |
-| CodeRabbit | https://coderabbit.ai/docs |
-
----
-
-## 版本历史
-
-| 版本 | 日期 | 更改 |
-|------|------|------|
-| 1.0.0 | 2026-02-04 | 初始完整文档 |
-
----
-
-**维护者:** SINAPSE 开发团队
-**最后审阅:** 2026-02-04