项目规划器（alpha版本）

项目规划器是Sublime Text 3的一个插件，旨在简化中等规模项目的下一步行动规划。下一步行动是指不久将采取的行动，例如在下一次冲刺中。

规划器分为若干部分（焦点小组），每个部分包含任务。任务可以加标签（如Tom，Josh），指定持续时间和截止日期。

规划器基于Markdown语法。Markdown易于阅读，可以被编译成HTML，从而生成一个可以与他人共享的报告。

此项目处于alpha阶段。使用此插件存在风险，请自行承担。至少确保将项目计划文件存放在版本控制系统上，以便在插件损坏时可以恢复。

与“大型”项目规划工具不同，此工具允许您仅专注于准备即将到来的任务，并自动安排有或没有截止日期的任务。如果您认为甘特图图表过于复杂，但仍希望对你的项目有一个全面的了解，那么这个工具是您的选择。

插件在保存以.projectplan.md结尾的所有文件时运行。

使用案例

• 你是学生吗？规划你的所有学校工作、考试，以及侧项目和个人爱好。
• 你是初创公司的CTO吗？根据来自不同开发部门（硬件、软件等）或人员（Josh、Tom等）的任务自动规划冲刺。创建长期路线图，以实现公司的目标。
• 你负责多个项目吗？规划你的工作，并始终保持在对的状态。

部分

部分是一个包含任务的焦点区域。部分有助于将不同的任务分类到各组中。示例部分可以是学校工作、个人项目、工作项目。

部分以这种方式分隔：## 部分标题。

任务

部分可以包含多个任务。任务是不定粒度的作业单位。

任务必须以一个 - 符号开始。示例

- Prepare dinner

可以将任务标记为已完成，通过将 - 改为 +。示例

+ Prepare dinner

保存文件后，插件将自动划掉任务并添加完成日期。

元信息

可以为每个任务指定截止日期、持续时间和其他元数据。元信息对项目规划非常重要。

示例

• - 准备晚餐 [2h]：任务持续时间是2小时。
• - 准备晚餐 [2015-12-17]：在12月17日前完成任务
• - 准备晚餐 [2h 2015-12-12]：在12月17日前完成历时2小时的任务。
• - 梦见绵羊 [M]：这个任务不是必需的（《M》代表也许）。
• - 准备着陆页面 [设计 4h 编码 2d]：这个任务有设计和编码两方面，分别持续4小时和2天。
• - 准备着陆页面 [设计 4h 编码 2d 2015-02-45]：保存方式如上，带有截止日期。
• - 写博客文章 [M Josh 4h]：类别也可以是人。这个任务是可选的。

有效的 时间 关键词有三个：minute（分钟）、hour（小时）、day（天）、wweek（周）和Month（月）

有效的 类别 是：长度为2个或更多字符的任何字符串。

有效的 标志 : Maybe（可选任务）

奇妙的功能

任务的元数据对于规划任务的时间执行是必要的。有时插件可以根据类似任务的持续时间自动推断任务的持续时间。

注意：文件的第一行必须是标题，例如：# 我的任务计划。

部分摘要

根据提供的元信息，插件可以计算每个部分的持续时间。

在这个例子中，文件已保存后，插件添加了两个行

1. 部分持续时间摘要。这包含了该部分非可选任务的数量（3个任务）、它们的总持续时间（1分钟 1周 4天）以及按类别划分的工作量（数学 2周，无 2周，艺术 2周）。插件已自动创建了名为 None 的部分来包含所有未分类的任务。
2. 部分时间表图

要查看这个周期间在本部分中任务将如何完成，可以通过关键词 ### Weekly effort timeline 显示一个每周工作量的图。示例

最后保存日期

在文件标题下，插件将自动添加文件的最后保存日期（编译日期）。

即将到来的任务

ProjectPlanner能够列出即将到来的任务（来自文件中所有部分）。即将到来的任务插入到名为 ### 即将到来的任务 的部分中。

默认情况下，插件会显示来自所有类别的10个即将到来的任务，以及每个类别的最多5个任务。查看更多即将到来的任务，可以通过以下方式：

