mcpField
S
sprint-planning

sprint-planning

github.com/mohitagw15856开发1.5k51 次安装6 天前更新
代码仓库

关于 sprint-planning

将待办事项转化为结构化冲刺计划,面向软件团队。它依据团队容量和速度校准范围,提供议程与风险检查,并要求人工批准后才执行跟踪器操作。

主要功能

  1. 01制定以结果为导向的冲刺目标
  2. 02构建含优先级和估算的待办列表
  3. 03用 Python 脚本计算容量
  4. 04考虑可用时间和遗留事项
  5. 05标记风险及缺失的验收标准
  6. 06跟踪器变更须经批准

适用场景

  1. 01根据待办事项规划冲刺
  2. 02按团队可用时间调整承诺
  3. 03准备限时规划会议议程
  4. 04将获批工作移入跟踪器冲刺

安装

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

$npx skills add https://github.com/mohitagw15856/pm-claude-skills --skill sprint-planning

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

包含的文件

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

references/
capacity-honesty.md
worked-example.md
scripts/
capacity_calculator.py
templates/
planning-worksheet.md

详细介绍

Sprint 规划技能

将原始待办事项转化为结构化、可实现的 Sprint,明确目标、根据速率校准范围,并生成团队可直接使用的输出。

从 Brain 读取/写入 Brain

如果存在 professional-brain(brain/),请以其中的信息为依据,而不是重复询问已知内容:

  • **先读取:**优先查看 decisions/(团队认定的重要事项)、功能相关的 entities/,以及 Sprint 可能会验证的未关闭 hypotheses/。运行 python3 ../professional-brain/scripts/brain_query.py ./brain "<sprint goal>",并保留每条事实的来源标签。
  • **📥 向 Brain 提议记录:**生成内容后,提议将 Sprint 承诺(目标 + 承诺范围)作为带来源标签的 decisions/ 记录。先展示内容并征得同意,然后使用 ../professional-brain/scripts/brain_write.py … --commit 写入(仅追加,默认采用试运行模式)。

提议的操作

Sprint 达成一致后,将其交给 action-runner:它会预览操作(试运行并评估风险),仅通过连接的操作 MCP 执行你批准的操作,并将已执行的内容记录回 Brain。典型操作:为每个承诺的待办事项创建一个工单,并设置 Sprint 里程碑(🟡)。此技能只提出建议;action-runner 负责把关和执行,绝不悄悄操作。

此技能的产出

  • Sprint 目标 — 一句以成果为核心、全体团队成员都能为之努力的话
  • Sprint 待办事项 — 按优先级排列的用户故事列表,包含故事点估算和验收标准
  • 容量计划 — 团队可用时间明细,考虑假期、会议和专注时间
  • Sprint 规划议程 — 包含时间安排的 2 小时结构化会议议程
  • 风险提示 — 可能导致 Sprint 受阻的障碍或依赖项

必需输入

如果尚未提供,请询问:

  • Sprint 时长(1 或 2 周)
  • 团队规模和速率(每个 Sprint 的平均故事点数)
  • 要纳入的前 3–5 个待办事项或史诗
  • 已知的缺席、假期或团队活动
  • 上一个 Sprint 未完成的事项(结转项)

Sprint 目标公式

采用以下结构:

“本次 Sprint 将交付 [X 成果],以便 [用户/业务收益],并通过 [成功指标] 衡量。”

切勿将 Sprint 目标写成任务清单。始终优先描述成果。

故事点校准

复杂度点数描述
微不足道1内容明确,没有未知因素
小2简单直接,工作量较小
中3有一定复杂度,但路径明确
大5复杂,需要设计或研究
非常大8不确定性高,可能需要拆分
史诗13+规模过大 — 必须在纳入 Sprint 前拆分

标记所有估算为 8+ 的事项,并建议拆分。

容量公式

Available capacity = (Team size × Sprint days × Focus hours/day) × Availability factor
Focus hours/day: 6 (accounting for meetings, Slack, admin)
Availability factor: 0.7–0.85 depending on holidays/events
Story points to commit = Historical velocity × Availability factor

程序化辅助工具

此技能附带一个仅使用 Python 标准库的脚本,可计算容量,无需手动估算。团队数据已知时请使用该脚本 — 它会一致地应用可用时间和 80% 承诺比例规则。

# Quick estimate from flags
python3 scripts/capacity_calculator.py --team 5 --days 10 --velocity 30 --availability 0.8 --carryover 5

# Detailed estimate from per-member availability (JSON via stdin or --input file.json)
echo '{"sprint_days":10,"historical_velocity":40,"carryover_points":8,
       "members":[{"name":"Ada","available_days":10},{"name":"Linus","available_days":7}]}' \
  | python3 scripts/capacity_calculator.py --input -

该脚本会返回可用的专注工时、根据实际可用时间调整后的速率、建议承诺量(上限为速率的 80%),以及扣除结转项后可用于新工作的剩余容量。先运行脚本,再据此构建 Sprint 待办事项。添加 --json 可将结果传递给其他工具。

输出格式

冲刺 [N] — [开始日期] 至 [结束日期]

冲刺目标:

