mcpField
P
project-planning

project-planning

github.com/zenobi-us生产力6851 次安装今天更新
代码仓库

关于 project-planning

project-planning 是面向项目 Agent 的规划与执行指导技能，定义 PRD、Epic、Spec、Story、Task 等制品及其关系，并覆盖规划、执行、收尾和复盘阶段。它还规定状态流转和需要升级给 Q 的战略决策情形。

主要功能

  1. 01定义项目制品类型
  2. 02说明制品关系与模式
  3. 03覆盖项目生命周期阶段
  4. 04指导制品状态流转
  5. 05设定战略事项升级规则

适用场景

  1. 01从 PRD 拆分 Epic、Spec 和任务
  2. 02跟踪 Story 与 Task 的关联
  3. 03推进项目执行并完成收尾
  4. 04在复盘中记录经验与未决决策

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/zenobi-us/dotfiles --skill project-planning

安装后在 Claude Code 中输入/project-planning确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
estimations.md
relationships.md
status-flow.md
references/schema/
01-artifact-prd.md
02-artifact-epic.md
03-artifact-spec.md
04-artifact-research.md
05-artifact-decision.md
06-artifact-story.md
07-artifact-task.md
08-artifact-retrospective.md
references/workflow/
behaviour-tree.md
closing-phase.md
execution-phase.md
overview.md
planning-phase.md
retrospective-phase.md

详细介绍

什么是[规划产物]类型？

在整个项目规划说明中，你会经常看到以 [Epic]、[Spec]、[Story]、[Task]、[Research] 和 [Decision] 形式出现的类型。

这是为了提醒读者或 Agent：这些是职责各不相同的产物类型。

  • [PRD]：产品需求文档，对产品应实现的目标进行高层描述。它记录利益相关者的需求和期望。[PRD] 为管理者创建一个或多个 [Epic] 提供依据。
  • [Epic]：由 Stories 描述的大型工作项。[Epic] 总是附带一个 [Spec]，两者是一对一关系。
  • [Spec]：对项目需求和目标的详细描述。它会促成一个或多个 [Story] 的创建。
  • [Research]：为项目决策提供依据的信息收集与分析。主要阶段：规划/启动阶段（创建 PRD/Epic/Spec 期间）。次要阶段：执行期间按需开展，此时实现工作可能会遇到未知问题。[Research] 为 [Spec]、[Decision] 和项目方向提供依据。可关联到 [PRD]、[Epic]、[Spec]、[Decision]、[Story] 或 [Task]。
  • [Decision]：评估各种选项后得出的结论，通常基于 [Research]。[Decision] 可能会影响 [Spec] 和项目方向。战略决策在启动/规划阶段创建，实现决策在执行阶段创建。状态必须为“Decided”或“Unresolved”。所有状态为“Unresolved”的 [Decision] 产物都必须在收尾阶段关联到 [Retrospective]。
  • [Story]：一个场景或用例，是从 [Epic] 派生出的可管理工作项。[Story] 始终包含“user stories”。[Story] 总是由 [Task] 实现。
  • [Task]：作为 [Story] 一部分需要完成的具体工作项。它们始终同时关联到 [Story] 和 [Epic]。它们也可以通过有意义的方式关联到其他 [Task]（例如，阻塞、依赖或相关）。
  • [Retrospective]：在 Epic 或项目阶段结束时创建的反思性产物，用于记录经验教训、成功之处和改进空间。它总结团队和利益相关者的见解，为未来项目提供参考。每个 [Retrospective] 都关联到对应的 [Epic] 和所有尚未解决的 [Decision] 产物。

工作流阶段

项目分为五个不同阶段。了解各类产物所属阶段，对执行此技能的 Agent 至关重要。

Agent 自主做出战术决策（创建哪种产物、何时变更状态、验证内容），但会将战略决策上报给 Q（范围变更、时间线调整、技术重构、资源限制）。

阶段概览

  1. 规划 — 创建定义工作内容的产物（PRD → Epic → Spec → Stories → Tasks）

    • → 参见：skill_reference(references/workflow/planning-phase.md)，了解详细的产物创建顺序和验证关卡

  2. 执行 — 通过状态转换推动工作完成

    • → 参见：skill_reference(references/workflow/execution-phase.md)，了解执行指南

  3. 收尾 — 归档已完成的工作，并正式关闭 Epic/Project

    • → 参见：skill_reference(references/workflow/closing-phase.md)，了解收尾流程

  4. 回顾 — 总结经验（可在 Epic 或 Project 完成后进行）

    • → 参见：skill_reference(references/workflow/retrospective-phase.md)，了解回顾指南
上报矩阵

遇到以下情况时，请暂停并上报给 Q：

  • 范围变更 — 在 Epic 或规划过程中途新增/移除功能
  • 时间线调整 — 预计交付日期推迟超过 1 周
  • 技术重构 — 工作期间发现设计需要变更
  • 资源限制 — Task/Story 的复杂度超出承载能力

→ 参见：skill_reference(references/workflow/overview.md)，了解完整的上报矩阵、产物关系图和 Agent 决策模型。

估算

需要进行估算时，请阅读以下资源：

  • → 参见：skill_reference(references/estimation.md)，了解详细的估算技巧和最佳实践。

关系

工件之间保持清晰的关系，以确保在整个项目生命周期中具备可追溯性和上下文。

  • → 参见：skill_reference(references/relationships.md)，了解所有工件类型（PRD、Epic、Research、Story、Task、Retrospective、Decision）的详细关系类型和使用指南。

工件状态转换

每种工件类型都有有效的状态进展路径，用于指导整个项目生命周期中的状态管理。

  • → 参见：skill_reference(references/status-flow.md，了解所有工件类型（PRD、Epic、Research、Story、Task、Retrospective、Decision）的详细状态流程图和说明。

工件模式和内容结构

所有工件都遵循一致的模式，以便进行组织和链接。 每种工件类型都有特定的 frontmatter 要求和内容章节。

→ 使用链接的技能资源，详细了解所有工件类型（PRD、Epic、Research、Story、Task、Retrospective、Decision）的模式定义、工件内容结构和链接类型定义。

具体工件模式见下文：

  • → PRD skill_reference(schema/01-artifact-prd.md)
  • → Epic skill_reference(schema/02-artifact-epic.md)
  • → Spec skill_reference(schema/03-artifact-spec.md)
  • → Research skill_reference(schema/04-artifact-research.md)
  • → Decision skill_reference(schema/05-artifact-decision.md)
  • → Story skill_reference(schema/06-artifact-story.md)
  • → Task skill_reference(schema/07-artifact-task.md)
  • → Retrospective skill_reference(schema/08-artifact-retrospective.md)

评论

支持 Markdown