状态报告生成器Skill：把 Git 提交、任务看板与里程碑一键汇总成项目状态报告
核心结论速览：
- 它是什么：状态报告生成器（status-report-generator）是一套结构化的项目状态报告生成框架，覆盖周报、冲刺评审、里程碑跟踪与利益相关者汇报。
- 它解决什么：解决"写周报靠回忆、进度靠拍脑袋、坏消息不敢报"的老问题，让报告有数据来源、有统一口径、有可执行结论。
- 数据从哪来：从 Git 历史、GitHub PR/Issue、JIRA/Linear 工单、CI/CD 指标中提取事实数据，而不是凭空生成。
- 输出什么样：按受众分级的 Markdown / HTML / PDF 报告，执行层 1 页、团队 1–2 页、技术详版 2–4 页。
- 谁最需要：技术负责人、项目经理、Scrum Master、工程经理，以及任何需要每周向上汇报的项目参与者。
该技能叫什么？如何下载安装 AI 技能提升开发效率？
基本信息
| 项目 | 内容 |
|---|---|
| 中文名 | 状态报告生成器 |
| 英文名 | status-report-generator |
| 技能 ID | 11815 |
| 类型 | 项目管理 / 报告生成类技能 |
它解决的核心问题
团队在写项目状态报告时，通常面临三类麻烦：一是数据分散，提交记录在 Git 里、任务在 JIRA 里、里程碑在文档里，要人工来回翻；二是格式随意，每周每个人写得都不一样，无法横向对比趋势；三是报喜不报忧，风险被埋在第三页第四段，等到全面飘红才被上级发现。状态报告生成器给出的是一套"数据提取方法 + 报告骨架 + 状态判定标准"的组合，把这三件事一次性规范化。
一键安装的思路与步骤
AI 技能的安装通常遵循"找到技能 → 安装到本地技能目录 → 在会话中调用"的通用流程，本技能的具体入口与命令以官方说明为准。通用步骤参考如下：
- 确认安装前提：已具备可用的 AI 编程助手或智能体运行环境，并且该环境支持技能（Skill）机制；若需要读取 Git 与工单数据，本机需能正常访问对应代码仓库，GitHub 相关命令需已登录
ghCLI 账号。 - 定位技能：在技能市场或技能列表中按技能 ID 11815 或英文名 status-report-generator 检索；技能 ID 是唯一标识，比按名称搜索更准确。
- 执行安装：按官方提供的安装入口（技能市场点击安装、或按官方文档给出的安装指令）完成安装，具体命令与路径以官方说明为准。
- 验证是否生效：在会话中直接提出一个报告类请求，例如"帮我生成本周的项目状态报告，数据从当前仓库的 Git 历史提取"。若技能能返回带"摘要 / 状态指示器 / 成就 / 进行中 / 阻碍和风险 / 即将进行 / 指标"结构的报告大纲，即说明技能已正常加载。
- 完成首次数据接入：按技能给出的数据提取方法，确认
git log、gh pr list、任务系统导出等数据源可正常读取，再进入正式使用。
所谓"一键安装提升开发效率"，本质是把过去每次写报告都要重新设计的模板、口径和检查项，一次性固化成可复用的技能资产——之后每周只需提供数据，报告结构自动成型。
该技能的主要功能和特点
- 标准化的七段式报告结构：摘要（3–5 条要点）、状态指示器、成就、进行中、阻碍和风险、即将进行、指标，七部分固定不变，保证跨周可对比、跨团队可对齐。
- 多源数据提取方法：内置 Git 历史提取（按期提交、按作者统计、变更文件统计）、GitHub PR/Issue 提取（含
gh pr list --json结构化取值示例）、JIRA / Linear 工单提取模板，以及 CI/CD 指标的纳入方式。 - RAG（红黄绿）状态判定框架：明确定义绿色（按计划）、黄色（存在风险）、红色（偏离计划）的判定标准与所需行动，并给出进度、范围、质量、团队四个维度的评估矩阵，规定"总体状态 = 最差维度状态"，从机制上防止"全绿综合症"。
- 状态跃迁触发器：把"什么时候该从绿转黄、从黄转红"写成可判断的条件，例如冲刺速度下降超过平均 20%、阻碍未解决超过 2 个工作日、里程碑将错过超过 1 周等，让预警有据可依。
- 受众分级模板：为 C 级/副总裁（最多 1 页）、工程与产品团队（1–2 页）、技术负责人与架构师（2–4 页）分别提供模板，字段与粒度各不相同，避免"一份报告发给所有人"。
- 专项模板集：冲刺评审模板（目标达成度、演示项目、完成率、冲刺健康四维表）、里程碑仪表板（目标日期 + RAG + 信心度）、燃尽叙事（按最近 3 个冲刺平均速度预测完成时间并给出范围/资源/时间三种应对方案）。
- 阻碍与风险治理组件：阻碍升级格式（影响、负责人、年龄、根本原因、已尝试、需要的决策、升级路径）与风险登记表（可能性 × 影响 = 严重性，配套四级响应策略）。
- 质量检查清单与反模式库：10 项报告自检清单，以及 6 类常见失败模式（活动多于结果、埋藏坏消息、无决策部分、陈旧风险等）及其修复建议。
- 和普通工具比强在哪：普通的文档模板只给空壳，普通的 AI 对话只给一次性文字，而这个技能同时提供了"数据怎么取、状态怎么判、报告怎么写、写得好不好怎么查"的完整闭环，并把"决策请求"作为报告的一等公民。
如何使用该技能？
第 1 步：确认数据源并拉起原始数据
先明确本期范围（例如"最近一周"或"本冲刺"），然后按技能提供的方法提取数据：
git log --since="1 week ago" --oneline --no-merges
git shortlog --since="1 week ago" -sn --no-merges
gh pr list --state merged --json title,author,mergedAt,url \
--jq '.[] | "- \(.title) (@\(.author.login)) \(.url)"'
工单侧则按 JIRA / GitHub Issue / Linear 的对应方式导出，并填入统一表格：工单、标题、状态、负责人、备注。
第 2 步：选择受众模板
- 给管理层看：选"执行摘要"模板，控制在 1 页内。
- 给研发团队看：选"团队状态"模板，含工单与 PR 链接。
- 给技术负责人看：选"详细技术报告"模板，含代码指标、依赖更新、性能数据。
- 开冲刺评审会：选"冲刺评审"模板。
第 3 步：把数据交给技能，生成报告骨架
输入示例（可直接照抄改写）：
请用状态报告生成器为我生成一份团队周报。受众是研发团队和产品经理；周期为 2025-01-06 至 2025-01-12。以下是本期的 PR 合并列表、进行中工单与受阻工单：（在此粘贴第 1 步得到的数据）
输出说明：技能会返回一份包含七段结构的 Markdown 报告，其中成就部分按工作流分组并附 PR 链接，进行中部分标注完成百分比与负责人，受阻部分附升级状态。
第 4 步：做 RAG 评级
按四维评估矩阵逐项判断进度、范围、质量、团队，取最差维度作为总体状态。若任一维度触发了状态跃迁条件（如阻碍超过 2 个工作日未解决），即使整体感觉尚可也应标黄。
第 5 步：补充"所需决策"与"下一步"
确保报告里包含明确的决策请求，写清选项与建议。例如：
所需决策：是否将"支付重构"移出本里程碑以保住 1 月 24 日发布？选项 A：削减该功能（保发布）；选项 B：延期一周（保功能）。建议选 A，理由是依赖方已锁定发布时间。
第 6 步：过一遍质量检查清单
逐条核对：摘要能否独立成立、RAG 是否诚实、成就是否可验证、阻碍是否带负责人与升级状态、风险是否有缓解计划、指标是否与目标对比、下一步是否有负责人与日期、详细程度是否匹配受众、篇幅是否超标、决策是否清晰。
第 7 步：按格式输出
Markdown 用于 Slack、GitHub 与内部文档；HTML 用于邮件；PDF 用于利益相关者演示。
同类型竞品对比分析
| 方案名称 | 定位 | 核心功能 | 安装/使用门槛 | 适用场景 | 优势与不足 |
|---|---|---|---|---|---|
| 状态报告生成器（本技能） | 报告框架 + 数据提取方法 + 判定标准 | 七段式结构、RAG 四维矩阵、受众分级模板、冲刺评审与里程碑模板、质量清单与反模式库 | 需在支持技能的 AI 环境中安装，技能 ID 为 11815；数据源需能访问仓库与工单系统 | 周报、冲刺评审、里程碑汇报、向上管理 | 优势：口径统一、判定可复用、强调决策驱动；不足：不负责数据自动采集，无实时看板界面，需人工或脚本喂数据 |
| JIRA / Linear 自带报表 | 项目管理工具内置度量 | 燃尽图、速度图、周期时间、累积流图 | 已付费使用该工具即可，几乎零门槛 | 已在工具内管理全部任务的团队 | 优势：数据自动、图表直观；不足：只反映工具内数据，无法融合 Git 提交与 PR 事实，难以直接产出给管理层的叙述型报告 |
| 通用 AI 助手（直接对话） | 通用文本生成 | 任意文本写作、总结 | 零门槛 | 临时写一次报告、无固定格式要求 | 优势：灵活；不足：每次结果结构不一致、缺少状态判定标准、容易生成"报喜不报忧"的乐观表述，也无质量检查机制 |
| 手写周报模板（文档 / 表格） | 传统人工模板 | 固定字段填空 | 零门槛 | 小团队、低频汇报 | 优势：简单；不足：数据需人工回忆整理，耗时且易失真，模板只会给空壳，不会帮你判断红黄绿 |
选型建议：如果团队已经在 JIRA/Linear 中管理全部工作且只需要图表趋势，工具自带报表更省事；如果汇报对象是管理层、需要把代码活动翻译成业务语言、并且希望预警机制有统一标准，本技能的框架价值更突出；如果只是偶尔写一次，用通用 AI 对话即可。
该技能的典型应用场景与实际体验情况
场景一：研发团队的每周固定周报
角色是技术负责人或 Scrum Master，痛点是每周五花两小时翻提交记录、拼凑进度、还要回忆哪些任务卡住了。使用方式是执行技能提供的 Git 与 PR 提取命令，把输出连同进行中、受阻工单一起交给技能，按"团队状态"模板生成报告。实际体验：上手难度低，只要命令能跑通，报告骨架几乎即时成型；效果上最明显的是"成就"部分自动带上 PR 链接，变得可验证；注意事项是要提前统一工单状态命名（“进行中”"受阻"用词一致），否则分类会混乱。
场景二：冲刺评审会前的准备
角色是产品经理，痛点是评审会容易变成功能演示流水账，缺少对目标达成度与冲刺健康的复盘。使用方式是套用冲刺评审模板，逐项填写目标达成（是/部分/否）、演示项目及其业务影响、计划与完成的点数对比、携带工单及原因。实际体验：模板里的"冲刺健康"四维表（速度/质量/范围/士气）非常实用，能把"感觉还行"变成可视判断；注意士气维度需要团队自评，不宜由个人代填。
场景三：向 VP / C 级汇报的月度状态
角色是工程经理，痛点是汇报篇幅失控、风险被稀释。使用方式是采用执行摘要模板，控制在 1 页内，只保留亮点、最高风险及缓解状态、所需决策、下一里程碑与信心度。实际体验：强制一页的限制最有价值，倒逼团队挑重点；“所需决策"字段显著提升了汇报的会议转化率——从"听完就散"变成"当场拍板”。
场景四：里程碑发布前的风险排查
角色是项目经理，痛点是发布临近才发现关键路径卡住。使用方式是搭建里程碑仪表板（各节点目标日期 + RAG + 信心度），配合燃尽叙事按最近 3 个冲刺平均速度推算完成时间，若落后则套用"减范围 / 加资源 / 延时间"三选项模板给出建议。实际体验：把"我们可能要延期"变成"按当前速度将延迟 6 天，建议削减 X 点范围"，沟通阻力明显下降；注意事项是速度预测依赖历史数据的准确性，冲刺数据不规范的团队预测偏差会较大。
该技能能为用户带来的价值
效率层面的提升：报告从"回忆式写作"转为"数据归纳式写作"，把过去每周数小时的数据搜集与格式整理压缩为提取命令 + 一次生成 + 一轮检查；受众分级模板免去了"同一份报告改三个版本"的重复劳动。
质量层面的提升：RAG 四维矩阵、“总体状态取最差维度"的规则和状态跃迁触发器，从制度上遏制"全绿综合症”；质量检查清单与反模式库把资深项目经理的经验固化为可执行的检查项，新人也能写出合格的报告。
沟通层面的提升：把"活动"翻译成"结果"——从"合并了 47 个 PR"变成"发布结账 v2，购物车放弃率下降 12%“；把风险从第三页的角落搬到摘要区；把决策请求明确成"选项 + 建议”。这三点直接改善跨层级沟通效率。
长期价值：模板固定 → 报告可横向对比 → 趋势可被识别。连续数周使用同一结构后，团队能看出速度、质量、范围的真实变化曲线，而不是每次都从零判断"这周算不算顺利"。同时，风险登记表与阻碍升级记录会沉淀为项目复盘的一手材料。
门槛降低的体现：不熟悉项目管理方法论的工程师，也能通过填空式模板写出一份结构完整、判定有据的状态报告，把"怎么写报告"这件事从隐性技能变成显性流程。
常见问题 FAQ
Q1：这个技能怎么安装？安装后怎么确认能用？
在支持技能机制的 AI 环境中，按技能 ID 11815 或英文名 status-report-generator 检索并安装，具体安装入口与命令以官方说明为准。验证方式是提出一个报告类请求，若返回包含"摘要 / 状态指示器 / 成就 / 进行中 / 阻碍和风险 / 即将进行 / 指标"七段结构的报告，即说明已生效。
Q2：使用这个技能收费吗？
技能本身的费用与所在平台的计费方式有关，请以官方说明为准。需要额外注意的是间接成本：如果使用 GitHub 相关命令，需要本地已登录 gh CLI；如果接入 JIRA / Linear API，可能需要相应的账号权限。
Q3：它会不会自动帮我抓取 Git 和工单数据？
不会。技能提供的是数据提取方法与命令示例（例如 git log --since="1 week ago"、gh pr list --state merged --json ...），以及统一的数据整理表格，实际执行取数由你或你的脚本完成，再把结果交给技能生成报告。这是它和项目管理工具自带图表最主要的差别。
Q4：适合哪些人用？小团队有必要吗？
最适合技术负责人、项目经理、Scrum Master、工程经理，以及需要定期向上汇报的开发者。小团队同样适用——尤其是"执行摘要"与"团队状态"两个轻量模板，1 页纸就能满足需求；如果只是偶尔写一次报告，收益有限。
Q5：和 JIRA/Linear 自带报表、直接用 AI 对话写周报相比怎么选？
需要自动化图表趋势、且所有工作都在工具内管理 → 选工具自带报表；只需要一次性文字、无固定格式 → 直接对话即可；需要统一口径、把 Git 活动与工单事实合并成叙述型报告、并希望风险预警有明确判定标准 → 选本技能的框架。三者也可以组合：先用工具取数，再用本技能组织成面向管理层的叙述型报告。