仓库协作分析工具(免费版)

概述

actor-identifier-tool-free 为个人开发者提供 Git 仓库级别的协作模式分析能力。它通过原生只读 git 命令收集聚合指标,输出仓库级的协作模式报告,帮助你洞察个人或小团队项目的提交节奏、代码流失率、约定式合规率与巴士因子风险。

本工具严格遵循隐私优先原则:零安装依赖、零网络、零个人评估,仅输出仓库级聚合数据,不做任何个人评判、排名或绩效评估。

核心能力

核心功能执行

用input_params参数进行配置。

输出: 返回核心功能执行的执行结果,包含操作状态和输出数据。
- 执行此能力时使用input_params参数,支持创建/查询/导出操作

参数配置与调用

用config_options参数进行配置。

输出: 返回参数配置与调用的执行结果,包含操作状态和输出数据。
- 执行此能力时使用config_options参数,支持修改/重置/导入操作

结果处理与输出

用output_format参数进行配置。

输出: 返回结果处理与输出的执行结果,包含操作状态和输出数据。
- 执行此能力时使用output_format参数,支持导出/保存/转换操作
能力覆盖范围：本skill的核心能力覆盖以下场景关键词：面向个人开发者的、仓库协作模式分析、零依赖、隐私优先、输出仓库级聚合报、仓库协作分析工具、免费版为个人开发、者提供、仓库级别的协作模、式分析能力、基于只读、仓库级提交节奏分、天分布、仓库级代码流失率、与重做信号、仓库级约定式提交、合规率、文件级巴士因子风、险提示等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。

使用场景

场景 1:分析个人项目的提交节奏

分析一下 /path/to/my-project 这个仓库的协作模式

工具会:
1. 校验仓库路径(绝对路径,无危险字符)
2. 用只读 git 命令收集聚合数据
3. 输出仓库级协作模式报告

报告包含:
- 仓库整体提交频率(小时/天分布)
- 仓库整体代码增长与流失率
- 仓库级约定式提交合规率
- 文件级巴士因子风险提示(如有)

场景 2:分析指定时间段的提交模式

从 2024-01-01 开始,分析 main 分支的提交节奏分布

# 仓库级小时分布
git -C /path/to/my-project log --pretty=format:"%aI" \
  --since=2024-01-01 main \
  | cut -c12-13 | sort | uniq -c | sort -rn

# 仓库级星期分布
git -C /path/to/my-project log --pretty=format:"%ad" \
  --date=format:"%u" --since=2024-01-01 main \
  | sort | uniq -c | sort -rn

场景 3:检查巴士因子风险

看看这个仓库有没有巴士因子风险

# 文件级作者数统计(仅披露风险文件)
git -C /path/to/my-project log --pretty=format:"%an" --name-only \
  | sort | uniq -c | sort -rn | head -30

工具会列出"仅有单一历史作者"的文件,提示知识转移需求。报告中的贡献者姓名仅出现在此处的风险披露,不与任何评估性指标关联。

快速开始

领先步:确认分析意图与权限

工具会确认:
1. 你明确要分析某个具体的 Git 仓库
2. 你提供了具体的仓库路径(绝对路径)
3. 你确认有权分析该仓库
4. 你知晓报告不用于个人评估

第二步:Dry-Run 预览(推荐首次使用)

先列出要执行的命令,不要运行

工具会打印所有将执行的只读 git 命令,供你审查。

第三步:执行分析

分析 /path/to/my-project

工具执行只读命令,输出仓库级协作模式报告。

示例

参数说明

命令白名单(安全契约)

仅允许以下只读 git 子命令:

优选实践

1. 首次使用先 Dry-Run:让工具列出将执行的命令,审查后再实际运行。
2. 只用绝对路径:相对路径可能导致意外访问其他目录。
3. 限制日期范围:大型仓库用 since/until 限制范围,控制命令耗时。
4. 不用于个人评估:报告仅描述仓库级工作流模式,不可用于绩效、排名或人事决策。
5. 知晓边界:报告仅反映 Git 可见的活动,不反映代码审查、设计、文档、指导等非提交工作。
6. 敏感数据本地处理:提交消息与文件路径属于本地数据,仅聚合数值进入分析。
7. 邮箱不收集:所有 git 命令仅使用 %an(作者名),永不使用 %ae(邮箱)。
8. 路径限制工作区:仅访问用户提供的仓库路径,不遍历父目录,不访问工作区外文件。

常见问题

Q1: 工具会收集开发者邮箱吗?

不会。所有 git 命令仅使用 %an(作者名),永不使用 %ae(邮箱)。git shortlog 使用 -sn 而非 -sne,避免泄露邮箱。

Q2: 工具能对个人进行绩效评估吗?

不能,也不允许。工具仅输出仓库级聚合指标,不做个人拆分、排名或评估。任何要求个人评估的请求都会被拒绝。

Q3: 工具会修改仓库吗?

不会。工具仅使用只读 git 子命令(白名单内),无写入、无网络、无仓库外访问。

Q4: 工具如何保护敏感数据?

提交消息与文件路径属于本地数据,仅通过本地 Unix 工具(awk/grep/wc)折叠为聚合数值后才能进入分析。原始文本永不进入 AI 模型的提示词。常见密钥模式(API Key、Token、私钥、连接串)在显示前自动替换为 [REDACTED]。

Q5: Windows 上能用吗?

可以。Windows 用户需使用 Git Bash 或 WSL,因为工具依赖 cut、sort、awk、grep 等 Unix 文本工具。这些工具在 Git Bash 与 WSL 中默认可用。

Q6: 免费版与 Pro 版的区别?

免费版聚焦个人仓库的聚合分析;Pro 版扩展团队场景、多仓库批量分析、自定义指标、CI 集成与企业级报告能力。

依赖说明

运行环境

• Agent 平台:支持 SKILL.md 的任意 AI Agent(Claude Code / Cursor / Codex / Gemini CLI 等)
• 操作系统:Windows(需 Git Bash 或 WSL)/ macOS / Linux
• Git:任意现代版本(2.0+)

依赖详情

API Key 配置

• 本 Skill 完全基于本地 git 命令,无需额外 API Key
• 不涉及任何网络请求,所有数据本地处理

可用性分类

• 分类: MD+execute(纯 Markdown 指令,部分功能需要 exec 命令行执行能力)
• 说明: 基于自然语言指令驱动 Agent 执行只读 git 命令并输出仓库级聚合报告;所有命令在本地执行,无网络、无写入、无仓库外访问

错误处理

已知限制

• 需LLM支持,无LLM环境不可用
• 复杂业务场景建议结合人工经验判断
• 执行效率受模型能力与网络环境影响
• 当前为免费版本,如需完整功能请升级到付费版获取全部能力

安全注意事项

使用前请确认已阅读依赖说明章节，确保运行环境满足安全要求。