Merge Check Paid

提供团队级批量PR合并性预测与全维度分析，支持历史趋势追踪、CI/CD门禁集成及自定义拒绝规则。

Install

openclaw skills install @thcjp/merge-check-paid

核心功能: 本技能提供中文交互、、报表生成、统计洞察、数据可视化时使用等能力。

核心功能: 本技能提供与团队级看板等能力。

合并检查工具(专业版)

专业版专属特性

能力	免费版	付费版
基础功能	支持	支持
合并检查工具(专业版)含全维度分析	不支持	支持
大数据集流式处理	不支持	支持
多数据源关联查询	不支持	支持
可视化图表自动生成	不支持	支持
定时数据同步与增量更新	不支持	支持

能力清单

能力模块	说明	与免费版差异
单PR分析	技术信号+PR卫生+架构契合+评审状态+流程合规+社交元信号	与免费版一致,深度更深
批量分析	一次分析多个PR,输出团队看板	免费版仅单PR
历史趋势	作者/仓库历史合并率与趋势	免费版仅当前快照
CI/CD门禁	流水线集成,PR不达标自动阻断	免费版无
自定义规则	团队专属拒绝向量与阈值	免费版无
周报导出	团队PR健康度周报	免费版无
风险预警	高风险PR实时提醒	免费版无

上手指南

确认运行环境满足依赖说明中的要求
在AI Agent对话中调用本技能,提供必要的输入参数
检查输出结果,根据需要进行后续处理

详细的输入输出格式请参考下方章节说明。

应用场景

场景一:维护者批量评审待合并队列

维护者面对一长串待评审PR,希望按合并概率排序处理.

bash

# 批量分析仓库所有开放PR
bash （请参考skill目录中的脚本文件） owner/repo --state open --limit 20
# ...
# 输出团队看板
bash （请参考skill目录中的脚本文件） owner/repo --format dashboard > pr-dashboard.html

工具输出按合并概率排序的看板:

text

