CCGS 冲刺规划技能 /sprint-plan 深度指南：从 Backlog 到 Sprint 文件的自动化编排与 PR-SPRINT 制作人门禁-二趣网

CCGS 冲刺规划技能 /sprint-plan 深度指南：从 Backlog 到 Sprint 文件的自动化编排与 PR-SPRINT 制作人门禁

【免费下载链接】Claude-Code-Game-StudiosTurn Claude Code into a full game dev studio — 49 AI agents, 72 workflow skills, and a complete coordination system mirroring real studio hierarchy.项目地址: https://gitcode.com/GitHub_Trending/cl/Claude-Code-Game-Studios

/sprint-plan是 Claude Code Game Studios（CCGS）冲刺管理（sprint）类别下的核心规划技能：它读取当前里程碑文件与全部未开始（unstarted）的 backlog stories，按实现层次与优先级分数排序，生成带编号的新 sprint 计划，并在 full 模式下触发 PR-SPRINT 制作人门禁后，经用户确认写入production/sprints/sprint-NNN.md。本文以其行为规格 CCGS Skill Testing Framework/skills/sprint/sprint-plan.md 为骨架，结合 quality-rubric.md、producer.md 与 catalog.yaml 展开，读者将掌握该技能的完整输入/输出契约、五种核心测试场景（含阻塞、门禁 CONCERNS、lean 模式跳过、跨冲刺 carry-over 等边界行为），以及如何用/skill-test对其实施自动化验收。

技能概览：/sprint-plan 的输入、处理与输出

按照规格文件的 Skill Summary，/sprint-plan的行为契约可以归纳为四个环节：

读取：读取当前里程碑文件（production/milestones/milestone-NN.md，用于取得 capacity 与 goals）以及各 epic backlog 中的全部 stories；
排序：将未开始的 stories 按实现层次（implementation layer）优先、优先级分数（priority score）其次的规则排序；
成稿：在里程碑容量（story points）约束内筛选 stories，生成新的编号 sprint 草稿；
门禁与落盘：在 full 模式下，草稿完成后运行 PR-SPRINT 制作人门禁（由 producer 审核计划）；lean 与 solo 模式跳过该门禁。技能在持久化之前必须询问 "May I write toproduction/sprints/sprint-NNN.md?"

该技能只有两个 verdict：COMPLETE（sprint 已生成并写入）与BLOCKED（因数据缺失或门禁失败而无法继续）。注意 verdict 与门禁 verdict 是两套词汇：前者是技能输出的最终结论，后者是 producer 返回的REALISTIC / CONCERNS / UNREALISTIC（详见后文）。

静态断言：结构性验收清单

规格文件首先定义了一组不依赖 fixture 的结构性断言，由/skill-test static自动验证。也就是说，任何改动后的/sprint-plan技能都必须通过以下检查才能进入行为测试：

具备必需的 frontmatter 字段：name、description、argument-hint、user-invocable、allowed-tools
拥有 ≥2 个 phase 标题（分阶段执行结构）
包含 verdict 关键词：COMPLETE、BLOCKED
包含 "May I write" 协作协议语言（因为该技能会写 sprint 文件）
具备下一步交接说明（sprint 写入之后该做什么）

这一断言体系与 templates/skill-test-spec.md 中定义的规格模板保持一致，也与整个 CCGS 的静态验收基线（frontmatter、≥2 个 phase 标题、verdict 关键词、"May I write"、next-step handoff）一脉相承。由于它是写作类技能（allowed-tools 含 Write），所以与只读技能（如/sprint-status）不同，"May I write" 语言是强制的——这正是 CCGS 协作式（collaborative, not autonomous）设计哲学在规格层的体现。

Director Gate：PR-SPRINT 与三种评审模式

规格文件中用一张门禁表明确了该技能唯一的 director gate：

Gate ID	触发条件	模式守卫
PR-SPRINT	冲刺草稿构建完成之后	仅 full 模式（lean/solo 不触发）

三种评审模式的行为差异是整个 CCGS 门禁体系的核心概念，需要结合 gate-check.md 中定义的通用模式约定来理解：