[目标陈述]

团队产能: 可用 [X] 个故事点(基于 [Y] 名团队成员和 [Z]% 的可用时间)

冲刺待办事项:

优先级故事点数负责人验收标准
1[故事标题][N][团队成员][当 X 时,则 Y]

从上一冲刺结转的事项:

  • [事项] — 结转原因:[简要说明]

风险与依赖关系:

  • [风险描述] → 缓解措施:[行动]

冲刺规划议程:

  • 00:00–00:10 — 回顾冲刺目标和团队产能
  • 00:10–00:40 — 逐项梳理待办事项,确认估算
  • 00:40–01:20 — 分配故事,识别依赖关系
  • 01:20–01:50 — 逐项审查故事的验收标准
  • 01:50–02:00 — 确认冲刺承诺并结束会议

指南

  • 始终质疑缺少验收标准的故事,并明确标记
  • 建议团队承诺完成可用产能的 80%,而非 100%
  • 如果未提供速度数据,则以 5 人团队 20–30 个点作为起始假设
  • 将负责人不明确的故事标记为阻塞项

深入材料

此技能附带了支持文件;如果有,请使用:

  • references/capacity-honesty.md — 产能诚实原则——团队会对自己隐瞒的数字。生成输出时请应用其中的原则;它包含了上方方法摘要所简要概括的校准方式和判断依据。
  • templates/planning-worksheet.md — 可填写的交付物模板,内含质量检查关卡。当用户希望自行填写文档,而不是让系统生成时,请提供此模板。

评分标准(0–40)

交付前请对该技能的任何输出进行评分;达到 32 分及以上才可交付。

维度0510
冲刺目标质量目标是任务列表(“完成故事 1–8”)或完全缺失表述了结果但含糊不清——无法在冲刺结束时判定通过或失败用一句话描述结果,包含用户/业务收益和成功指标,并且能在冲刺结束时明确判定
产能诚实度承诺基于 100% 的理论产能,且忽略结转事项已根据可用时间调整,但未采用 80% 的承诺比例,或提取新工作前未扣除结转点数依据实际可用时间(假期、会议、专注时段),先扣除结转事项,再将承诺限制在调整后速度的 80%
故事就绪度故事缺少验收标准、估算或负责人大多数故事均已估算并分配负责人,但有 8 点及以上的故事未拆分,或验收标准无法测试每个故事均有一名负责人、经过校准的点数和可测试的验收标准;所有 8 点及以上的故事都已标记为需要拆分
风险与依赖关系识别未列出风险或依赖关系风险描述泛泛(“可能延期”),没有缓解措施或负责人明确列出阻塞项和跨团队依赖关系,并为每项指定具体的缓解措施和负责人

质量检查

  • 冲刺目标以结果为导向(不是“实施 X”,而应类似“用户可以执行 Y”)
  • 团队产能根据实际可用时间计算,而非理论上的 100%
  • 每个故事都有验收标准(将缺少验收标准的故事标记出来)
  • 将估算为 8 点及以上的故事标记为需要拆分
  • 在产能计算中计入上次冲刺的结转事项

反模式

  • 不要将冲刺目标写成任务列表——目标必须以结果为导向,并且能在冲刺结束时判定通过或失败
  • 不要承诺完成 100% 的可用产能——始终建议保留 80% 的承诺比例,为计划外工作留出余量
  • 不要将缺少验收标准的故事带入冲刺——承诺前将其标记为阻塞项
  • 未先拆分估算为 8 点及以上的故事时,不要将其纳入冲刺
  • 计算产能时不要忽略结转事项——它们会占用产能,在纳入新工作前必须计入

执行

适用于能够访问团队跟踪工具(Jira、Linear、GitHub Projects)的工具使用型或计算机使用型 Agent。无法使用工具的运行环境请忽略本节并交付文档。请参阅 SKILLSPEC.md §5,了解本部分遵循的规则。

前提条件
  • 上述冲刺计划已制定完成,且已获得人工明确批准——切勿根据未经审核的草案创建冲刺。
  • Agent 环境中已完成跟踪工具的身份验证;目标看板/项目由用户指定。
  • 已展示拟执行更改的试运行清单,并已获得确认。
允许的操作
  • 使用已批准的名称和日期创建冲刺/迭代容器。
  • 将已批准且已存在的待办事项移入冲刺——仅限已批准计划中列出的事项。
  • 为这些事项设置已批准的故事点估算值。
  • 将冲刺目标设为冲刺描述或置顶评论。
  • 不得执行其他操作:不得创建新问题、删除或关闭任何内容、编辑事项描述或触碰其他冲刺。
验证
  • 从跟踪工具重新读取冲刺:事项数量和总点数与已批准计划一致;每个已移动的事项都在冲刺中;冲刺日期匹配。
  • 向用户发布验证摘要(事项、点数、日期)。
回滚
  • 撤销 = 将事项移回待办事项列表,并删除空的冲刺容器。
  • 如果出现以下情况,请停止并询问人工:计划中的任何事项已不存在或自批准后发生变化;跟踪工具拒绝某项操作;或看板上存在日期重叠的活动冲刺。

评论

支持 Markdown