agile-metrics

冲刺指标

使用此技能从冲刺产物中提取客观指标，并生成量化摘要。

语言

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

项目根目录

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

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

提示

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

决策点	采用结构化提问的原因	建议选项
周期	确定数据集	上个冲刺 · 最近 N 天 · 自定义范围
要纳入的指标（多选）	影响报告内容	速度 · Lead time · Cycle time · 缺陷率 · 覆盖率 · 等

自由格式提示（不使用结构化工具）：

• 自定义指标定义

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

目标

• 将冲刺数据汇总为具体数字
• 用事实而非印象为回顾和冲刺评审提供依据
• 识别不同冲刺之间的模式（改善或退化）
• 支持容量和规划决策

适用场景

• 冲刺结束时，在评审或回顾之前
• 团队需要数据来讨论表现时
• 比较冲刺并识别趋势时
• 不确定已申报的容量是否准确时

收集的指标

交付

• 计划的故事/事项总数
• 已交付与未交付的总数
• 完成率（%）
• 冲刺期间新增的事项（范围蔓延）
• 已移除或延期的事项

质量

• 冲刺期间发现的 Bug
• 交付后发现的 Bug
• 测试覆盖率（如果可衡量）
• 结束时的 lint、类型检查或测试失败情况

流程

• 已登记的阻塞项（数量和平均持续时间）
• 故事从开始到完成的平均耗时
• 从“已完成”退回“进行中”的故事

过程

• 实际举行与预期举行的状态检查点
• 已生成的状态结项报告
• 已开启与已关闭的问题

流程

1. 收集数据

查阅冲刺产物：

• 冲刺规划（已承诺事项）
• 问题（已开启、已关闭、受阻）
• 状态检查点（阻塞项、进度）
• 状态结项报告（已执行的验证）
• 提交和 PR（变更量）

2. 计算指标

使用实际数字填写模板。不要为了让数据看起来更好而四舍五入——准确性比观感更重要。

3. 分析趋势

如果有之前冲刺的数据，请进行比较：

• 完成率是否有所提高？
• 阻塞项是否有所减少？
• 范围蔓延是否得到控制？

4. 生成摘要

摘要应足够简短，可在 2 分钟内读完。

模板

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

规则

• 指标是反思工具，而非评判工具。目标是改进流程，而不是评价人员。
• 绝不为了让数字看起来更好而操纵数据。如果冲刺表现不佳，数据就应该如实反映这一点——并在复盘中讨论原因。
• 谨慎比较不同冲刺。不同的情况（休假、外部阻碍、团队变动）会使直接比较失去意义。
• 不加讨论的指标毫无用处。务必在复盘或评审中展示指标，绝不要将其作为独立报告呈现。

与流程的关系

flowchart LR
    A["/agile-sprint"] --> B[execution]
    B --> C["/agile-status"]
    C --> D["/agile-metrics"]
    D --> E["/agile-review"]
    E --> F["/agile-retro"]

冲刺指标会提供给 /agile-review 和 /agile-retro。冲刺期间使用 /agile-status 跟踪进展。