概述
状态报告生成器（Status Report Generator）提供一套结构化框架，用于从代码活动、任务系统和里程碑跟踪中生成项目状态报告。适用于创建周更新、冲刺评审、干系人报告或项目仪表盘。
该技能的核心思路是：将分散在 Git 仓库、任务管理系统和 CI/CD 管道中的项目信号，按照统一的模板整理为可读、可对比、可行动的状态报告。
主要能力
标准报告结构
报告大纲包含以下部分：
- TL;DR（3-5 条要点）：已完成事项、进行中事项、阻塞或风险、需要的关键决策。
- 状态指示：整体 GREEN / YELLOW / RED；进度（按计划 / 有风险 / 落后）；范围（稳定 / 扩张 / 收缩）；预算（如适用）。
- 已完成事项：以 PR/工单链接为支撑的条目列表，按工作流或里程碑分组，尽量附带指标。
- 进行中工作：当前任务、预期完成时间、进度指示、负责人。
- 阻塞与风险：活跃阻塞及升级状态、新兴风险及缓解计划、对其他团队的依赖。
- 下期计划：下一冲刺/周的安排、临近的关键里程碑、需要的决策。
- 指标（如适用）：速度/吞吐量、质量指标（缺陷、事故）、业务指标影响。
数据提取方法
从 Git 历史提取：提供按时间段查询提交记录、按作者统计、查看文件变更、列出已合并/开放的 PR（含 JSON 输出与 jq 格式化）、筛选发布说明类提交等命令示例。
从任务系统提取：给出 Jira（通过 API 或 CLI，统计已完成、进行中、阻塞工单及故事点）、GitHub Issues（按状态和标签查询）、Linear（按周期统计已完成、进行中、阻塞问题及速度）的提取思路，并提供通用的表格提取模板。
自动化报告生成：描述了四步脚本思路——拉取数据、分类、汇总、格式化，并列出输出格式：Markdown（用于 Slack、GitHub、内部文档）、HTML（用于邮件）、PDF（用于干系人演示）。
RAG 状态框架
定义红黄绿三色标准：GREEN 表示按计划进行、无阻塞、指标健康；YELLOW 表示轻微延迟、新兴风险、指标下滑；RED 表示里程碑未达成、存在活跃阻塞、关键指标失败。附有按进度、范围、质量、团队四个维度的评估矩阵，整体状态取最差维度（任一维度为 RED 则整体为 RED）。还定义了 GREEN→YELLOW 和 YELLOW→RED 的触发条件，例如速度下降超过 20%、阻塞超过 2 个工作日未解决、里程碑预计延迟超过 1 周等。
面向不同受众的模板
- 高管摘要：1 页以内，要点式，含 RAG 指示，适合 VP 及以上、董事会，频率每周或双周。
- 团队状态：1-2 页，中等细节，含工单链接，适合工程团队、产品经理、设计师，频率每周或每冲刺。
- 详细技术报告：2-4 页，完整技术细节，覆盖架构/基础设施变更、代码指标（PR 数、评审时间、测试覆盖率、构建成功率、部署频率、恢复时间）、技术债、依赖更新、性能指标（p50/p95 延迟、错误率、可用率），适合技术负责人、架构师、高级工程师。
冲刺评审模板
包含冲刺编号、日期、目标、目标达成情况、演示条目（功能说明、业务影响、状态）、指标（计划与实际点数、完成率、结转）、干系人反馈、冲刺健康度表（速度、质量、范围、士气）。
里程碑跟踪
提供里程碑仪表盘模板（含目标日期、状态、置信度、关键依赖、关键路径）和燃尽叙事模板（计划/已完成/剩余故事点、剩余天数、基于历史速度的完成预测与置信度，以及落后时的三种选项：缩减范围、增加人力、延长期限及推荐建议）。
风险与阻塞升级
提供阻塞报告格式（阻塞描述、影响、负责人、状态、持续时间、根因、已尝试措施、需要什么、向谁、截止时间，以及按天递增的升级路径）和风险登记表模板，并附带严重性矩阵（按可能性与影响组合判定为 LOW/MEDIUM/HIGH/CRITICAL 及对应处理方式）。
质量检查与反模式
质量检查清单涵盖：TL;DR 是否独立可行动、RAG 是否诚实、成果是否可验证、阻塞是否含升级状态与负责人、风险是否有缓解计划、指标是否与目标对比、下一步是否具体、细节程度是否匹配受众、报告是否简洁、决策是否清晰框定。
反模式列出六类常见失败：全绿综合征、重活动轻结果、埋没坏消息、缺乏决策部分、风险信息陈旧、格式不一致。
使用方式
该技能本身是框架与模板集合，不包含可直接运行的程序。使用时可参照其中的命令示例手动或脚本化地从 Git、任务系统拉取数据，然后套用对应受众的模板填写，最终输出 Markdown、HTML 或 PDF。具体自动化实现方式由使用者自行搭建，技能未提供完整可执行脚本。
适用场景
- 每周项目更新、冲刺评审、干系人汇报、项目仪表盘。
- 需要统一报告格式、便于跨周期对比趋势的团队。
- 需要面向不同层级（高管、工程团队、技术负责人）输出不同详细程度报告的场合。
限制
- 该技能为文档/模板类技能，不包含内置的数据抓取程序或报告渲染引擎；实际数据处理需要使用者自行实现。
- 提供的命令示例基于 git、gh CLI 等工具，需要相应环境与权限；Jira、Linear 的具体 API 调用细节暂未提供。
- 文中引用的具体货币价格、收费模式、平台支持范围等信息暂未提供。