gitcode-pr-audit
Quality audit for merged GitCode PRs: sample by time range or repo list, check compliance (labels, comments, tests, size, etc.), output table. Use when user asks to 抽检/质量检查 已合入的 PR 规范性、多仓库 PR、或 将结果整理成表格. Multi-repo (owner/repo). Python 3.7+ stdlib only.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/autoxj/gitcode-pr-auditGitCode 合入 PR 质量抽检
对指定时间范围内合入主分支的 PR 进行抽检,按多维度判断质量并输出表格。支持多仓库、可配置阈值与必选标签,输出可写为 Markdown 或 CSV。
何时使用
- 用户表达以下任一意图时使用本 skill:
- 规范性抽检/质量抽检:如「对已合入的 PR 进行质量抽检」「最近 30 天合入的 PR 抽检」「已合入 PR 规范性检查」;
- 多仓库/仓库列表:如「对以下仓库的 PR 抽检」「对owner组织下某几个仓库的 PR 检查」;
- 输出形式:如「将抽检结果整理成表格」「输出表格形式」。
- 需提供 至少一个仓库(格式
owner/repo);可多仓库、可选时间(默认最近 30 天)与分支、可选抽检数量或「全部」检查。
认证
GITCODE_TOKEN:按以下优先级读取。
| 优先级 | 来源 |
|---|---|
| 1 | 进程环境变量 GITCODE_TOKEN |
| 2 | Windows 用户级环境变量 |
| 3 | Windows 系统级环境变量 |
- Linux/macOS:在
~/.bashrc或~/.zshrc中export GITCODE_TOKEN="..."。 - 未配置时:脚本报错并提示到 GitCode 个人访问令牌 创建并设置环境变量。
路径与跨平台
- 技能根目录(
SKILL_ROOT):本 SKILL.md 所在目录。脚本通过__file__定位,不依赖当前工作目录。 - 支持 Linux / macOS / Windows;执行时使用脚本绝对路径(如
python <SKILL_ROOT>/scripts/pr_audit.py ...)。
固化流程
- 解析参数:从用户输入提取
--repo(可多个)、--pr(可多个)、--branch、--since、--until、--days、--all、--output等。 - 调用脚本:
python <SKILL_ROOT>/scripts/pr_audit.py --repo owner/repo [--pr N] [--pr N2 ...] [--branch BRANCH] [--since YYYY-MM-DD] [--until YYYY-MM-DD] [--days N] [--all] [--output path.md|path.csv]- 指定 PR 时:使用
--pr N(可多次)并且仅指定一个--repo,脚本只检查这些 PR,不按时间范围拉取。 - 未指定
--pr时:未指定时间则默认 最近 30 天(--days 30);指定--since/--until则按用户时间。 - 未指定分支时,每个仓库依次尝试 master → develop → main,都不存在则报错;指定则用指定分支,不存在则报错。
- 未指定抽检数量时,每个仓库随机抽 5~10 条分析,不足 5 条则全部分析;用户明确「全部」或「所有」或传
--all时,该时间范围内合入的 PR 全部检查。
- 指定 PR 时:使用
- 读取结果:脚本将表格输出到 stdout(Markdown 格式);若指定
--output则同时写入该文件(.md 或 .csv)。退出码非 0 或 stderr 有错误时,向用户展示错误并结束。 - 成功:将 stdout 表格呈现给用户;若写入了文件,说明路径。
脚本参数
| 参数 | 必填 | 说明 |
|---|---|---|
--repo | 是(可多次) | 仓库,格式 owner/repo,可多次传入多仓库 |
--pr | 否(可多次) | 指定 PR 编号;与时间范围二选一,使用时常需且仅需一个 --repo |
--branch | 否 | 目标分支;未传时自动尝试 master → develop → main |
--since | 否 | 起始日期 YYYY-MM-DD(含该日 00:00 上海时间) |
--until | 否 | 结束日期 YYYY-MM-DD(含该日 24:00 前) |
--days | 否 | 最近 N 天(默认 30);与 since/until 二选一,未指定 since/until 时生效 |
--all | 否 | 不抽样,该时间范围内合入的 PR 全部检查 |
--output | 否 | 输出文件路径,扩展名 .md 或 .csv,UTF-8(CSV 带 BOM) |
--config | 否 | 配置文件路径,未传则使用技能根目录下 config.json |
- 指定 PR:传
--pr N(可多个)时仅检查这些 PR,需且仅需一个--repo,不按时间筛选。 - 时间约定:仅用
--days、或仅用--since/--until。若同时传,脚本按--since/--until优先。 - 多仓库时:每个仓库各自按上述规则抽样或全部检查(方案 A)。
分析维度(8 项)
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-autoxj-gitcode-pr-audit": {
"enabled": true,
"auto_update": true
}
}
}Related Skills
deepwiki-ask
通过 DeepWiki MCP 查询仓库信息。支持提问、获取结构、获取文档内容。Query a repository via DeepWiki MCP: ask questions, get structure, get documentation. 用户提供 owner/repo 时触发。
gitcode-release-notes
Generate release notes for GitCode repositories from commits (by tag range or since-date), grouped as feat/fix/docs/other, output Markdown for Release pages. 按 tag 区间或日期拉取提交并生成版本发布公告 Markdown。Python 3.7+ standard library only.
skill-everyday
每天抓取 Clawhub 热门技能,深入分析并生成报告。每次执行获取一个未分析过的热门技能,避免重复。
gitcode
Fetch and query data from GitCode platform via its REST API: repositories, branches, issues, pull requests, commits, tags, users, organizations, search, webhooks, members, releases and more. 查询 GitCode 上的仓库、分支、议题、PR、提交、标签、用户、组织等数据。Python 3.7+ standard library only.
pr-comment-fix
按 GitCode PR 检视意见修改代码。需 GITCODE_TOKEN。Use when 用户要修改 PR 检视意见。