full 模式：production/session-state/review-mode.txt内容为full。草稿完成后 spawn producer 执行 PR-SPRINT 门禁；若 producer 返回 CONCERNS，必须将意见呈现给用户，由用户决策后再修订或落盘；
lean 模式：review-mode 为lean。门禁跳过，但输出中必须明确注明[PR-SPRINT] skipped — Lean mode，且用户直接审批仍不可省——门禁跳过不等于审批跳过；
solo 模式：与 lean 等价（门禁跳过、仍需用户审批），规格文件明确说明不单独测试。

从根目录 README.md 的 Customization 一节可知，评审强度可在/start时设置，或直接编辑production/review-mode.txt，也支持通过--review solo之类的参数对任意技能做单次覆盖。

门禁的裁决方是 producer。查看 producer.md 的 Agent Test Spec 可以确认其职责边界：producer 拥有"范围管理、冲刺规划验证、里程碑跟踪、epic 优先级、生产阶段门禁"，处理的 Gate ID 包括 PR-SCOPE、PR-SPRINT、PR-MILESTONE、PR-EPIC、PR-PHASE-GATE。对 PR-SPRINT 门禁而言，producer 的 verdict 词汇是严格受限的三选一：REALISTIC / CONCERNS / UNREALISTIC，并且必须格式化为PR-SPRINT: REALISTIC这样的 gate ID 前缀形式，而不是散文式结论。其评估依据是历史 velocity 数据——例如规格中的测试场景：sprint 计划提交 12 个 story points，最近 3 个 sprint 平均 velocity 为 11.5 points，producer 应在合理偏差内判定 REALISTIC，并在理由中引用具体点数与历史 velocity。同时，producer 被要求严格待在生产域内，不得对 story 的设计质量或技术可行性发表意见。

五种测试场景详解：从 Happy Path 到边界 Case

规格文件的核心价值在于五个可执行的行为测试用例。每个用例都定义了 fixture（假定的项目状态）、输入、期望行为与可勾选断言，构成对/sprint-plan的完整行为验收。

Case 1：Happy Path —— 有 Backlog 的常规冲刺生成

Fixture（假定项目状态）：

production/milestones/milestone-02.md存在，容量为10 story points
Backlog 中包含 5 条未开始 stories，分布在 2 个 epics，优先级混杂
production/session-state/review-mode.txt内容为full
下一个 sprint 编号为003（001、002 已存在）

输入：/sprint-plan

期望行为：

技能读取当前里程碑以获取容量与目标
技能读取 backlog 中全部未开始 stories；按层次 + 优先级排序
技能在容量范围内筛选 stories，起草 sprint-003
技能在调用门禁之前先将草稿呈现给用户
技能调用 PR-SPRINT 门禁（full 模式）；producer 批准
技能询问 "May I write toproduction/sprints/sprint-003.md?"
用户批准；文件被写入

断言：

Stories 先按实现层次、再按优先级排序
在任何写入或门禁调用之前，先展示 sprint 草稿
full 模式下，草稿就绪后调用 PR-SPRINT 门禁
写入 sprint 文件之前必须询问 "May I write"
写入路径与production/sprints/sprint-003.md一致
成功写入后 verdict 为 COMPLETE

这条 Happy Path 揭示了两个关键顺序约束：草稿 → 展示 → 门禁 → 询问 → 写入。任何打乱该顺序的实现（例如先问可否写入再跑门禁）都会导致断言失败。这与 CCGS 全局的 Protocol Compliance（见下文）严格对齐。

Case 2：Blocked Path —— Backlog 为空

Fixture：

production/milestones/milestone-02.md存在
所有 epic backlog 中都没有未开始的 stories

输入：/sprint-plan

期望行为：

技能读取 backlog —— 未发现未开始 stories
技能输出 "No unstarted stories in backlog"
技能建议运行/create-stories来填充 backlog
不调用任何门禁；不写入任何文件

断言：

verdict 为 BLOCKED
输出包含 "No unstarted stories" 或等价信息
输出推荐/create-stories
PR-SPRINT 门禁未被调用
未调用任何写工具

