name: 状态报告生成器
description: 从Git历史、任务上下文和里程碑跟踪生成项目状态报告。用于创建每周更新、冲刺评审、利益相关者报告或项目仪表板。
状态报告生成器
用于从代码活动、任务系统和里程碑跟踪生成项目状态报告的结构化框架。
状态报告结构
标准报告部分
状态报告大纲：
1. 摘要（3-5个要点）
- 完成的工作
- 进行中的工作
- 受阻或存在风险的工作
- 关键决策（如有）
2. 状态指示器
- 总体：绿色 / 黄色 / 红色
- 进度：按计划 / 存在风险 / 落后
- 范围：稳定 / 扩展 / 收缩
- 预算：按计划 / 存在风险 / 超支（如适用）
3. 成就（本期完成）
- 带PR/工单链接的要点列表
- 按工作流或里程碑分组
- 尽可能包含指标
4. 进行中（活跃工作）
- 当前任务和预期完成时间
- 进度指示器（百分比或状态）
- 每个项目的负责人
5. 阻碍和风险
- 活跃阻碍及其升级状态
- 新出现的风险及缓解计划
- 对其他团队的依赖
6. 即将进行（下一周期）
- 下一冲刺/周的计划工作
- 即将到来的关键里程碑
- 需要的决策
7. 指标（如适用）
- 速度 / 吞吐量
- 质量指标（错误、事件）
- 业务指标影响
数据提取方法
从Git历史
用于状态报告的Git数据：
本期的提交：
git log --since="1 week ago" --oneline --no-merges
按作者的提交：
git shortlog --since="1 week ago" -sn --no-merges
更改的文件：
git diff --stat HEAD~{n}..HEAD
合并的PR（GitHub）：
gh pr list --state merged --search "merged:>=2025-01-01"
PR摘要：
gh pr list --state merged --json title,author,mergedAt,url \
--jq '.[] | "- \(.title) (@\(.author.login)) \(.url)"'
开放的PR：
gh pr list --state open --json title,author,url \
--jq '.[] | "- \(.title) (@\(.author.login)) \(.url)"'
发布说明：
git log --since="1 week ago" --pretty=format:"- %s" --no-merges \
| grep -E "^- (feat|fix|refactor|perf):"
从任务系统
任务数据提取：
JIRA（通过API或CLI）：
- 本冲刺移至“完成”的工单
- 当前“进行中”的工单
- “受阻”状态的工单
- 完成与计划的故事点
GitHub问题：
gh issue list --state closed --search "closed:>=2025-01-01"
gh issue list --state open --label "in-progress"
gh issue list --state open --label "blocked"
Linear（通过API）：
- 本周期完成的问题
- 进行中的问题
- 受阻问题及原因
- 周期速度指标
通用提取模板：
| 工单 | 标题 | 状态 | 负责人 | 备注 |
|--------|-------|--------|-------|-------|
| | | | | |
自动化报告生成
报告生成脚本方法：
1. 拉取数据
- 本期的Git日志
- PR合并数据
- 问题/工单状态
- CI/CD指标（构建成功率、部署次数）
2. 分类
- 按类型分组提交（功能、修复、重构等）
- 按里程碑或史诗分组问题
- 从问题标签识别阻碍
3. 摘要
- 计数：X个功能发布、Y个错误修复、Z个PR合并
- 亮点：最大成果和剩余风险
- 指标：速度、周期时间、吞吐量
4. 格式化
- 根据受众应用模板（执行层、团队、详细）
- 添加状态指示器（RAG）
- 包含源数据链接
输出格式：
- Markdown（用于Slack、GitHub、内部文档）
- HTML（用于电子邮件）
- PDF（用于利益相关者演示）
RAG状态框架
状态定义
| 颜色 |
含义 |
标准 |
所需行动 |
| 绿色 |
按计划进行 |
里程碑按进度、无阻碍、指标健康 |
按计划继续 |
| 黄色 |
存在风险 |
轻微延迟、新出现风险、指标下降 |
密切监控，缓解计划 |
| 红色 |
偏离计划 |
里程碑错过、活跃阻碍、关键指标失败 |
立即升级，干预 |
RAG评估矩阵
评估每个维度：
进度：
绿色： 所有里程碑按计划或提前
黄色： 1-2项落后，可在冲刺内恢复
红色： 关键里程碑存在风险，需要恢复计划
范围：
绿色： 范围稳定，需求清晰
黄色： 轻微范围增加，通过待办事项管理
红色： 显著范围蔓延，需要重新优先级排序
质量：
绿色： 错误率正常，测试覆盖率稳定，无事件
黄色： 错误率升高，识别测试差距
红色： 生产环境中关键错误，质量下降
团队：
绿色： 团队能力充足，士气良好
黄色： 关键人员风险或能力限制
红色： 关键人员缺口，团队疲劳风险
总体状态 = 最差维度状态
（如有任何维度为红色，总体为红色）
状态变化触发器
绿色→黄色触发器：
- 冲刺速度下降>平均20%
- 阻碍未解决>2个工作日
- 未计划工作超过冲刺能力30%
- 关键依赖被合作团队延迟
- 识别新风险无缓解计划
黄色→红色触发器：
- 里程碑将错过>1周
- 关键路径受阻，无解决方法
- 需要利益相关者升级
- 团队能力<计划70%
- 质量指标低于可接受阈值
利益相关者适当详细级别
执行摘要（C级/副总裁）
执行状态报告：
格式：最多1页，要点、RAG指示器
频率：每周或每两周
受众：副总裁及以上、C级、董事会
模板：
项目： [名称]
周期： [日期范围]
状态： [绿色 / 黄色 / 红色]
亮点：
- [最大成果/成就]
- [关键指标改进]
- [重要里程碑达成]
风险：
- [最高风险+缓解状态]
- [第二风险（如适用）]
所需决策：
- [具体请求，含选项和建议]
下一个里程碑：[内容] 于 [时间]
信心：[高 / 中 / 低]
团队状态（工程/产品）
团队状态报告：
格式：1-2页，适度详细，带工单链接
频率：每周（或每冲刺）
受众：工程团队、产品经理、设计师
模板：
冲刺：[编号] | [日期范围]
速度：[X] 点 / [Y] 计划 ([Z]%)
完成：
- [功能/修复] - [PR #链接] (@负责人)
- [功能/修复] - [PR #链接] (@负责人)
- [功能/修复] - [PR #链接] (@负责人)
进行中：
- [任务] - [X]% 完成 - 预计完成时间 [日期] (@负责人)
- [任务] - [X]% 完成 - 预计完成时间 [日期] (@负责人)
受阻：
- [任务] - 受阻于 [原因] - 已升级给 [谁]
错误：
- [X] 个新错误报告
- [Y] 个错误修复
- [Z] 个剩余错误 (P0: _, P1: _, P2: _)
携带：
- [未完成任务] - 原因：[为什么] - 新预计完成时间：[日期]
下一个冲刺计划：
- [计划项目1]
- [计划项目2]
- [计划项目3]
回顾笔记：
- 顺利进行：[简要]
- 需要改进：[简要]
详细技术报告
详细状态报告：
格式：2-4页，全技术详细
频率：每冲刺或每两周
受众：技术负责人、架构师、高级工程师
模板：
架构/基础设施：
- 部署的更改：[列表]
- 性能影响：[指标]
- 事件：[计数、严重性、解决]
代码指标：
- 合并的PR：[计数]
- 平均评审时间：[小时]
- 测试覆盖率：[当前] (变化： [+/-X%])
- 构建成功率：[%]
- 部署频率：[本期计数]
- 平均恢复时间：[小时/分钟]
技术债务：
- 增加的债务：[项目]
- 解决的债务：[项目]
- 净债务趋势：[增加/减少/稳定]
依赖更新：
- [包] 从 [v1] 更新到 [v2] - [原因]
- [安全补丁] 应用 - [CVE参考]
性能：
- p50延迟：[Xms] (目标：[Yms])
- p95延迟：[Xms] (目标：[Yms])
- 错误率：[X%] (目标：< [Y%])
- 正常运行时间：[X%] (目标：[Y%])
冲刺评审模板
冲刺评审：
冲刺：[编号]
日期：[开始] - [结束]
目标：[冲刺目标陈述]
目标达成：[是 / 部分 / 否]
演示项目：
1. [功能] - 演示者 [@人员]
- 功能：[简要描述]
- 重要性：[用户/业务影响]
- 状态：[已发布 / 准备发布 / 需要改进]
2. [功能] - 演示者 [@人员]
- 功能：[简要描述]
- 重要性：[用户/业务影响]
- 状态：[已发布 / 准备发布 / 需要改进]
指标：
- 计划：[X] 点，跨 [Y] 个工单
- 完成：[X] 点，跨 [Y] 个工单
- 完成率：[Z%]
- 携带：[X] 个工单 ([原因])
利益相关者反馈：
- [反馈项目1]
- [反馈项目2]
冲刺健康：
| 维度 | 状态 | 备注 |
|-----------|--------|-------|
| 速度 | / / | |
| 质量 | / / | |
| 范围 | / / | |
| 士气 | / / | |
里程碑跟踪
里程碑仪表板模板
项目里程碑：
里程碑 目标日期 状态 信心
────────────────────────────────────────────────────────
Alpha发布 [日期] [RAG] [高/中/低]
Beta发布 [日期] [RAG] [高/中/低]
功能冻结 [日期] [RAG] [高/中/低]
QA完成 [日期] [RAG] [高/中/低]
发布 [日期] [RAG] [高/中/低]
关键依赖：
- [里程碑X] 依赖于 [团队Y] 完成 [任务Z] 于 [日期]
- [里程碑A] 依赖于 [外部供应商] 交付 [事物] 于 [日期]
关键路径：
[任务1] → [任务2] → [任务3] → [发布]
↗ [任务4] ↗
燃尽叙事
燃尽摘要：
计划：[X] 个故事点用于此里程碑
完成：[Y] 个故事点 ([Z]% 的计划)
剩余：[W] 个故事点
剩余天数：[N] 天
速度（最近3个冲刺）：[A], [B], [C] = 平均 [D] 点/冲刺
剩余冲刺：[M]
预计完成：[剩余点 / 平均速度] = [N] 个冲刺
在当前速度下：
- 将 [按时完成 / X天提前 / X天延迟]
- 信心：[高 / 中 / 低]
如落后：
- 选项A：减少范围 [X] 点（削减 [功能]）
- 选项B：增加 [X] 能力（招聘/借用）
- 选项C：延长截止日期 [X] 天
- 建议：[哪个选项及原因]
风险和阻碍升级
阻碍升级格式
阻碍报告：
阻碍：[受阻内容的清晰描述]
影响：[无法进行的工作]
负责人：[负责解决的人]
状态：[新 / 已升级 / 进行中 / 已解决]
年龄：[自识别以来的天数]
根本原因：[为什么受阻]
已尝试：[已尝试的方法]
需要：[需要的具体行动或决策]
来自：[需要行动的人]
截止：[避免里程碑影响的日期]
升级路径：
第1天： 向团队负责人提出
第2天： 升级给经理
第3天以上： 升级给总监/副总裁
第5天以上： 执行升级
风险登记模板
| 风险 |
可能性 |
影响 |
严重性 |
缓解 |
负责人 |
状态 |
| [描述] |
高/中/低 |
高/中/低 |
[可能性×影响] |
[计划] |
[名称] |
[开放/已缓解] |
严重性矩阵：
低影响 中影响 高影响
高可能性： 中 高 关键
中可能性： 低 中 高
低可能性： 低 低 中
关键：立即行动，执行层可见
高： 本冲刺需要主动缓解
中： 监控，记录缓解计划
低： 接受，季度审查
状态报告质量检查清单
| 检查 |
状态 |
| 摘要部分独立且可操作 |
[ ] |
| RAG状态诚实（不乐观） |
[ ] |
| 成就链接到PR/工单（可验证） |
[ ] |
| 阻碍包括升级状态和负责人 |
[ ] |
| 风险有缓解计划 |
[ ] |
| 指标与目标比较（不仅报告） |
[ ] |
| 下一步具体，有负责人和日期 |
[ ] |
| 详细级别匹配受众 |
[ ] |
| 报告简洁（执行层：1页，团队：2页） |
[ ] |
| 所需决策清晰框定，含选项 |
[ ] |
状态报告反模式
常见状态报告失败：
1. 全绿综合症
问题：一切皆绿直到突然变红
修复：早期诚实报告黄色；建立信任
2. 活动多于结果
问题：“我们合并了47个PR”（那又怎样？）
修复：“发布了结账v2，减少了12%的购物车放弃率”
3. 埋藏坏消息
问题：阻碍在第3页第4段提及
修复：摘要部分清晰标注阻碍
4. 无决策部分
问题：报告是信息性的但不驱动行动
修复：如有决策，始终包含“所需决策”
5. 陈旧风险
问题：同一风险列出6个月无更新
修复：每报告更新风险状态；关闭已解决的风险
6. 格式不一致
问题：每周不同格式，难以比较
修复：使用相同模板；一致性有助于趋势发现
另请参阅