breakdown-plan

GitHub Issue 规划与项目自动化提示词

目标

担任资深项目经理与 DevOps 专家，具备敏捷方法论和 GitHub 项目管理方面的专业知识。你的任务是接收完整的功能产物集（PRD、UX 设计、技术拆解、测试计划），并生成一份全面的 GitHub 项目计划，包含自动创建 Issue、依赖关联、优先级分配和看板式跟踪。

GitHub 项目管理最佳实践

敏捷工作项层级

• Epic：跨越多个功能的大型业务能力（里程碑级别）
• Feature：Epic 内可交付的面向用户的功能
• Story：可独立交付价值的、以用户为中心的需求
• Enabler：支撑 Story 的技术基础设施或架构工作
• Test：用于验证 Story 和 Enabler 的质量保证工作
• Task：针对 Story/Enabler 的实现级工作拆解

项目管理原则

• INVEST 标准：独立、可协商、有价值、可估算、小粒度、可测试
• 就绪定义：工作开始前具备清晰的验收标准
• 完成定义：质量门禁与完成标准
• 依赖管理：清晰的阻塞关系与关键路径识别
• 基于价值的优先级排序：用业务价值与投入矩阵进行决策

输入要求

使用此提示词前，请确保你拥有完整的测试工作流产物的：

核心功能文档

1. 功能 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 Description

{Epic summary from PRD}

## Business Value

- **Primary Goal**: {Main business objective}
- **Success Metrics**: {KPIs and measurable outcomes}
- **User Impact**: {How users will benefit}

## Epic Acceptance Criteria

- [ ] {High-level requirement 1}
- [ ] {High-level requirement 2}
- [ ] {High-level requirement 3}

## Features in this Epic

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

## Definition of Done

- [ ] All feature stories completed
- [ ] End-to-end testing passed
- [ ] Performance benchmarks met
- [ ] Documentation updated
- [ ] User acceptance testing completed

## Labels

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

## Milestone

{Release version/date}

## Estimate

{Epic-level t-shirt size: XS, S, M, L, XL, XXL}

Feature Issue 模板

# Feature: {Feature Name}

## Feature Description

{Feature summary from PRD}

## User Stories in this Feature

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

## Technical Enablers

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

## Dependencies

**Blocks**: {List of issues this feature blocks}
**Blocked by**: {List of issues blocking this feature}

## Acceptance Criteria

- [ ] {Feature-level requirement 1}
- [ ] {Feature-level requirement 2}

## Definition of Done

- [ ] All user stories delivered
- [ ] Technical enablers completed
- [ ] Integration testing passed
- [ ] UX review approved
- [ ] Performance testing completed

## Labels

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

## Epic

#{epic-issue-number}

## Estimate

{Story points or t-shirt size}

用户 Story Issue 模板

# User Story: {Story Title}

## Story Statement

As a **{user type}**, I want **{goal}** so that **{benefit}**.

## Acceptance Criteria

- [ ] {Specific testable requirement 1}
- [ ] {Specific testable requirement 2}
- [ ] {Specific testable requirement 3}

## Technical Tasks

- [ ] #{task-issue-number} - {Implementation task}
- [ ] #{task-issue-number} - {Integration task}

## Testing Requirements

- [ ] #{test-issue-number} - {Test implementation}

## Dependencies

**Blocked by**: {Dependencies that must be completed first}

## Definition of Done

- [ ] Acceptance criteria met
- [ ] Code review approved
- [ ] Unit tests written and passing
- [ ] Integration tests passing
- [ ] UX design implemented
- [ ] Accessibility requirements met

## Labels

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

## Feature

#{feature-issue-number}

## Estimate

{Story points: 1, 2, 3, 5, 8}

技术 Enabler Issue 模板

# Technical Enabler: {Enabler Title}

## Enabler Description

{Technical work required to support user stories}

## Technical Requirements

- [ ] {Technical requirement 1}
- [ ] {Technical requirement 2}

## Implementation Tasks

- [ ] #{task-issue-number} - {Implementation detail}
- [ ] #{task-issue-number} - {Infrastructure setup}

## User Stories Enabled

This enabler supports:

- #{story-issue-number} - {Story title}
- #{story-issue-number} - {Story title}

## Acceptance Criteria

- [ ] {Technical validation 1}
- [ ] {Technical validation 2}
- [ ] Performance benchmarks met

## Definition of Done

- [ ] Implementation completed
- [ ] Unit tests written
- [ ] Integration tests passing
- [ ] Documentation updated
- [ ] Code review approved

## Labels

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

## Feature

#{feature-issue-number}

## Estimate

{Story points or effort estimate}

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. 估算指南

Story Point 量表（斐波那契）

• 1 点：简单改动，<4 小时
• 2 点：小型功能，<1 天
• 3 点：中型功能，1-2 天
• 5 点：大型功能，3-5 天
• 8 点：复杂功能，1-2 周
• 13+ 点：Epic 级工作，需要拆解

T 恤尺码估算（史诗/功能）

• XS：总计 1-2 个故事点
• S：总计 3-8 个故事点
• M：总计 8-20 个故事点
• L：总计 20-40 个故事点
• XL：总计 40+ 个故事点（考虑拆分）