该用例验证的是技能的优雅失败路径：数据缺失时不伪造 sprint、不静默通过，而是给出明确阻塞结论与补救动作。/create-stories正是 README.md 中 Stories & Sprints 一组里的上游技能，两者构成 pipeline 依赖关系。

Case 3：门禁返回 CONCERNS —— Sprint 超载，修订后写入

Fixture：

Backlog 有 8 条 stories，合计 16 points；里程碑容量为 10 points
review-mode.txt内容为full

输入：/sprint-plan

期望行为：

技能起草包含全部 8 条 stories 的 sprint（超出容量）
PR-SPRINT 门禁运行；producer 返回 CONCERNS：sprint 超载
技能将 CONCERNS 呈现给用户，询问要推迟哪些 stories
用户选择推迟 3 条；sprint 修订为 5 条 stories / 10 points
技能以修订后的 sprint 询问 "May I write"；批准后写入

断言：

PR-SPRINT 的 CONCERNS 在任何写入之前呈现给用户
技能允许在门禁反馈后修订 sprint
写入文件的是修订后的 sprint（而非原始草稿）
修订并写入后 verdict 为 COMPLETE

这个用例把 producer 的 CONCERNS verdict 与用户决策权链接起来：门禁的 CONCERNS 不是终止信号，而是进入用户仲裁的触发器。producer 只做容量判断（16 points > 10 points 容量），用户负责选择哪些 stories 值得保留——"revised sprint (not original) is written"这一断言确保修订必须真实落盘。

Case 4：Lean Mode —— PR-SPRINT 门禁跳过

Fixture：

Backlog 有 4 条 stories；里程碑容量为 8 points
review-mode.txt内容为lean

输入：/sprint-plan

期望行为：

技能读取评审模式 —— 判定为lean
技能起草 sprint 并呈现给用户
PR-SPRINT 门禁跳过；输出注明 "[PR-SPRINT] skipped — Lean mode"
技能请求用户直接审批 sprint
用户批准；sprint 文件写入

断言：

lean 模式下 PR-SPRINT 门禁未被调用
跳过行为在输出中被明确注明
写入前仍要求用户审批（门禁跳过 ≠ 审批跳过）
写入后 verdict 为 COMPLETE

Lean 模式是单人/小团队高节奏工作流的开关：省掉制作人审查，但人类审批这一道防线绝不撤销。跳过信息的格式与 gate-check.md Case 5b 中 solo 模式的[GATE-ID] skipped — Solo mode约定完全同构，说明该模式标记格式是全框架统一的协议语言。

Case 5：边界情况 —— 上一 Sprint 仍有未关闭 Stories

Fixture：

production/sprints/sprint-002.md存在，含 2 条仍为Status: In Progress的 stories
Backlog 有 5 条新的未开始 stories
review-mode.txt内容为full

输入：/sprint-plan

期望行为：

技能读取 sprint-002 并检测到 2 条 open（in-progress）stories
技能标记："Sprint 002 has 2 open stories — confirm carry-over before planning sprint 003"
技能向用户提供选择：carry over（结转）、defer（推迟）或 cancel（取消）
用户确认结转；结转的 stories 以[CARRY]标签前置到新 sprint 中
构建 sprint 草稿；PR-SPRINT 门禁运行；审批后写入

断言：

技能检查最近的 sprint 文件是否存在 open stories
在冲刺规划继续之前，要求用户确认结转
结转的 stories 以可区分的标签出现在新 sprint 草稿中
技能不会静默忽略上一 sprint 的 open stories

这是最考验实现严谨度的边界用例：跨冲刺结转是真实工作室中最常见的脏数据场景。技能必须主动发现遗留工作并显式询问，[CARRY]标签保证了计划的可追溯性，"does not silently ignore"断言杜绝了静默吞掉进行中工作的偷懒实现。注意结转 stories 是"prepended"（前置），体现的是遗留工作优先于新工作的排期语义。

协议合规（Protocol Compliance）：不可违背的全局红线

规格文件末尾汇总了/sprint-plan必须始终遵守的协议条款：

在调用 PR-SPRINT 门禁或询问写入之前，先展示 sprint 草稿
写入 sprint 文件之前总是询问 "May I write"
PR-SPRINT 门禁仅在 full 模式运行
lean 与 solo 模式的输出中出现跳过信息
技能输出结尾清楚陈述 verdict

