breakdown-plan

breakdown-plan

熱門

Issue Planning and Automation 提示詞,可產生包含 Epic > Feature > Story/Enabler > Test 層級、相依性、優先順序及自動化追蹤的完整專案計畫。

3.6萬星標
4556分支
更新於 2026/7/13
SKILL.md
readonlyread-only
name
breakdown-plan
description

Issue Planning and Automation 提示詞,可產生包含 Epic > Feature > Story/Enabler > Test 層級、相依性、優先順序及自動化追蹤的完整專案計畫。

GitHub Issue 規劃與專案自動化提示詞

目標

扮演資深專案經理與 DevOps 專家,熟悉敏捷方法論與 GitHub 專案管理。你的任務是取得完整的功能產出(PRD、UX 設計、技術拆解、測試計畫),並產生一份完整的 GitHub 專案計畫,包含自動化 issue 建立、相依性連結、優先順序指派與看板式追蹤。

GitHub 專案管理最佳實務

敏捷工作項目層級

  • Epic:涵蓋多個功能的大型業務能力(里程碑層級)
  • Feature:Epic 內可交付的使用者面向功能
  • Story:以使用者為中心的需求,能獨立交付價值
  • Enabler:支援 Story 的技術基礎設施或架構工作
  • Test:驗證 Story 與 Enabler 的品質保證工作
  • Task:Story/Enabler 的實作層級工作拆解

專案管理原則

  • INVEST 準則:獨立、可協商、有價值、可估算、小型、可測試
  • 就緒定義:開始工作前需有明確的驗收條件
  • 完成定義:品質關卡與完成條件
  • 相依性管理:明確的阻擋關係與關鍵路徑識別
  • 價值導向優先排序:商業價值 vs. 工作量矩陣以利決策

輸入需求

使用此提示詞前,請確保擁有完整的測試工作流程產出:

核心功能文件

  1. Feature PRD/docs/ways-of-work/plan/{epic-name}/{feature-name}.md
  2. 技術拆解/docs/ways-of-work/plan/{epic-name}/{feature-name}/technical-breakdown.md
  3. 實作計畫/docs/ways-of-work/plan/{epic-name}/{feature-name}/implementation-plan.md

相關規劃提示詞

  • 測試規劃:使用 plan-test 提示詞進行完整測試策略、品質保證規劃與測試 issue 建立
  • 架構規劃:使用 plan-epic-arch 提示詞進行系統架構與技術設計
  • 功能規劃:使用 plan-feature-prd 提示詞進行詳細功能需求與規格

輸出格式

建立兩個主要交付物:

  1. 專案計畫/docs/ways-of-work/plan/{epic-name}/{feature-name}/project-plan.md
  2. Issue 建立檢查清單/docs/ways-of-work/plan/{epic-name}/{feature-name}/issues-checklist.md

專案計畫結構

1. 專案概覽
  • 功能摘要:簡短描述與商業價值
  • 成功標準:可衡量的成果與 KPI
  • 關鍵里程碑:主要交付物拆解(不含時間線)
  • 風險評估:潛在阻礙與緩解策略
2. 工作項目層級
graph TD
    A[Epic: {Epic Name}] --> B[Feature: {Feature Name}]
    B --> C[Story 1: {User Story}]
    B --> D[Story 2: {User Story}]
    B --> E[Enabler 1: {Technical Work}]
    B --> F[Enabler 2: {Infrastructure}]

    C --> G[Task: Frontend Implementation]
    C --> H[Task: API Integration]
    C --> I[Test: E2E Scenarios]

    D --> J[Task: Component Development]
    D --> K[Task: State Management]
    D --> L[Test: Unit Tests]

    E --> M[Task: Database Schema]
    E --> N[Task: Migration Scripts]

    F --> O[Task: CI/CD Pipeline]
    F --> P[Task: Monitoring Setup]
3. GitHub Issues 拆解
Epic Issue 範本
# Epic: {Epic Name}

## Epic 描述

{Epic 摘要(來自 PRD)}

## 商業價值

- **主要目標**:{主要業務目標}
- **成功指標**:{KPI 與可衡量成果}
- **使用者影響**:{使用者如何受益}

## Epic 驗收條件

- [ ] {高階需求 1}
- [ ] {高階需求 2}
- [ ] {高階需求 3}

## 此 Epic 中的功能

- [ ] #{feature-issue-number} - {Feature Name}

## 完成定義

- [ ] 所有功能故事完成
- [ ] 端到端測試通過
- [ ] 效能基準達標
- [ ] 文件已更新
- [ ] 使用者驗收測試完成

## 標籤

`epic`, `{priority-level}`, `{value-tier}`

## 里程碑

{發行版本/日期}

## 估算

{Epic 層級 T-shirt 尺寸:XS, S, M, L, XL, XXL}
Feature Issue 範本
# Feature: {Feature Name}

## 功能描述

{功能摘要(來自 PRD)}

## 此功能中的使用者故事

- [ ] #{story-issue-number} - {User Story Title}
- [ ] #{story-issue-number} - {User Story Title}

## 技術 Enabler

