跳至主要内容

项目快速入门

通过在本交互式指南中创建项目,体验 Projects 的速度、灵活性和自定义功能。

简介

本指南演示了如何使用 Projects 来计划和跟踪工作。在本指南中,您将创建一个新项目,并添加一个自定义字段来跟踪任务的优先级。您将学习如何创建保存的视图,这些视图可以帮助您与合作者沟通优先级和进度。您还将设置内置工作流来管理项目中的项目。

先决条件

您可以创建组织项目或用户项目。要创建组织项目,您需要一个 GitHub 组织。有关创建组织的更多信息,请参阅“从头开始创建新组织”。

在本指南中,您将把组织(对于组织项目)或您(对于用户项目)拥有的存储库中的现有问题添加到您的新项目中。有关创建问题的更多信息,请参阅“创建问题”。

创建项目

首先,创建组织项目或用户项目。

创建组织项目

  1. 在 GitHub 的右上角,选择您的个人资料照片,然后单击 您的组织.

  2. 单击您的组织名称。

  3. 在您的组织名称下,单击 项目.

    Screenshot showing profile tabs. The 'Projects' tab is highlighted with an orange outline.

  4. 单击**新建项目**。

  5. 选择您要使用的项目类型或模板。

    • 要创建空白项目,在“从头开始”下,单击**表格**、**路线图**或**看板**。
    • 要从模板创建项目,请单击您要使用的模板。您可以从 GitHub 策划的内置模板、组织创建的模板以及组织选择的推荐模板中进行选择。
  6. 可选:如果您选择了模板,请查看将要创建的字段、视图、工作流和洞察。

  7. 在“项目名称”下的文本框中,键入新项目的名称。

  8. 单击**创建项目**。

创建用户项目

  1. 在 GitHub 的右上角,单击您的个人资料照片,然后单击**您的个人资料**。

    Screenshot of the dropdown menu under @octocat's profile picture. "Your profile" is outlined in dark orange.

  2. 在您的个人资料上,单击 项目.

    Screenshot showing profile tabs. The 'Projects' tab is highlighted with an orange outline.

  3. 单击**新建项目**。

  4. 选择您要使用的项目类型或模板。

    • 要创建空白项目,在“从头开始”下,单击**表格**、**路线图**或**看板**。
    • 要从模板创建项目,请单击您要使用的内置模板。
  5. 可选:如果您选择了模板,请查看将要创建的字段、视图、工作流和洞察。

  6. 在“项目名称”下的文本框中,键入新项目的名称。

  7. 单击**创建项目**。

设置您的项目描述和自述文件

您可以设置项目的描述和自述文件,以分享项目的用途,提供有关如何使用项目的说明,以及包含任何相关链接。

  1. 导航到您的项目。

  2. 在右上角,点击 打开菜单。

    Screenshot showing a project's menu bar. The menu icon is highlighted with an orange outline.

  3. 在菜单中,点击 **设置** 访问项目设置。

  4. 要为您的项目添加简短描述,在“添加描述”下,在文本框中输入您的描述,然后点击 **保存**。

  5. 要更新项目的 README,在“README”下,在文本框中输入您的内容。

    • 您可以使用 Markdown 格式化您的 README。有关更多信息,请参阅“基本写作和格式语法”。
    • 要切换文本框和更改预览,请点击 .
  6. 要保存对 README 的更改,请点击 **保存**。

您可以通过导航到您的项目并点击来查看和快速更改您的项目描述和 README 在右上角。

向您的项目添加问题

接下来,向您的项目添加一些问题。

  1. 将光标放在项目的最后一行,在 .

    Screenshot showing the bottom row of a table view. The "Add item" field is highlighted with an orange outline.

  2. 粘贴问题或拉取请求的 URL。

  3. 要添加问题或拉取请求,请按 Return

重复上述步骤几次,以向您的项目添加多个问题。

有关更多信息以及向您的项目添加问题的其他方法,或有关您可以添加到项目的其他项目的信息,请参阅“向您的项目添加项目”。

向您的项目添加草稿问题

接下来,向您的项目添加一个草稿问题。

  1. 将光标放在项目的最后一行,在 .

    Screenshot showing the bottom row of a table view. The "Add item" field is highlighted with an orange outline.

  2. 输入您的想法,然后按 **Enter**。

  3. 要添加正文文本,请点击草稿问题的标题。在出现的 Markdown 输入框中,输入草稿问题正文的文本,然后点击 **保存**。

添加迭代字段

接下来,创建一个迭代字段,以便您可以规划和跟踪您在重复的时间段内的工作。迭代可以配置为适合您和您的团队的工作方式,具有可定制的长度和插入休息的能力。

  1. 在表格视图中,点击最右侧字段标题 .
    Screenshot of a project. The "Add field" button is highlighted with an orange outline.
  2. 点击 **新建字段**。
  3. 在下拉菜单顶部,输入新字段的名称。
  4. 选择 **迭代**
  5. 要更改每次迭代的持续时间,输入一个新数字,然后选择下拉菜单并点击 **天** 或 **周**。
  6. 点击 **保存**。

