mcpField
G
github-contribution-period-analysis

github-contribution-period-analysis

github.com/tiangong-ai数据与数据库1141 次安装1 周前更新
代码仓库

关于 github-contribution-period-analysis

GitHub Contribution Period Analysis 是用于生成 GitHub 用户在 UTC 时间范围内贡献证据报告的技能，报告采用 Markdown 格式。它统计用户创建或合并的 PR 及其提交，覆盖范围受 API 凭据限制。

主要功能

  1. 01分析 UTC 时间范围内的贡献
  2. 02统计用户创建和合并的 PR
  3. 03统计目标用户编写的提交
  4. 04生成指标、仓库明细和时间线
  5. 05提供变更的证据链接

适用场景

  1. 01回顾用户在指定时段的代码贡献
  2. 02比较不同仓库的贡献活动
  3. 03整理附有 PR 和提交证据链接的报告

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/tiangong-ai/agent-skills --skill github-contribution-period-analysis

安装后在 Claude Code 中输入/github-contribution-period-analysis确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

agents/
openai.yaml
references/
data-model.md
env.md
markdown-template.md
scripts/
github_contribution_report.py

详细介绍

GitHub 贡献周期分析

核心目标

  • 为 UTC 时间范围内的一位目标 GitHub 用户生成基于证据的 Markdown 报告。
  • 聚焦于实用的代码贡献信号：已合并的 PR 和提交活动。
  • 覆盖用户自己的仓库和其他仓库，但受凭据访问权限限制。

工作流

  1. 准备用于访问 GitHub API 的身份验证。
  2. 使用目标用户和时间范围运行 scripts/github_contribution_report.py。
  3. 查看生成的 Markdown 报告并检查证据链接。

命令

python3 scripts/github_contribution_report.py \
  --user <github-login> \
  --start 2026-03-01 \
  --end 2026-03-08 \
  --output /tmp/github-contribution-report.md

输出说明

  • 纳入的贡献类型：
    • 作者提交且已合并的 PR。
    • 由目标用户合并的 PR（维护者的合并工作）。
    • 作者提交的提交记录。
  • 排除的活动类型：
    • 评论、评审、星标、关注、复刻。
  • 报告包含：
    • 范围和覆盖情况说明。
    • 汇总指标。
    • 根据 PR/提交证据推断的实质性工作类别。
    • 附有代表性证据链接的工作内容亮点。
    • 仓库分类汇总。
    • 各仓库的具体变更详情（针对每个有变更的仓库）。
    • 贡献时间线。
    • 主要贡献表格。
    • 附有 PR/提交 URL 的证据附录。

重要限制

  • SSH 密钥仅用于 git 传输，不能直接授权 GitHub REST API 调用。
  • 要覆盖私有仓库，需通过经过身份验证的 API 访问，通常使用 GITHUB_TOKEN/GH_TOKEN 或 gh auth token。
  • GitHub Search API 每次查询最多返回 1000 条结果。对于活动频繁的用户，请拆分时间范围并运行多次报告。

参考资料

  • references/env.md
  • references/data-model.md
  • references/markdown-template.md

脚本

  • scripts/github_contribution_report.py

评论

支持 Markdown