用途:根据 Git 仓库的提交记录、代码改动和贡献模式,在指定时间范围内生成工作汇报或绩效评审素材,用于总结个人或团队在一段时间内的工作产出。
主要能力:分析一个或多个本地 Git 仓库;按作者(姓名或邮箱)过滤提交;统计提交总数、变更文件数、代码新增与删除行数;生成周/月维度的提交频率、文件类型分布、改动最多的文件、最大提交等指标;按提交信息归纳主要功能与改动,形成成就列表;输出 markdown、text 或 json 格式,并给出仓库、时间范围、贡献统计、关键成就和可选时间线等分段报告。
使用方式:先收集仓库路径、时间范围(如 2024-01-01 到 2024-12-31 或季度)、可选作者过滤和输出格式,默认 markdown。用 Bash 验证仓库:cd <repo_path> && git rev-parse --git-dir。再运行分析脚本:python $SKILL_ROOT/scripts/analyze_work.py --repo <absolute_repo_path> --start-date <YYYY-MM-DD> --end-date <YYYY-MM-DD> --author "<author_name_or_email>" --output <output_json_path> --format <markdown|text|json>;多仓库可在 --repo 后跟多个路径。随后读取生成的输出文件并整理报告。脚本依赖 Python 3.8+ 与 GitPython,可用 pip install -r $SKILL_ROOT/scripts/requirements.txt 安装。输出 JSON 含 summary、commits、statistics、achievements 等结构。
适用场景:需要生成工作汇报、绩效评审、季度或月度贡献统计、代码活动报告时使用。
限制:摘要质量依赖提交信息质量;需保证作者过滤与 git 配置匹配;日期需用 YYYY-MM-DD 格式;可能因仓库无效、无提交或权限不足而失败;具体安装与运行细节以实际技能环境为准,其他收费、平台等信息暂未提供。