SuperAPI AI 工具集

author-contributions

通用与其它

查看项目

更新于 10-16 00:32

技能介绍

用途:在给定分支相对上游(如 main)的差异中,找出某位作者实际贡献的所有文件,并跨重命名追溯其贡献。适用于回答“谁编辑了什么”“某作者贡献的哪些代码会随分支合入上游”等问题。

主要能力:通过 git log 精确匹配作者身份;收集该作者直接提交过的文件;基于全部提交(不只该作者的)构建重命名映射;结合分支相对上游的合并差异,将文件分类为 DIRECT(作者直接提交)或 VIA_RENAME(经重命名链路追溯到该作者),并给出每个文件的行数增减统计,最后输出 Markdown 表格与总计行。

使用方式:技能涉及大量顺序执行的 git 命令,建议作为子代理运行,向子代理给出类似“找出作者 Full Name 在分支 branch 相对 upstream 贡献的每个文件,跨重命名追溯,返回含 Status、File Path、Lines 的 Markdown 表格并附汇总行”的提示。步骤包括:先用 git log --format="%an <%ae>" <upstream>..<branch> | sort -u 确定作者的精确 git 身份,再用 git log --author="<Exact Name>" --format="%H" <upstream>..<branch> 收集提交,配合 git diff-tree --no-commit-id --name-only -r <hash> 提取涉及文件;随后用 git diff-tree --no-commit-id -r -M <hash> 解析 R 状态构建重命名映射;用 git diff --name-only <upstream>..<branch> 取得合并差异文件列表;对每个文件按是否在作者文件集中或可经重命名链追溯到作者来分类;最后用 git diff --stat <upstream>..<branch> -- <files> 获取增减统计。文档建议用 Python 处理繁重工作(zsh 中带内联注释的 shell 循环会失败),写入临时 .py 脚本、运行后删除;并提供了示例脚本与一种替代脚本用于交叉核对,可选择是否包含 src/vs/sessions 路径。

限制与注意:作者匹配为精确匹配,必须先执行身份识别步骤,--author 虽为子串匹配但需人工核验(例如查找 Joshua Smith 时不要误匹配 Josh S.),可通过 git log 或 GitHub MCP get_me 解析完整姓名。重命名可能多跳(如 contrib/chat/ → agentSessions/ → sessions/),映射需传递式遍历。只报告出现在合并差异中的文件,作者改过但后来被完全删除的文件不应出现。重命名映射必须包含所有作者的提交,而非仅目标作者的提交。

其他信息(如具体支持的操作系统、安装命令、费用与平台等)暂未提供。