关于 sprint-planning
将待办事项转化为结构化冲刺计划,面向软件团队。它依据团队容量和速度校准范围,提供议程与风险检查,并要求人工批准后才执行跟踪器操作。
主要功能
- 01制定以结果为导向的冲刺目标
- 02构建含优先级和估算的待办列表
- 03用 Python 脚本计算容量
- 04考虑可用时间和遗留事项
- 05标记风险及缺失的验收标准
- 06跟踪器变更须经批准
适用场景
- 01根据待办事项规划冲刺
- 02按团队可用时间调整承诺
- 03准备限时规划会议议程
- 04将获批工作移入跟踪器冲刺
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ mohitagw15856/ pm-claude-skills --skill sprint-planning安装后在 Claude Code 中输入/sprint-planning确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/capacity-honesty.mdworked-example.mdscripts/capacity_calculator.pytemplates/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 分及以上才可交付。
| 维度 | 0 | 5 | 10 |
|---|---|---|---|
| 冲刺目标质量 | 目标是任务列表(“完成故事 1–8”)或完全缺失 | 表述了结果但含糊不清——无法在冲刺结束时判定通过或失败 | 用一句话描述结果,包含用户/业务收益和成功指标,并且能在冲刺结束时明确判定 |
| 产能诚实度 | 承诺基于 100% 的理论产能,且忽略结转事项 | 已根据可用时间调整,但未采用 80% 的承诺比例,或提取新工作前未扣除结转点数 | 依据实际可用时间(假期、会议、专注时段),先扣除结转事项,再将承诺限制在调整后速度的 80% |
| 故事就绪度 | 故事缺少验收标准、估算或负责人 | 大多数故事均已估算并分配负责人,但有 8 点及以上的故事未拆分,或验收标准无法测试 | 每个故事均有一名负责人、经过校准的点数和可测试的验收标准;所有 8 点及以上的故事都已标记为需要拆分 |
| 风险与依赖关系识别 | 未列出风险或依赖关系 | 风险描述泛泛(“可能延期”),没有缓解措施或负责人 | 明确列出阻塞项和跨团队依赖关系,并为每项指定具体的缓解措施和负责人 |
质量检查
- 冲刺目标以结果为导向(不是“实施 X”,而应类似“用户可以执行 Y”)
- 团队产能根据实际可用时间计算,而非理论上的 100%
- 每个故事都有验收标准(将缺少验收标准的故事标记出来)
- 将估算为 8 点及以上的故事标记为需要拆分
- 在产能计算中计入上次冲刺的结转事项
反模式
- 不要将冲刺目标写成任务列表——目标必须以结果为导向,并且能在冲刺结束时判定通过或失败
- 不要承诺完成 100% 的可用产能——始终建议保留 80% 的承诺比例,为计划外工作留出余量
- 不要将缺少验收标准的故事带入冲刺——承诺前将其标记为阻塞项
- 未先拆分估算为 8 点及以上的故事时,不要将其纳入冲刺
- 计算产能时不要忽略结转事项——它们会占用产能,在纳入新工作前必须计入
执行
适用于能够访问团队跟踪工具(Jira、Linear、GitHub Projects)的工具使用型或计算机使用型 Agent。无法使用工具的运行环境请忽略本节并交付文档。请参阅 SKILLSPEC.md §5,了解本部分遵循的规则。
前提条件
- 上述冲刺计划已制定完成,且已获得人工明确批准——切勿根据未经审核的草案创建冲刺。
- Agent 环境中已完成跟踪工具的身份验证;目标看板/项目由用户指定。
- 已展示拟执行更改的试运行清单,并已获得确认。
允许的操作
- 使用已批准的名称和日期创建冲刺/迭代容器。
- 将已批准且已存在的待办事项移入冲刺——仅限已批准计划中列出的事项。
- 为这些事项设置已批准的故事点估算值。
- 将冲刺目标设为冲刺描述或置顶评论。
- 不得执行其他操作:不得创建新问题、删除或关闭任何内容、编辑事项描述或触碰其他冲刺。
验证
- 从跟踪工具重新读取冲刺:事项数量和总点数与已批准计划一致;每个已移动的事项都在冲刺中;冲刺日期匹配。
- 向用户发布验证摘要(事项、点数、日期)。
回滚
- 撤销 = 将事项移回待办事项列表,并删除空的冲刺容器。
- 如果出现以下情况,请停止并询问人工:计划中的任何事项已不存在或自批准后发生变化;跟踪工具拒绝某项操作;或看板上存在日期重叠的活动冲刺。