# 请参考上方使用说明进行配置和调用
result = "ready"
```bash
# 初始化团队规则配置
cp config/team-rules.example.json config/team-rules.json

# 编辑团队阈值与规则
vi config/team-rules.json

请参考上方使用说明进行配置和调用

result = "ready"

bash

bash （请参考skill目录中的脚本文件） owner/repo#123 --full-dimensions

请参考上方使用说明进行配置和调用

result = "ready"

bash

# 分析所有开放PR
bash （请参考skill目录中的脚本文件） owner/repo --state open

# 按标签筛选
bash （请参考skill目录中的脚本文件） owner/repo --label "needs-review"

# 按作者筛选
bash （请参考skill目录中的脚本文件） owner/repo --author "alice"

# 生成HTML看板
bash （请参考skill目录中的脚本文件） owner/repo --format dashboard --output pr-board.html

请参考上方使用说明进行配置和调用

result = "ready"

bash

# 导出仓库近6个月合并趋势
bash （请参考skill目录中的脚本文件） owner/repo --months 6 --format csv > trend.csv

# 生成趋势图
bash （请参考skill目录中的脚本文件） owner/repo --months 6 --format chart > trend.html

...

输入参数

...

参数名	类型	必填	说明
content	string	否	merge-check处理的内容输入
strict_level	string	否	审查严格度, 可选: strict/normal/loose, 默认: normal

...

输出说明

...

json

{
  "success": true,
  "data": {
    "overall_grade": "A",
    "total_score": 92,
    "max_score": 100,
    "summary": "处理完成",
    "details": [
      {
        "item": "代码风格",
        "status": "pass",
        "score": 95,
        "comment": "符合规范"
      },
      {
        "item": "安全合规",
        "status": "warn",
        "score": 80,
        "comment": "符合规范"
      }
    ],
    "improvements": [
      {
        "priority": "high",
        "suggestion": "建议优化",
        "expected_gain": "+5分"
      },
      {
        "priority": "medium",
        "suggestion": "建议优化",
        "expected_gain": "+3分"
      }
    ]
  },
  "error": null
}

...

异常应对

...

错误场景	原因	处理方式
配置错误	参数缺失或格式错误	检查依赖说明中的配置要求
运行时错误	运行环境不满足	确认运行环境符合依赖说明
网络错误	连接超时或不可达

...

依赖与配置

...

运行环境

...

Agent平台: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
操作系统: Windows / macOS / Linux
gh CLI版本: 建议 2.40 及以上
Python版本: 建议 3.10 及以上(用于报告生成与趋势图)

...

依赖说明(补充)

...

依赖项	类型	是否必需	获取方式
LLM API	API	必需	由Agent内置LLM提供
gh CLI	命令行工具	必需	相关技术文档下载
jq	JSON处理	必需	系统包管理器安装
Python	运行时	推荐	python.org 下载
matplotlib	Python包	可选	`pip install matplotlib`(趋势图)
GITHUB_TOKEN	凭据	必需	仓库Settings → Secrets

...

API Key 配置

...

本Skill基于指令驱动,无需额外API Key.
gh CLI 通过 gh auth login 或环境变量 GITHUB_TOKEN 认证.
CI/CD门禁需在仓库Secrets配置 GITHUB_TOKEN(自动提供)或 PAT(私有仓库批量分析).
通知渠道(Slack/飞书)的 webhook URL 需配置为仓库Secret.

...

可用性分类

...

分类: MD+execute()
说明: 基于Markdown的AI Skill,。PRO版面向团队与维护者,提供批量分析、历史趋势、CI/CD门禁与自定义规则能力,完全兼容免费版单PR分析.

...

案例展示

...

团队规则配置

...

json

{
  "thresholds": {
    "min_merge_score": 50,
    "max_changed_lines": 1000,
    "max_changed_files": 15,
    "max_open_days": 14
  },
  "blockers": [
    { "id": "ci_failing", "weight": -30, "description": "CI检查未通过" },
    { "id": "changes_requested", "weight": -25, "description": "存在未处理的修改意见" },
    { "id": "no_linked_issue", "weight": -10, "description": "未关联issue" },
    { "id": "draft_state", "weight": -100, "description": "草稿状态" }
  ],
  "boosters": [
    { "id": "all_ci_green", "weight": 20, "description": "所有CI通过" },
    { "id": "has_approvals", "weight": 15, "description": "已获得批准" },
    { "id": "single_concern", "weight": 10, "description": "单一职责" }
  ],
  "custom_vectors": [
    {
      "id": "no_tests",
      "check": "files_changed_without_tests",
      "weight": -15,
      "description": "逻辑变更但未更新测试"
    }
  ]
}

...

CI/CD门禁阈值分级

...

阈值	评分范围	流水线动作
通过	≥70	允许合并,标记
警告	50-69	允许合并,提醒评审
阻断	30-49	阻断合并,要求处理
严重	<30	阻断并通知维护者

...

问题汇编

...

Q1:PRO版与免费版如何共存?

...

两者单PR分析与报告格式完全兼容,PRO版包含免费版全部能力。维护者升级时直接替换Skill文件,已有脚本无需改造.

...

Q2:批量分析会触发限流吗?

...

会。工具默认遵守 GitHub API 限流,建议为团队配置 GITHUB_TOKEN 提升配额(5000 req/h)。批量分析超过50个PR时建议分批并加间隔.

...

Q3:自定义规则如何与团队规则共存?

...

自定义向量在团队规则基础上叠加计算。每个向量返回 triggered 与 weight,最终评分 = 基础分 + Σ(向量权重)。阻断器触发会直接拉低评分.

...

Q4:门禁误判怎么办?

...

提供 --bypass 标记供维护者手动放行,但会在看板标注"人工放行"并记录原因,便于审计。建议定期复盘误判案例以调优阈值.

...

Q5:支持私有仓库吗?

...

支持。需要为CI运行环境配置具有仓库读取权限的 GITHUB_TOKEN 或 PAT。批量分析私有仓库时,所有数据处理在本地完成,不上传外部服务.

...

Q6:能否对接Slack/飞书等通知渠道?

...

可以。门禁工作流可集成任意通知渠道,工具输出标准JSON,便于二次开发对接 webhook。常见做法是高风险PR触发IM通知,低风险PR仅记录看板.

...

差异化分析

效率提升量化分析

操作步骤	手动耗时	自动化耗时	时间节约	准确率提升
单PR深度分析	15分钟/PR	2分钟/PR	13分钟/PR	10%
批量PR分析	1小时/100 PR	10分钟/100 PR	50分钟/100 PR	15%
历史趋势追踪	1小时/仓库	5分钟/仓库	55分钟/仓库	12%
CI/CD门禁集成	2小时	30分钟	1.5小时	5%
自定义规则配置	1天	2小时	18小时	8%

差异化对比

对比维度	本技能	手动操作	Python脚本	专业软件
分析维度	6维度	3维度	3维度	5维度
批量处理能力	1000+ PR/小时	10 PR/小时	50 PR/小时	1000 PR/小时
集成方式	CI/CD	无	可选	必需
定制化程度	高	低	中	高
成本	低	高	中	高

核心痛点解决

痛点	描述	影响范围	解决方案	量化效果
PR质量低	PR合并失败率高，导致项目延期	项目进度	提供深度分析，优化代码质量	合并失败率降低20%
评审效率低	维护者工作量大，评审效率低	团队效率	批量分析，快速识别问题PR	评审效率提升50%
历史趋势不可视化	历史数据难以分析，无法预测未来趋势	项目管理	提供历史趋势追踪，辅助决策	项目预测准确率提升10%

排障手册

错误现象	可能原因	诊断步骤	解决方案
无法连接到CI/CD系统	网络连接问题或CI/CD系统配置错误	检查网络连接，验证CI/CD系统配置	修复网络问题或配置CI/CD系统
批量分析结果错误	输入数据错误或分析算法问题	检查输入数据，验证分析算法	修正输入数据或优化分析算法
自定义规则配置失败	规则格式错误或权限问题	验证规则格式，检查权限	修正规则格式或提升权限
历史趋势数据缺失	数据源问题或数据同步失败	检查数据源，确保数据同步成功	修复数据源或恢复数据同步
风险预警未触发	风险阈值设置过低或规则错误	检查风险阈值设置，验证规则	调整风险阈值或修正规则

安全须知事项

确保所有数据传输都通过安全的通道进行。
对敏感数据进行加密存储和传输。
定期更新系统，以修复已知的安全漏洞。
限制对合并检查工具(专业版)的访问权限，仅授权给团队成员。
监控工具的日志，以便及时发现异常行为。

安全风险防范

风险项	等级	防护措施	验证方法
API密钥泄露	高	通过环境变量配置，禁止硬编码	定期检查代码和配置文件
命令执行风险	高	仅执行白名单命令，避免拼接用户输入	使用沙箱环境测试
网络通信安全	中	使用HTTPS协议，验证SSL证书	定期检查证书有效期
敏感数据暴露	高	输出结果中不包含密钥、令牌等敏感信息	日志脱敏审查
未授权访问	中	限制访问权限，实施认证机制	定期审计访问日志

功能特征

自动化执行: 批量PR合并性预测,含全维度分析、历史趋势、CI/CD门禁与自定义规则。合并检查工具(专业版)面向团队与维护者,提供批量
文件处理: 支持多种文件格式的读取、解析和写入操作
API集成: 通过标准化接口调用外部服务并处理响应
命令执行: 在安全沙箱中执行系统命令并收集结果
信息检索: 快速搜索和过滤目标数据

问题解答集

Q1: 合并检查工具(专业版)支持哪些输入格式？

A1: 批量PR合并性预测,含全维度分析、历史趋势、CI/CD门禁与自定义规则。合并检查工具(专业版)面向团队与维护者,提供批量PR合并性预测、全维度深度分析、历史趋势。支持文本指令和结构化参数输入，具体格式参考使用流程章节。

Q2: 需要配置API Key吗？

A2: 是的，部分功能需要配置对应平台的API Key。请在依赖说明章节查看具体要求，并通过环境变量安全配置。

Q3: 命令行执行失败怎么办？

A3: 检查命令参数是否正确，确认运行环境支持exec能力。如遇权限问题，请参照错误处理章节排查。

故障处理方案

针对合并检查工具(专业版)使用中可能遇到的常见问题,提供以下排查方案:

错误类型	原因分析	解决方案
API认证失败(401)	API密钥错误或过期	检查密钥配置,重新生成token
接口限流(429)	请求频率超出限制	降低调用频率,启用重试退避策略
响应超时(504)	网络延迟或服务端负载过高	增加超时阈值,检查网络连接
文件不存在	路径错误或文件未创建	检查路径拼写,确认文件已生成
文件格式不支持	扩展名不在支持列表中	转换为支持的格式后重试
权限不足	当前用户无读写权限	检查文件权限,以管理员身份运行
命令执行失败	参数错误或环境依赖缺失	检查命令语法,确认依赖已安装
进程超时	命令执行时间过长	增加超时设置,优化命令参数
网络连接失败	DNS解析失败或防火墙拦截	检查网络配置,确认代理设置

合并检查工具(专业版)通用排查步骤

检查输入参数: 确认所有必填参数已提供且格式正确
查看日志输出: 定位具体错误行和异常类型
验证环境配置: 确认依赖库版本和运行环境满足要求
逐步调试: 缩小问题范围,隔离故障模块