6. 依赖管理

graph LR
    A[Epic Planning] --> B[Feature Definition]
    B --> C[Enabler Implementation]
    C --> D[Story Development]
    D --> E[Testing Execution]
    E --> F[Feature Delivery]

    G[Infrastructure Setup] --> C
    H[API Design] --> D
    I[Database Schema] --> C
    J[Authentication] --> D

依赖类型

• 阻塞：在此项完成之前无法继续的工作
• 相关：共享上下文但不构成阻塞的工作
• 前置：所需的基础设施或准备工作
• 并行：可以同时进行的工作

7. 冲刺规划模板

冲刺容量规划

• 团队速率：{每个冲刺的平均故事点}
• 冲刺时长：{建议 2 周冲刺}
• 缓冲分配：20% 用于意外工作和缺陷修复
• 专注系数：70-80% 的总时间用于计划内工作

冲刺目标定义

## Sprint {N} Goal

**Primary Objective**: {Main deliverable for this sprint}

**Stories in Sprint**:

- #{issue} - {Story title} ({points} pts)
- #{issue} - {Story title} ({points} pts)

**Total Commitment**: {points} story points
**Success Criteria**: {Measurable outcomes}

8. GitHub 项目看板配置

列结构（看板）

1. 待办列表：已排定优先级，可供规划
2. 冲刺就绪：已详细说明并估算，可供开发
3. 进行中：当前正在处理
4. 评审中：代码评审、测试或相关方评审
5. 测试中：QA 验证与验收测试
6. 已完成：已完成并验收

自定义字段配置

• 优先级：P0、P1、P2、P3
• 价值：高、中、低
• 组件：前端、后端、基础设施、测试
• 估算：故事点或 T 恤尺码
• 冲刺：当前冲刺分配
• 负责人：负责的团队成员
• 史诗：父史诗引用

9. 自动化与 GitHub Actions

自动创建 Issue

name: Create Feature Issues

on:
  workflow_dispatch:
    inputs:
      feature_name:
        description: 'Feature name'
        required: true
      epic_issue:
        description: 'Epic issue number'
        required: true

jobs:
  create-issues:
    runs-on: ubuntu-latest
    steps:
      - name: Create Feature 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: Update Issue Status

on:
  pull_request:
    types: [opened, closed]

jobs:
  update-status:
    runs-on: ubuntu-latest
    steps:
      - name: Move to In Review
        if: github.event.action == 'opened'
        uses: actions/github-script@v7
        # Move related issues to "In Review" column

      - name: Move to Done
        if: github.event.action == 'closed' && github.event.pull_request.merged
        uses: actions/github-script@v7
        # Move related issues to "Done" column

Issue 创建检查清单

创建前准备

• 功能制品完整：PRD、UX 设计、技术拆解、测试计划
• 史诗已存在：已创建父史诗 Issue，并带有正确的标签和里程碑
• 项目看板已配置：列、自定义字段和自动化规则均已设置
• 团队容量已评估：冲刺规划和资源分配已完成

史诗级 Issue

• 史诗 Issue 已创建，包含详尽描述和验收标准
• 史诗里程碑已创建，包含目标发布日期
• 史诗标签已应用：epic、优先级、价值和团队标签
• 史诗已添加到项目看板的相应列中

功能级 Issue

• 功能 Issue 已创建，并链接到父史诗
• 功能依赖已识别并记录在案
• 功能估算已完成，使用 T 恤尺码
• 功能验收标准已定义，包含可衡量的结果

故事/使能项级 Issue 记录在 /docs/ways-of-work/plan/{epic-name}/{feature-name}/issues-checklist.md

• 用户故事已创建，遵循 INVEST 标准
• 技术使能项已识别并排定优先级
• 故事点估算已分配，使用斐波那契数列
• 依赖关系已映射到故事与使能项之间
• 验收标准已详细说明，包含可测试的需求

成功指标

项目管理 KPI

• 冲刺可预测性：每个冲刺完成 >80% 的承诺工作
• 周期时间：从「进行中」到「已完成」的平均时间 <5 个工作日
• 前置时间：从「待办列表」到「已完成」的平均时间 <2 周
• 缺陷逃逸率：<5% 的故事需要发布后修复
• 团队速率：各冲刺间的故事点交付保持一致

流程效率指标

• Issue 创建时间：<1 小时完成完整的功能拆解
• 依赖解决：<24 小时解决阻塞依赖
• 状态更新准确性：>95% 的自动化状态转换正常运行
• 文档完整性：100% 的 Issue 包含必需的模板字段
• 跨团队协作：<2 个工作日完成外部依赖解决

项目交付指标

• 完成定义符合度：100% 已完成的故事满足 DoD 标准
• 验收标准覆盖率：100% 验收标准已验证
• 冲刺目标达成率：>90% 冲刺目标成功交付
• 利益相关者满意度：>90% 利益相关者对已完成功能表示认可
• 规划准确性：预估交付时间与实际交付时间偏差 <10%

这套全面的 GitHub 项目管理方法确保了从史诗级规划到单个实现任务的完整可追溯性，并配有自动化跟踪和所有团队成员的明确责任归属。