SuperAPI AI 工具集

harvest

数据与分析

查看项目

更新于 10-16 02:08

技能介绍

Harvest 是一个只读的 GitHub PR 数据收集与工作报告生成技能,来自 simota/agent-skills。它的核心用途是读取 GitHub PR 历史,安全地聚合数据,并转化为适合特定读者的报告。

主要能力

Harvest 支持以下任务:按仓库、时间段、作者、标签或状态筛选并获取 PR 列表;生成工程工作的周报或月报;基于已合并 PR 历史生成个人工作报告;生成标签或时间段之间的发布说明或变更日志式摘要;生成面向客户的进度报告,包含估算工作量和图表;生成融合 Judge 反馈的质量趋势报告;基于 PR 历史生成叙述性回顾或发布评论;进行 PR 规模分布分析(以 200 行代码为目标、400 行为上限基准),当大 PR 持续存在时建议使用堆叠 PR;收集 DORA 指标,包括 5 个关键指标加可靠性准指标、7 种团队画像和百分位区间;生成包含四阶段分解(编码/接收/评审/合并)的评审周期时间报告;检测橡皮图章式评审,即评审前置时间低且与 PR 规模不相关的情况。

使用方式

Harvest 通过 gh 命令读取 GitHub 数据,所有 REST 调用设置 per_page=100,多页获取使用 gh api --paginate。它遵循 SURVEY → COLLECT → ANALYZE → REPORT → VERIFY 的工作流。用户可通过第一个子命令选择配方:weekly(周报,默认)、monthly(月报,含 DORA 指标)、release(发布说明)、retro(冲刺回顾)、dora(DORA 深度分析)、okr(OKR 关联)、prstats(PR 统计深度分析)。报告模式包括 Summary、Detailed List、Individual、Release Notes、Client Report、Quality Trends 和 Retrospective Voice,决定输出形态和文件名。

适用场景

适用于需要从 GitHub PR 历史生成工程报告、发布说明、质量趋势、DORA 指标分析、OKR 关联或 PR 统计的团队。项目亲和度标注为游戏(中)、SaaS(高)、电商(高)、仪表盘(高)、营销(低)。

限制

Harvest 严格只读,绝不写入仓库、创建/编辑/关闭/评论 PR、更改标签或里程碑状态,也不通过 gh auth 更改 GitHub 认证。它不会将代码行数、提交数或 PR 数量作为直接生产力排名,也不会报告个人开发者“分数”或对贡献者进行排名。它不使用孤立的 DORA 指标而不结合 SPACE 上下文,不将团队分类为已弃用的四层性能集群,也不将失败部署恢复时间视为稳定性指标。在比较 AI 采用前后时期时,必须注明 AI 对吞吐量和稳定性的影响。收集超过 100 个 PR、访问外部仓库、拉取完整 PR 历史或应用实质性改变报告范围的自定义筛选前需要先询问。缺失字段会明确降低报告质量,绝不编造。