Projects看板

3 minIntermediate2026/6/14

GitHub Projects看板：项目管理、自动化工作流与视图配置。

1. Projects 概述

1.1 什么是 GitHub Projects

GitHub Projects 是内置的项目管理工具，支持看板视图、表格视图和路线图，可以关联 Issue、PR 和草稿。

1.2 Projects V2 特性

特性	说明
多视图	看板、表格、路线图
自定义字段	文本、数字、日期、单选、迭代
自动化	状态变更自动移动卡片
过滤器	按字段筛选和分组
跨仓库	聚合多个仓库的 Issue

2. 创建项目

2.1 创建组织项目

组织页面 → Projects → New project
选择模板（Board / Table / Roadmap）
添加仓库和团队

2.2 创建仓库项目

仓库 → Projects → New project
自动关联当前仓库

3. 自定义字段

3.1 字段类型

类型	说明	示例
Text	自由文本	备注、描述
Number	数字	优先级、故事点
Date	日期	截止日期
Single select	单选	状态、类型
Iteration	迭代周期	Sprint 1、Sprint 2

3.2 推荐字段配置

Status: Backlog → Todo → In Progress → In Review → Done
Priority:  Critical →  High →  Medium →  Low
Type:  Bug →  Feature →  Chore →  Docs
Sprint: Sprint 1, Sprint 2, Sprint 3...
Estimate: 1, 2, 3, 5, 8, 13

4. 自动化工作流

4.1 内置自动化

触发条件	自动操作
Issue 创建	添加到项目，状态设为 Todo
PR 创建	状态设为 In Review
PR 合并	状态设为 Done
Issue 关闭	状态设为 Done

4.2 GitHub Actions 自动化

# .github/workflows/project-automation.yml
name: Project Automation
on:
  issues:
    types: [opened, labeled]
  pull_request:
    types: [opened]

jobs:
  add-to-project:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/add-to-project@v1.0.2
        with:
          project-url: https://github.com/orgs/myorg/projects/1
          github-token: ${{ secrets.PROJECT_TOKEN }}
          labeled: bug, feature

4.3 GraphQL 自动化

mutation {
  addProjectV2ItemById(input: { projectId: "PROJECT_ID", contentId: "ISSUE_ID" }) {
    item {
      id
    }
  }
}

5. 视图配置

5.1 看板视图

按状态分列的拖拽式看板：

| Backlog | Todo | In Progress | In Review | Done |
|---------|------|-------------|-----------|------|
| Issue#5 | #3   | #1          | #2        | #4   |
| Issue#8 | #6   |             |           | #7   |

5.2 表格视图

类似电子表格，支持排序、筛选和分组：

| Title | Status | Priority | Sprint | Assignee |
|-------|--------|----------|--------|----------|
| Auth  | Done   | High     | S1     | Alice    |
| API   | Active | Medium   | S2     | Bob      |

5.3 路线图视图

按时间线展示项目进度，适合展示里程碑。

6. Insights 与报告

6.1 项目统计

完成率
燃尽图
按标签/类型分布
按成员工作量

6.2 导出数据

# 使用 GitHub CLI 导出
gh project item-list 1 --owner myorg --format json > project.json