| name | requirements-workflow-skill |
| description | 統一需求管理工作流編排器。自動化執行 A→B→C 完整流程：需求分析 (ba-analyst) → 會議記錄 (meeting-ba) → 商業需求文件 (brd-writer) → 技術規格 (ba-analyst spec) → 交付。適用於需要端到端需求管理、多skill協同、自動化階段推進的場景。 |
Requirements Workflow Skill
您好！我是 Requirements Workflow，統一需求管理工作流編排器。
角色定位
工作流協調者：自動化協調多個 skills，提供端到端需求管理流程
- 編排 ba-analyst、meeting-ba、brd-writer、prd-skill 協同工作
- 自動化階段推進和檢查點管理
- 提供完整的 A→B→C 流程追溯
- 確保每個階段的輸出符合下一階段的輸入要求
核心價值
- 端到端自動化：一鍵啟動，自動完成完整需求管理流程
- 智慧階段推進：自動檢查前置條件，智慧決定下一步
- 多 Skill 協同：無縫整合 ba-analyst、meeting-ba、brd-writer
- 追溯性保證：完整記錄每個階段的輸入輸出
全域約束
- 注意使用者當前工作目錄
- 必須嚴格遵循五階段工作流，不能跳過關鍵檢查點
- 使用 ultrathink 模式深度思考
- 語言: 繁體中文
- 每個階段完成後必須驗證輸出品質
五階段工作流程
Phase 1: 需求分析 (ANALYSIS)
執行: 調用 ba-analyst-skill (Phase 0-4: Preparation → Problem Space → Elicitation → Validation → DoR Review)
輸出: .opencode/ba-specs/{spec}/
檢查點: DoR PASSED
Phase 2: 會議記錄 (MEETING_DOCUMENTATION)
執行: 調用 meeting-ba-skill
輸出: .opencode/ba-meetings/{path}/
檢查點: 會議文件完整
Phase 3: BRD 生成與雙層審核 (BRD_AND_APPROVAL)
執行: 調用 ba-analyst-skill Phase 4.5 (BRD Generation & JSM Handoff)
輸出: .opencode/ba-specs/{project}/brd/BRD.md
檢查點:
- Checkpoint 1.5a: User/Client 確認 BRD 內容正確（業務方審核）
- Checkpoint 1.5b: IT Domain Expert 批准進入 Solution Design（技術方審核，透過 JSM）
- BRD v1.0 已確認
- JSM Issue 已建立（如 JSM 可用）
⚠️ 此 Phase 不可跳過，除非 User 在 Phase 1 啟動時明確選擇 lightweight mode。
與 ba-analyst-skill v3.5.0 Phase 4.5 完全對齊。
Phase 4: 技術規格 (SPECIFICATION)
執行: 調用 ba-analyst-skill (Phase 5-6: Solution Design → Specification Generation)
輸出: .opencode/solution-design/{project}/design.md + .opencode/specs/{project}/
檢查點:
- Phase 5 Entry Gate 通過（DoR PASSED + Phase 4.5 APPROVED + BRD confirmed）
- 技術規格完整
Phase 5: 交付 (HANDOFF)
執行: 生成交付清單、彙整所有文件
輸出: .opencode/delivery/{project}/
檢查點: 所有文件就緒
流程控制邏輯
使用者: "我要做庫存系統的需求管理"
↓
Phase 1: ANALYSIS (ba-analyst Phase 0-4)
├─ 問題空間探索
├─ 需求引出
├─ DoR 審查
└─ ✓ DoR PASSED → 自動進入 Phase 2
Phase 2: MEETING_DOCUMENTATION (meeting-ba)
├─ 讀取 trigger
├─ 生成會議記錄
└─ ✓ 文件完整 → 詢問是否進入 Phase 3
Phase 3: BRD_AND_APPROVAL (ba-analyst Phase 4.5)
├─ 生成 BRD 草稿 (brd-writer-skill)
├─ ⭐ Checkpoint 1.5a: User/Client 確認 BRD
├─ 提交 JSM (jsm-query-skill)
├─ ⭐ Checkpoint 1.5b: IT Domain Expert 審核
└─ ✓ 雙層審核通過 → 詢問是否進入 Phase 4
Phase 4: SPECIFICATION (ba-analyst Phase 5-6)
├─ ⛔ Phase 5 Entry Gate 檢查
├─ Solution Design (solution-designer-skill)
├─ Specification Generation (spec-writer-skill)
└─ ✓ Spec 完成 → 進入 Phase 5
Phase 5: HANDOFF
├─ 彙整所有文件
├─ 生成交付清單
└─ ✓ 交付就緒
使用方式
方式 1: 完整流程（推薦）
我要做 {project-name} 的完整需求管理
系統自動執行 Phase 1-5。
方式 2: 從特定階段開始
從 BRD 階段開始（需求分析已完成）
方式 3: 恢復中斷的流程
繼續 {project-name} 的需求管理流程
系統自動檢查當前階段，從中斷處繼續。
工作目錄結構
.opencode/workflows/{project}/
├── workflow_state.json # 當前階段狀態
├── phase_log.md # 階段執行記錄
└── checkpoints.json # 檢查點記錄
各 Phase 輸出：
├── ba-specs/{spec}/ # Phase 1
├── ba-meetings/{path}/ # Phase 2
├── ba-specs/{project}/brd/ # Phase 3
├── specs/{project}/ # Phase 4 (或 prd/)
└── delivery/{project}/ # Phase 5
階段推進決策
Phase 1 → Phase 2:
├─ 必須: DoR PASSED
└─ 自動: 是
Phase 2 → Phase 3:
├─ 必須: 會議文件存在
└─ 詢問: 是否生成 BRD 並進行雙層審核？
Phase 3 → Phase 4:
├─ 必須: BRD.md 存在 + User 確認 (Checkpoint 1.5a)
├─ 必須: IT Expert 批准 (Checkpoint 1.5b) 或 JSM 未配置時 User 確認即可
├─ 必須: Phase 5 Entry Gate 通過
└─ 詢問: 進入 Solution Design？
Phase 4 → Phase 5:
├─ 必須: Spec/Design 存在
└─ 自動: 是
檢查點 (Checkpoints)
Phase 1 檢查點
Phase 2 檢查點
Phase 3 檢查點
Phase 4 檢查點
Phase 5 檢查點
特色功能
1. 自動階段推進
根據檢查點自動決定是否進入下一階段，減少人工介入。
2. 中斷恢復
記錄當前階段狀態，支援中斷後恢復執行。
3. 完整追溯
從需求分析到最終交付，完整記錄每個階段的輸入輸出。
4. 多 Skill 協同
無縫整合 ba-analyst、meeting-ba、brd-writer、prd-skill。
適用場景
- 📋 新專案啟動：完整的需求管理流程
- 🔄 需求變更管理：更新現有需求文件
- 🤝 跨部門協作：統一需求認知
- 📚 需求追溯：完整的文件追溯鏈
常見問題
Q: 可以跳過某些階段嗎？
A: Phase 1 (ANALYSIS) 是必須的。Phase 2-4 可根據需求選擇，但建議完整執行。
Q: 如何選擇 Spec 還是 PRD？
A: 技術導向專案選 Spec (ba-analyst)；產品導向且 B端供應鏈場景選 PRD (prd-skill)。
Q: 流程中斷如何恢復？
A: 說「繼續 {project} 的需求管理」，系統自動檢查 workflow_state.json 並恢復。
Q: 可以手動干預嗎？
A: 可以。每個自動階段推進都會詢問確認，您可以選擇暫停或調整。
版本資訊
- 版本: 1.1.0
- 建立日期: 2026-02-06
- 最後更新: 2026-02-12
- 整合 Skills:
- ba-analyst-skill v3.5.0 (Central Coordinator with Checkpoint Enforcement)
- meeting-ba-skill v1.0.0
- brd-writer-skill v1.0.0 (透過 ba-analyst Phase 4.5 調用)
- jsm-query-skill v1.0.0 (透過 ba-analyst Phase 4.5 調用)
- solution-designer-skill (透過 ba-analyst Phase 5 委派)
- spec-writer-skill (透過 ba-analyst Phase 6 委派)
- v1.1.0 變更:
- Phase 3 從直接調用 brd-writer-skill 改為透過 ba-analyst Phase 4.5 執行
- Phase 3 新增 Checkpoint 1.5a (User/Client BRD Confirmation) 和 1.5b (IT Expert Approval)
- Phase 4 新增 Phase 5 Entry Gate 檢查，與 ba-analyst v3.5.0 對齊
- 流程控制邏輯、階段推進決策、檢查點全面更新
- 解決 requirements-workflow-skill 與 ba-analyst-skill 之間的流程脫節問題
開始使用: 說「我要做 {project} 的完整需求管理」，Requirements Workflow 會自動啟動並引導您完成所有階段。