这些条款与 quality-rubric.md 中sprint类别的量化指标一一对应。查看该文件的 sprint 分类部分可以看到四条核心指标：

指标	要求
SP1 — Reads sprint/milestone state	技能在产出前读取`production/sprints/`或`production/milestones/`
SP2 — Correct sprint gate	PR-SPRINT（规划）或 PR-MILESTONE（里程碑评审）门禁在`full`模式运行，`lean`/`solo`跳过
SP4 — No auto-commit	没有 "May I write" 绝不写入 sprint 文件或里程碑记录

结合 catalog.yaml 的注册信息，sprint-plan的 category 为sprint、priority 为medium、spec 路径指向 sprint-plan.md——也就是说，上面这套 SP1/SP2/SP4 指标正是/skill-test category sprint-plan的评分标准。规格与 rubric 构成了"行为契约 + 量化度量"的双层质量体系。

覆盖说明：已知边界与未测试路径

规格文件如实列出了测试覆盖的边界，这些信息对使用者判断测试充分性同样重要：

里程碑文件缺失的场景未显式测试；其行为遵循 BLOCKED 模式，并建议运行/gate-check推进里程碑阶段（/gate-check正是全框架的 6 个阶段转换把关技能，详见 gate-check.md）；
solo 模式行为与 lean 等价（门禁跳过、需要用户审批），因此未单独测试；
并行 story 选择算法不在本规格测试范围内——规格注明这些属于 sprint-plan 子代理的单元关注点（parallel story selection algorithms are unit concerns for the sprint-plan subagent），暗示实现层存在独立的排序/选择逻辑需要单独的单测覆盖。

如何运行这套验收：/skill-test 与 /skill-improve

本文介绍的规格文件不是摆设，它直接接入 CCGS Skill Testing Framework 的测试流水线（CCGS Skill Testing Framework/README.md）：

# 结构性检查（7 项静态断言，无需 fixture） /skill-test static sprint-plan # 行为规格测试（按本文五种 Case 逐条评估） /skill-test spec sprint-plan # 分类指标检查（对应用 SP1/SP2/SP4 的 sprint rubric） /skill-test category sprint-plan # 全量覆盖视图 /skill-test audit

如果测试失败，运行/skill-improve sprint-plan即可进入"测试 → 诊断 → 提出修复 → 重写 → 重测 → 保留或回滚"的完整改进循环（这是 CLAUDE.md 中定义的标准工作流）。规格文件描述的是当前行为而非理想行为，当技能实际表现与规格不符时，规范要求先修正技能本身，再让规格跟随修正后的行为——这一点在阅读与维护规格时务必牢记。

与姊妹技能的协同定位

在 CCGS 的冲刺管理能力矩阵中，/sprint-plan并非孤岛。从 sprint-status.md 的规格可以看到配套的只读技能：/sprint-status读取production/session-state/active.md找到活动 sprint 引用，统计各状态 story 数量并输出 ON TRACK / AT RISK / BLOCKED 健康度 verdict，且永不写文件、永不调用任何 director gate。两者形成完整闭环——/sprint-plan负责"创建"，/sprint-status负责"监察"，而 milestone-review.md 则在里程碑层面以 PR-MILESTONE 门禁收口。理解这一协同关系，有助于在真实项目中为冲刺排期设计端到端的工作流：规划（sprint-plan）→ 执行（dev-story / story-done）→ 监察（sprint-status）→ 里程碑评审（milestone-review）。

结语

/sprint-plan的规格文件浓缩了 CCGS 冲刺编排的全部关键设计决策：以实现层次与优先级驱动的排序契约、以里程碑容量为硬约束的筛选逻辑、full/lean/solo 三种评审强度下的门禁守卫差异、绝不绕过的人类审批协议，以及对空 backlog、超载 sprint、遗留进行中工作三类脏数据的显式处理。对于希望在自家项目中复刻这套 AI 游戏开发流程的团队而言，本文的五种测试场景 + 协议合规清单 + rubric 指标，就是一份可直接迁移到任何冲刺规划功能上的行为验收模板。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析