- [ ] #{enabler-issue-number} - {Enabler Title}
- [ ] #{enabler-issue-number} - {Enabler Title}

## 相依性

**阻擋**:{此功能阻擋的 issue 清單}
**被阻擋**:{阻擋此功能的 issue 清單}

## 驗收條件

- [ ] {功能層級需求 1}
- [ ] {功能層級需求 2}

## 完成定義

- [ ] 所有使用者故事已交付
- [ ] 技術 Enabler 已完成
- [ ] 整合測試通過
- [ ] UX 審查已核准
- [ ] 效能測試已完成

## 標籤

`feature`, `{priority-level}`, `{value-tier}`, `{component-name}`

## Epic

#{epic-issue-number}

## 估算

{故事點數或 T-shirt 尺寸}
User Story Issue 範本
# User Story: {Story Title}

## 故事陳述

身為一個 **{使用者類型}**,我想要 **{目標}**,以便 **{效益}**。

## 驗收條件

- [ ] {具體可測試需求 1}
- [ ] {具體可測試需求 2}
- [ ] {具體可測試需求 3}

## 技術任務

- [ ] #{task-issue-number} - {實作任務}
- [ ] #{task-issue-number} - {整合任務}

## 測試需求

- [ ] #{test-issue-number} - {測試實作}

## 相依性

**被阻擋**:{必須先完成的相依性}

## 完成定義

- [ ] 驗收條件已滿足
- [ ] 程式碼審查已核准
- [ ] 單元測試已撰寫且通過
- [ ] 整合測試通過
- [ ] UX 設計已實作
- [ ] 無障礙需求已滿足

## 標籤

`user-story`, `{priority-level}`, `frontend/backend/fullstack`, `{component-name}`

## Feature

#{feature-issue-number}

## 估算

{故事點數:1, 2, 3, 5, 8}
Technical Enabler Issue 範本
# Technical Enabler: {Enabler Title}

## Enabler 描述

{支援使用者故事所需的技術工作}

## 技術需求

- [ ] {技術需求 1}
- [ ] {技術需求 2}

## 實作任務

- [ ] #{task-issue-number} - {實作細節}
- [ ] #{task-issue-number} - {基礎設施設定}

## 啟用的使用者故事

此 Enabler 支援:

- #{story-issue-number} - {故事標題}
- #{story-issue-number} - {故事標題}

## 驗收條件

- [ ] {技術驗證 1}
- [ ] {技術驗證 2}
- [ ] 效能基準達標

## 完成定義

- [ ] 實作完成
- [ ] 單元測試已撰寫
- [ ] 整合測試通過
- [ ] 文件已更新
- [ ] 程式碼審查已核准

## 標籤

`enabler`, `{priority-level}`, `infrastructure/api/database`, `{component-name}`

## Feature

#{feature-issue-number}

## 估算

{故事點數或工作量估算}
4. 優先順序與價值矩陣
優先順序 價值 條件 標籤
P0 關鍵路徑,阻擋發行 priority-critical, value-high
P1 核心功能,使用者面向 priority-high, value-high
P1 核心功能,內部使用 priority-high, value-medium
P2 重要但不阻擋 priority-medium, value-medium
P3 有則更好,技術債 priority-low, value-low
5. 估算指南
故事點數規模(費氏數列)
  • 1 點:簡單變更,<4 小時
  • 2 點:小型功能,<1 天
  • 3 點:中型功能,1-2 天
  • 5 點:大型功能,3-5 天
  • 8 點:複雜功能,1-2 週
  • 13+ 點:Epic 層級工作,需要拆解
T-Shirt 尺寸(Epic/Feature)
  • XS:總共 1-2 故事點數
  • S:總共 3-8 故事點數
  • M:總共 8-20 故事點數
  • L:總共 20-40 故事點數
  • XL:總共 40+ 故事點數(考慮拆解)
6. 相依性管理
graph LR
    A[Epic 規劃] --> B[功能定義]
    B --> C[Enabler 實作]
    C --> D[故事開發]
    D --> E[測試執行]
    E --> F[功能交付]

    G[基礎設施設定] --> C
    H[API 設計] --> D
    I[資料庫 Schema] --> C
    J[驗證] --> D
相依性類型
  • 阻擋:此項完成前無法繼續的工作
  • 相關:共享上下文但不阻擋的工作
  • 前置條件:所需的基礎設施或設定工作
  • 平行:可同時進行的工作
7. Sprint 規劃範本
Sprint 容量規劃
  • 團隊速度:{每個 Sprint 的平均故事點數}
  • Sprint 長度:{建議 2 週 Sprint}
  • 緩衝分配:20% 用於意外工作與錯誤修正
  • 專注因子:70-80% 的總時間用於規劃工作
Sprint 目標定義
## Sprint {N} 目標

**主要目標**:{此 Sprint 的主要交付物}

**Sprint 中的故事**:

- #{issue} - {故事標題} ({points} 點)
- #{issue} - {故事標題} ({points} 點)

