mcpField
A
agile-roadmap

agile-roadmap

github.com/djalmajr生产力4128 次安装5 周前更新
代码仓库

关于 agile-roadmap

将宏观目标转化为衔接可执行待办事项的路线图规划技能，支持多阶段、项目及季度视图。为各项工作标明预期结果、依赖、风险和进度信号。

主要功能

  1. 01规划多阶段或季度路线图
  2. 02按价值与依赖安排阶段
  3. 03记录结果、风险和进度信号
  4. 04将项目关联到 Epic
  5. 05规划并行轨道与接口

适用场景

  1. 01安排多阶段项目的先后顺序
  2. 02与利益相关者对齐季度优先级
  3. 03规划存在外部依赖的工作
  4. 04协调并行开发轨道

安装

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

$npx skills add https://github.com/djalmajr/skills --skill agile-roadmap

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

附带文件templates/roadmap.md

详细介绍

路线图规划

使用此技能，将宽泛的目标转化为清晰、优先级明确且与可执行待办事项关联的路线图。

通过斜杠命令收到的初始上下文：$ARGUMENTS

如果 $ARGUMENTS 有内容，将其作为起点（例如：需求接收、举措列表、周期）。 如果为空，请询问路线图目标。

语言

使用用户的语言编写产物。遵循正确的语法，并使用所需的变音符号或特定文字字符。如果无法确定用户使用的语言，请先询问再生成内容。模板为英文——请翻译标题和内容，使其与用户的语言一致。

项目根目录

此技能会在相对于项目根目录（工作所在的仓库）的路径下写入产物，而不是相对于 Agent 当前的工作目录。

  • 如果从项目内部调用，请使用此技能中显示的相对路径。
  • 如果从其他目录调用（例如，另一个并列的仓库，或项目位于其他位置），请在每个产物路径前加上 <project-root>/。
  • 如果项目根目录不明确，请在写入前通过 harness 的提问工具向用户确认。

提问

遵循项目范围内 CLAUDE.md / AGENTS.md 中的约定（“技能提问约定”）。对于以下决策点，请使用 harness 的结构化提问工具——AskUserQuestion（Claude Code）、ask_user_question（Codex）或 question（OpenCode）。

决策点使用结构化提问的原因建议选项
路线图类型会影响模板变体发展轨迹 · 季度
接下来要拆解的举措决定后续技能分支第一个举措 · 从列表中选择

自由文本提问（不使用结构化工具）：

  • 周期的起止时间（若为季度路线图）
  • 举措描述

无暂停模式：如果用户明确禁用了技能执行期间的澄清，将每个结构化提问转换为“待解问题”（或同等部分）中的一项，并继续执行，不要等待用户回复。

适用场景

路线图由发展轨迹的复杂度决定，而不是由时长决定。在以下情况中，满足 2 项或以上时使用此技能：

  • 多个举措／阶段需要排序（无法全部并行推进）
  • 今天的决策会影响未来的决策（局部优化可能演变为技术债）
  • 利益相关者需要先了解全程，才能批准单个步骤
  • 存在外部依赖（其他团队、供应商、截止日期）
  • 总体复杂度超出单个 epic 的承载范围

包含 5 个排序阶段、为期 4 周的举措也适合制定路线图——不要因为“时间太短”而否定它。

不适用场景

  • 独立且自成一体的举措（一个 epic 就能涵盖）
  • 没有后续影响的单个 epic——直接使用 /agile-epic
  • 团队已经明确发展轨迹，且没有利益相关者需要路线图

范围（路线图类型）

  • 发展轨迹路线图： 存在阶段间依赖关系的多阶段举措（时长不限）
  • 举措路线图： 针对某个具名举措的阶段、故事、解阻事项和交付顺序
  • 季度路线图： 方向对齐、周期目标和宏观优先级（一种特定类型，并非唯一类型）

执行规则

  • 路线图必须聚焦于成果和能力，而不是冗长的技术清单。
  • 每个路线图条目都必须说明预期价值、依赖关系和进度信号。
  • 路线图必须指出哪些是承诺、哪些是风险，以及哪些不在本周期范围内。
  • 尽可能让每项举措都关联到对应的 epic。

如何构建发展轨迹路线图（默认）

  1. 声明整个发展历程的总体目标。
  2. 列出 2-5 个阶段或举措（按顺序推进或并行推进）。
  3. 按依赖关系和价值排序——明确说明推进顺序。
  4. 对每个阶段说明：预期成果、依赖关系、进度信号和风险。
  5. 记录哪些是承诺、哪些是风险，以及哪些不在范围内。
  6. 确认路线图叙述可观察，并已准备好供利益相关者审阅。

如何制定季度路线图（特定类型）

与上文相同，以周期目标（季度）作为时间边界。 适用于利益相关方期待按周期查看的场景（产品和高管受众中很常见）。

如何按 Epic 制定路线图

  1. 声明 Epic 目标。
  2. 定义阶段或交付波次。
  3. 按阶段关联故事。
  4. 明确标出解除阻塞项、风险和中间验证。
  5. 确认路线图能指导执行，而不会取代计划。

保存位置

  • 计划/轨迹路线图：planning/<initiative>/roadmap.md
  • 季度路线图：planning/roadmaps/Q<N>-YYYY.md

协作工作

当团队有 2 名或更多开发者时，路线图应：

  • 标出并行工作轨道（例如，后端、前端、AI 工程），以便开发者同时开展工作
  • 定义各轨道之间的接口契约，尽量减少阻塞
  • 在时间线中展示哪些故事/阶段可以并行推进
  • 在制定路线图时询问团队规模和组成
单人开发

对于单人开发，执行时不适用并行工作。并行轨道结构仍有助于面向未来——标注如果以后有第二位开发者加入，哪些轨道可以拆分，但实际交付应选择串行顺序。Mermaid flowchart（依赖关系）比 gantt（进度安排）更适合单人工作。

链接后续步骤

在路线图末尾，仅提供 /agile-epic：

  • “你希望我运行 /agile-epic，将第一个计划分解为故事吗？”

**重要：**路线图从宏观层面识别计划。每个计划都应在执行前通过 /agile-epic 进行分解。

模板

使用此技能中的 templates/roadmap.md 作为基础。

与流程的关系

flowchart LR
    A["/agile-intake"] --> B["/agile-roadmap"]
    B --> C["/agile-epic"]
    C --> D["/agile-story"]
    D --> E[execution]
    E --> F["/agile-status"]

此技能连接战略与执行。进行分解时，使用 /agile-epic。制定执行计划时，使用 /agile-story。

评论

支持 Markdown