努力规划

插件会生成预计努力量的图表。所有这样的图表都在名为 ## 努力规划 的部分中生成。在这个部分中，你可以添加子部分，特定的图表将渲染到这些子部分中。

这些图表有助于你提前规划工作，并查看调整任务的元数据如何影响项目执行。

总估计工作量

要显示按类别划分的总工作量图表，请添加子标题 ### 总估计工作量。这将生成以下的图表

每周工作量时间线

要查看随着时间的推移工作如何在各个类别之间分布，可以使用关键词 ### Weekly effort timeline 显示每周工作量的图表。示例

默认情况下显示未来10周的工作分配。通过修改标题来显示要显示的周数，可以查看更多或更少的周，例如：

### 5周工作时间表：仅显示5周

或

### 20周工作时间表：显示20周

部分时间表

插件还可以在标题为 ### 周计划 的子部分中显示每个部分随时间的工作分配，如下所示：

通过在部分标题中附加 to scale，可以切换显示所有缩放到刻度（归一化到最大值）的图表。

通过在标题前附加周数来绘制更多或更少的周（默认为40周），例如 30w 或 60w。

部分优先级

默认情况下，调度算法将以相等的概率从每个部分从上到下选取任务。如果您希望比其他部分更关注某个部分，可以通过在部分标题中添加权重来调整算法。示例：

## 语言学习（3倍）：本部分中的任务比普通部分的任务紧急3倍

## 辅助项目（0.5倍）：本部分中的任务紧迫性低于普通。

调整部分优先级会对生成的计划产生很大影响

推荐文档布局

推荐的文档布局是

其他文档布局尚未经过测试，可能不适用于当前插件的状态（alpha）。

Trello集成

此插件可以与Trello面板结合使用。Trello面板和产品计划文档具有相似的结构。Trello中的一个列表相当于ProjectPlanner中的一个部分，Trello中的一个卡片相当于Project Planner中的一个任务。

与Trello集成的主要优势是能够使用Trello的检查表更详细地进行任务规划，同时使用Project Planner设置截止日期、优先级和任务顺序。

从快速面板（Ctrl+Shift+p）可以访问与Trello的同步。

为了用Trello卡片的持续时间信息更新文件中的任务，您必须将任务链接到相应的卡片，如下所示：

更新元数据

在Trello中创建一个卡片，将其链接到您之前显示的任务，并创建一个带有条目的检查清单。每个条目都可以以与任务相似的方式定义元数据。请注意，此插件仅同步任务持续时间，不同步截止日期。截止日期应在您的Project Planner文件中配置。

在您的Project Planner文件中添加任务并链接到Trello卡片，如下所示：

- [Prepare for biology midterm](https://trello.com/c/oaf76ars/23-prepare-for-biology-midterm)

运行同步，插件将自动添加以下元数据到您的文件。

- [Prepare for biology midterm](https://trello.com/c/oaf76ars/23-prepare-for-biology-midterm) [Bio 1w]

保存文件，日历（即将到来的任务、图表等）将被更新。

错误检测和最后更新时间戳

在同步时，插件可以向您通知以下内容：

• 缺失列表：您在Trello中有列表，但在文件中却没有？插件将要求您添加相应的部分。
• 缺失卡片：您在Trello中有卡片，但在文件中却没有？插件将要求您将任务添加到文件中。
• 不同的列表顺序：您文件中部分的顺序与Trello面板上列表的顺序不同？插件将要求您重新排序部分。

为了查看上述警告，请在文档中包含一个## Trello警告部分，并包含一个### 错误子部分。同步后，您应该看到如下内容：

## Trello warnings

Last synced: 2015-11-28 15:45

### Errors

There are no errors

首选项

以下首选项选项可用

贡献

请随意提交PR（Pull Request）。如果我认为它们是必要的，我会尽我所能审查并合并它们。

开发状态

这是一个alpha测试阶段的软件。代码编写时没有考虑编码标准和体系结构。重构会使它更好……