**總承諾**:{points} 故事點數
**成功標準**:{可衡量的成果}
8. GitHub 專案看板設定
欄位結構(看板)
  1. 待辦事項:已排序且準備規劃
  2. Sprint 就緒:已詳細說明並估算,準備開發
  3. 進行中:正在處理
  4. 審查中:程式碼審查、測試或利害關係人審查
  5. 測試中:QA 驗證與驗收測試
  6. 完成:已完成且驗收
自訂欄位設定
  • 優先順序:P0, P1, P2, P3
  • 價值:高, 中, 低
  • 元件:前端, 後端, 基礎設施, 測試
  • 估算:故事點數或 T-shirt 尺寸
  • Sprint:目前 Sprint 指派
  • 負責人:負責的團隊成員
  • Epic:父 Epic 參考
9. 自動化與 GitHub Actions
自動化 Issue 建立
name: 建立功能 Issues

on:
  workflow_dispatch:
    inputs:
      feature_name:
        description: '功能名稱'
        required: true
      epic_issue:
        description: 'Epic issue 編號'
        required: true

jobs:
  create-issues:
    runs-on: ubuntu-latest
    steps:
      - name: 建立功能 Issue
        uses: actions/github-script@v7
        with:
          script: |
            const { data: epic } = await github.rest.issues.get({
              owner: context.repo.owner,
              repo: context.repo.repo,
              issue_number: ${{ github.event.inputs.epic_issue }}
            });

            const featureIssue = await github.rest.issues.create({
              owner: context.repo.owner,
              repo: context.repo.repo,
              title: `Feature: ${{ github.event.inputs.feature_name }}`,
              body: `# Feature: ${{ github.event.inputs.feature_name }}\n\n...`,
              labels: ['feature', 'priority-medium'],
              milestone: epic.data.milestone?.number
            });
自動化狀態更新
name: 更新 Issue 狀態

on:
  pull_request:
    types: [opened, closed]

jobs:
  update-status:
    runs-on: ubuntu-latest
    steps:
      - name: 移至審查中
        if: github.event.action == 'opened'
        uses: actions/github-script@v7
        # 將相關 issue 移至「審查中」欄位

      - name: 移至完成
        if: github.event.action == 'closed' && github.event.pull_request.merged
        uses: actions/github-script@v7
        # 將相關 issue 移至「完成」欄位

Issue 建立檢查清單

建立前準備
  • [ ] 功能產出完整:PRD、UX 設計、技術拆解、測試計畫
  • [ ] Epic 已存在:父 Epic issue 已建立,並有適當標籤與里程碑
  • [ ] 專案看板已設定:欄位、自訂欄位與自動化規則已設定
  • [ ] 團隊容量已評估:Sprint 規劃與資源分配已完成
Epic 層級 Issues
  • [ ] Epic issue 已建立,包含完整描述與驗收條件
  • [ ] Epic 里程碑已建立,包含目標發行日期
  • [ ] Epic 標籤已套用epic、優先順序、價值與團隊標籤
  • [ ] Epic 已加入專案看板,置於適當欄位
Feature 層級 Issues
  • [ ] Feature issue 已建立,連結至父 Epic
  • [ ] 功能相依性已識別並記錄
  • [ ] 功能估算已完成,使用 T-shirt 尺寸
  • [ ] 功能驗收條件已定義,包含可衡量的成果
Story/Enabler 層級 Issues 記錄於 /docs/ways-of-work/plan/{epic-name}/{feature-name}/issues-checklist.md
  • [ ] 使用者故事已建立,遵循 INVEST 準則
  • [ ] 技術 Enabler 已識別並排序優先順序
  • [ ] 故事點數估算已指派,使用費氏數列
  • [ ] 相依性已對應,在故事與 Enabler 之間
  • [ ] 驗收條件已詳細說明,包含可測試的需求

成功指標

專案管理 KPI

  • Sprint 可預測性:每個 Sprint 完成 >80% 的承諾工作
  • 週期時間:從「進行中」到「完成」平均 <5 個工作日
  • 前置時間:從「待辦事項」到「完成」平均 <2 週
  • 缺陷逃逸率:<5% 的故事需要發行後修正
  • 團隊速度:跨 Sprint 一致的故事點數交付

流程效率指標

  • Issue 建立時間:建立完整功能拆解 <1 小時
  • 相依性解決時間:解決阻擋相依性 <24 小時
  • 狀態更新準確率:>95% 自動化狀態轉換正確運作
  • 文件完整性:100% 的 issue 具有所需範本欄位
  • 跨團隊協作:外部相依性解決 <2 個工作日

專案交付指標

  • 完成定義遵循度:100% 的已完成故事符合 DoD 條件
  • 驗收條件覆蓋率:100% 的驗收條件已驗證
  • Sprint 目標達成率:>90% 的 Sprint 目標成功交付
  • 利害關係人滿意度:>90% 的利害關係人核准已完成功能
  • 規劃準確度:估算與實際交付時間差異 <10%

此全面的 GitHub 專案管理方法確保從 Epic 層級規劃到個別實作任務的完整可追溯性,並具備自動化追蹤與所有團隊成員的明確責任歸屬。