GitGuard — 面向 AI Agent 的仓库智能分析工具

赋予 Agent 审计、评分与分类管理您自有 Git 仓库的能力：检测泄露的密钥、评估分支健康度、分析提交质量、识别过期依赖项，以及梳理 GitHub PR/Issue 积压问题——全部基于本地 Git 数据，辅以可选的公开 GitHub API 读取能力。

🔒 范围与安全说明 — GitGuard 仅读取您指定仓库中已存在于本地磁盘上的文件及 Git 元数据。密钥扫描结果始终以脱敏预览形式返回（仅显示首尾各 4 个字符）；原始密钥值绝不会被存储、记录或传输。本技能所发起的唯一网络请求为只读查询：面向公开 npm/PyPI 仓库（用于判断依赖新鲜度）和 GitHub REST API（用于 PR/Issue 分类管理，需可选 Token）——您的代码内容或密钥信息永远不会发送至任何外部服务。

本技能功能说明

• 密钥扫描 — 结合香农熵分析与已知凭证模式（如 AWS 密钥、GitHub Token、私钥头标识、Stripe/Slack 密钥，以及通用 key=/secret= 赋值语句），在推送前及时发现意外暴露的凭证。
• 综合健康分 — 输出一个 0–100 分的单一评分（对应 A–F 等级），融合密钥安全性、提交规范性、分支健康度、依赖新鲜度与近期活跃度等维度，助您快速识别最需优先关注的仓库。
• 提交质量分析 — 检查是否符合 Conventional Commits 规范、提交主题长度、是否使用祈使语气、以及提交正文是否存在，并为每次提交独立打分。
• 陈旧分支检测 — 标记已合并但未删除的分支、长期无人维护的分支，以及与 main 分支严重偏离的分支，并为每个分支提供“保留 / 审查 / 删除 / 合并”的建议操作。
• 依赖新鲜度检查 — 对比 package.json 和 requirements.txt 中声明的依赖版本与实时 npm/PyPI 仓库中的最新可用版本。
• GitHub PR/Issue 分类管理 — 通过 GitHub API 获取当前打开的 PR 与 Issue，并标记其中已停滞（stale）的条目。

适用场景

当用户需要审计一个或多个自有 Git 仓库时使用本技能：例如在推送前检查是否误提交了密钥、跨多个项目概览仓库整体健康状况、清理陈旧分支，或梳理 GitHub 上积压的 PR/Issue。这是一个以防御为目标、以本地运行为优先的自有代码维护工具——它并非用于扫描或侦察第三方目标的工具。

接入端点

MCP Server：https://github.com/welove111/gitguard-skill/.netlify/functions/mcp

发送 POST 请求，JSON 请求体示例：{"tool": "health_report", "repo_path": "."}。

可用工具列表

运行要求

• Python 3.9+
• 系统 PATH 中已配置 git CLI 命令
• requests 库（可选 — 仅在执行依赖检查或 GitHub 查询时需要；密钥扫描、提交与分支分析完全离线运行，无需该库）
• GITHUB_TOKEN 环境变量（可选 — 可将 GitHub API 调用限额从每小时 60 次提升至 5000 次；访问公开仓库时非必需）

支持方式

GitGuard 是一款免费开源项目。若您曾借助它节省时间，或成功捕获了关键问题，欢迎以自愿方式支持本项目：

• 官网：https://btc-vision.org
• 比特币（BTC）：bc1qtpuhwl0vnhrch5p7e5469q2ed66hlyyvh8rtsn
• 以太坊（ETH）：0xf03b429d4d85896a46dd7a64b5a8ab9f0bbb4ced
• Solana（SOL）：3G5UZHFYN8hbv3aTZt6Lr7qqx4FTTkAyLJq34HjQLraz
• 闪电网络（Lightning）：welove@blink.sv

相关链接

• GitHub 仓库：https://github.com/welove111/gitguard-skill
• 项目官网：https://btc-vision.org