Git-History Reflection Skill

Git-History Reflection Skill 是什么

分析提交历史、变更节奏和仓库级模式，用于个人自我反思或已获全员同意的非惩罚性团队复盘。

适用场景

适合本人代码习惯回顾、团队流程讨论、bus factor 和提交结构观察，不适用于绩效或监控。

核心能力与工作机制

清单强制 repo_path、同意声明、本人默认范围和多作者双重确认，支持 Markdown、JSON、HTML、PDF 及可选复杂度分析。

执行流程

先确认所有作者知情同意和非 HR 用途，限制仓库与日期范围；带 –i-have-consent 运行，解释结果为提问线索而非人员结论。

输入与输出

需要仓库路径、日期范围、输出格式、明确同意；多作者还需逐一 consented-author。输出描述性历史报告和仓库级提示，不提供个人排名、生产力分数或绩效结论。

依赖、账号与权限

依赖 Git、Python 脚本；PDF 可选 weasyprint 或 pdfkit，Python 复杂度分析依赖 radon。

副作用、限制与风险

提交历史属于人员数据且存在偏差，无法反映评审、设计和辅导贡献；可能触及隐私和劳动法规。只读 Git 历史并生成本地报告，但报告本身可能包含作者和时间信息。

不适用边界

严禁用于排名、薪酬、晋升、纪律处分、监视或未同意的个人分析，含糊请求必须拒绝或澄清。

失败处理与验收

缺少同意或参数时工具应拒绝；PDF 依赖失败可降级为 Markdown/HTML，不削弱隐私门禁。检查报告顶部用途限制、作者范围和日期，确保没有禁止指标，并由参与者共同审阅解释。

适合谁使用

适合个人开发者和获得全员知情同意的工程团队复盘。

来源、版本与许可

本条目依据 SkillHub 热门榜、发布者详情和版本 1.1.1 的完整 SKILL.md 整理，核验日期为 2026 年 9 月 21 日。完整 SKILL.md 声明许可证为 MIT。 SkillHub 当前两套安全扫描状态为 benign、benign；该状态只是平台信号，不能替代对脚本、凭据、网络请求、数据外送与后续版本的人工审查。

常见问题

1. Git-History Reflection Skill 主要解决什么问题？

分析提交历史、变更节奏和仓库级模式，用于个人自我反思或已获全员同意的非惩罚性团队复盘。适合本人代码习惯回顾、团队流程讨论、bus factor 和提交结构观察，不适用于绩效或监控。是否采用它，应以实际任务边界和可核验材料为准，不要因为榜单热度而跳过来源审查。

2. 开始前需要准备什么？

需要仓库路径、日期范围、输出格式、明确同意；多作者还需逐一 consented-author。准备阶段不要代替用户猜测关键事实；缺少会改变路线、费用或权限的输入时，应先补齐再执行。

3. 它怎样完成任务并交付结果？

先确认所有作者知情同意和非 HR 用途，限制仓库与日期范围；带 –i-have-consent 运行，解释结果为提问线索而非人员结论。每个阶段都要保留输入、决策、输出和检查点，不能把计划、预览或排队状态描述成最终交付。

4. 需要哪些工具、账号或权限？

依赖 Git、Python 脚本；PDF 可选 weasyprint 或 pdfkit，Python 复杂度分析依赖 radon。凭据应放在安全环境中，并按最小权限授权；账号、网络或本地依赖不满足时应明确停止条件。

5. 它会产生哪些外部操作或副作用？

只读 Git 历史并生成本地报告，但报告本身可能包含作者和时间信息。涉及外部写入、上传、发送、付费或持久配置时，应在实际动作前说明影响范围并取得相应确认。

6. 哪些情况不适合使用？

严禁用于排名、薪酬、晋升、纪律处分、监视或未同意的个人分析，含糊请求必须拒绝或澄清。超出来源明确能力、专业资质或授权范围时，应切换到更合适的工具或交给专业人员处理。

7. 失败或结果异常时怎样恢复？

缺少同意或参数时工具应拒绝；PDF 依赖失败可降级为 Markdown/HTML，不削弱隐私门禁。恢复时优先查询已有任务、日志或备份，避免无上限重试、重复扣费、重复发送或覆盖唯一原件。

8. 如何验收结果并控制风险？

检查报告顶部用途限制、作者范围和日期，确保没有禁止指标，并由参与者共同审阅解释。验收应基于真实文件、页面、任务终态或权威来源，并把未能实际检查的部分明确标记出来。