创建字段以跟踪优先级

现在,创建一个名为 `Priority` 的自定义字段,包含以下值:`High`、`Medium` 或 `Low`。

  1. 在表格视图中,点击最右侧字段标题 .
    Screenshot of a project. The "Add field" button is highlighted with an orange outline.
  2. 点击 **新建字段**。
  3. 在下拉菜单顶部,输入新字段的名称。
  4. 选择 **单选**
  5. 在“选项”下方,输入第一个选项“High”。
  6. 要添加更多字段,例如“Medium”和“Low”,请点击 **添加选项**。
  7. 点击 **保存**。

为项目中的所有问题指定优先级。

Screenshot showing a list of issues, each with a priority of "Low," "Medium," or "High" in the "Priority" field.

按优先级对问题进行分组

接下来,按优先级对项目中的所有项目进行分组,以便更轻松地关注高优先级项目。

  1. 点击 当前打开的视图名称旁边。

    Screenshot showing the tabs at the top of a project. The view menu icon is highlighted with an orange outline.

  2. 点击 分组.

  3. 点击 **优先级**。

现在,将问题在组之间移动以更改其优先级。

  1. 选择一个问题。
  2. 将问题拖放到不同的优先级组中。当你这样做时,问题的优先级将更改为其新组的优先级。

保存优先级视图

在您在上一步骤中按优先级对问题进行分组时,您的项目显示了一个指示器,表明视图已修改。保存这些更改,以便您的合作者也能看到按优先级分组的任务。

  1. 点击 当前打开的视图名称旁边。

    Screenshot showing the tabs at the top of a project. The view menu icon is highlighted with an orange outline.

  2. 点击 **保存更改**。

您可以与团队共享 URL,以使每个人都了解项目的优先级。

保存视图后,任何打开项目的人都会看到保存的视图。在这里,您按优先级进行了分组,但您也可以添加其他修饰符,例如排序、筛选或布局。接下来,您将创建一个布局已修改的新视图。

添加看板布局

要查看项目问题的进度,您可以切换到看板布局。

看板布局基于状态字段,因此请为项目中的每个问题指定一个状态。

然后,创建一个新视图。

  1. 在现有视图的右侧,点击 **新建视图**
    Screenshot showing the view tabs at the top of a project. The "New view" button is highlighted with an orange outline.

接下来,切换到看板布局。

  1. 点击 当前打开的视图名称旁边。

    Screenshot showing the tabs at the top of a project. The view menu icon is highlighted with an orange outline.

  2. 在“布局”下,点击 **看板**。

更改布局后,您的项目会显示一个指示器,表明视图已修改。保存此视图,以便您和您的合作者将来可以轻松访问它。

  1. 点击 当前打开的视图名称旁边。

    Screenshot showing the tabs at the top of a project. The view menu icon is highlighted with an orange outline.

  2. 点击 **保存更改**。

为了表明视图的用途,请为它起一个描述性的名称。

  1. 点击 当前打开的视图名称旁边。

    Screenshot showing the tabs at the top of a project. The view menu icon is highlighted with an orange outline.

  2. 点击 重命名视图.

  3. 输入您的视图的新名称。

  4. 要保存更改,请按 Return

配置内置自动化

接下来,配置自动添加工作流程,以便自动将特定标签的仓库中打开的问题添加到您的项目中。

  1. 导航到您的项目。

  2. 在右上角,点击 打开菜单。

    Screenshot showing a project's menu bar. The menu icon is highlighted with an orange outline.

  3. 在菜单中,点击 工作流程.

  4. 在“默认工作流程”列表中,单击 **自动添加到项目**。

  5. 要开始编辑工作流程,请在右上角单击 **编辑**。

    Screenshot showing the workflow menu bar. The "Edit" button is highlighted with an orange rectangle.

  6. 在“过滤器”下,选择您要添加项目的仓库。

  7. 在仓库选择旁边,输入您希望项目匹配的筛选条件,然后自动添加到您的项目中。例如,要捕获所有使用“bug”标签打开的问题和 PR,请使用 is:issue,pr label:bug

  8. 要启用新工作流程,请单击 **保存并启用工作流程**。

最后,添加一个内置工作流程,以便在将项目添加到您的项目时将状态设置为 **待办**。

  1. 在右上角,点击 打开菜单。
    Screenshot showing a project's menu bar. The menu icon is highlighted with an orange outline.
  2. 在菜单中,点击 工作流程.
  3. 在 **默认工作流程** 下,单击 **项目添加了项目**。
  4. 在 **何时** 旁边,确保选中了 问题拉取请求
  5. 在 **设置** 旁边,选择 **状态:待办**。
  6. 单击 **禁用** 切换按钮以启用工作流程。

进一步阅读