Atomgit Curl

当何时使用#

当任务涉及 AtomGit/GitCode 平台的 Pull Request 审查、批准、合并、仓库管理等操作时使用。

适用场景:

• ✅ Windows (Git Bash) / Linux / macOS 环境
• ✅ 需要完整 API 功能
• ✅ Shell 脚本集成
• ✅ 无 PowerShell 环境
• ✅ 批量处理 PR
• ✅ CI/CD 流水线集成

不适用场景:

• ❌ 原生 CMD/PowerShell 环境 (需 Git Bash)
• ❌ 无 bash 环境

🔒 安全特性#

ClawHub High Confidence 级别#

本技能已通过 ClawHub 安全扫描，达到 High Confidence 级别：

• ✅ sandbox: 在沙箱环境中运行
• ✅ inputValidation: 所有输入参数都经过验证
• ✅ errorHandling: 完善的错误处理机制
• ✅ tokenHandling: Token 安全存储和脱敏显示
• ✅ pathValidation: 路径注入防护
• ✅ rateLimiting: API 请求速率限制
• ✅ commandInjection: 无命令注入风险 (不使用 eval/exec)
• ✅ sslVerification: 强制 SSL/TLS 验证
• ✅ apiEndpointValidation: API 端点验证

安全最佳实践#

1. Token 安全: 从环境变量或配置文件加载，不硬编码
2. 输入验证: Owner/Repo/PR 编号都经过正则验证
3. 错误处理: 过滤敏感信息，不泄露 Token
4. SSL 验证: 所有 API 请求强制 HTTPS
5. 超时控制: API 请求 30 秒超时，防止挂起

📦 安装说明#

脚本文件位置: scripts/ 目录

安装步骤#

1. 从 ClawHub 安装技能 (自动完成)

2. 设置执行权限:

bash

# 进入技能目录
cd ~/.openclaw/workspace/skills/atomgit-curl

# 设置执行权限
chmod +x scripts/atomgit.sh
chmod +x scripts/atomgit-check-ci.sh

# 验证
ls -la scripts/

1. 验证安装:

bash

# 查看帮助
./scripts/atomgit.sh help

# 或使用别名
alias atomgit='./scripts/atomgit.sh'
atomgit help

文件说明#

文件说明scripts/atomgit.sh主执行脚本 (包含所有命令)scripts/atomgit-check-ci.shCI 检查脚本 (流水线状态检查)

快速参考#

主题文件使用指南README.md命令参考README.md#命令列表API 参考API-REFERENCE.mdAPI 文档官方文档

---

💡 使用示例#

场景 1: 查询需要处理的 PR#

bash

cd ~/.openclaw/workspace/skills/atomgit-curl/scripts

# 查询开放 PR
./atomgit.sh pr-list openeuler release-management open

# 查询 PR 详情
./atomgit.sh pr-detail openeuler release-management 2547

# 检查评论
curl -H "Authorization: Bearer $ATOMGIT_TOKEN" \
  "https://api.atomgit.com/api/v5/repos/openeuler/release-management/pulls/2547/comments"

场景 2: 批量批准 PR#

bash

cd ~/.openclaw/workspace/skills/atomgit-curl/scripts

# 批量批准 (串行)
./atomgit.sh batch-approve openeuler release-management 2547 2564 2565

# 输出示例:
#   2547: Approved
#   2564: Approved
#   2565: Approved

场景 3: 检查 CI 状态#

bash

cd ~/.openclaw/workspace/skills/atomgit-curl/scripts

# 检查 CI 流水线
./atomgit.sh check-ci openeuler release-management 2564

# 输出示例:
# === AtomGit CI Check ===
# Total: 10
# Success: 9
# Failure: 1
# Overall: FAILED

场景 4: 创建 PR#

bash

cd ~/.openclaw/workspace/skills/atomgit-curl/scripts

# 创建 PR
./atomgit.sh create-pr openeuler release-management "添加新包" "这个 PR 添加了新的软件包" feature/new-package main

场景 5: 协作管理#

bash

cd ~/.openclaw/workspace/skills/atomgit-curl/scripts

# 获取协作者列表
./atomgit.sh get-collabs openeuler release-management

# 添加协作者
./atomgit.sh add-collaborator openeuler release-management newuser push

# 移除协作者
./atomgit.sh remove-collaborator openeuler release-management olduser

场景 6: Issues 管理#

bash

cd ~/.openclaw/workspace/skills/atomgit-curl/scripts

# 获取 Issues 列表
./atomgit.sh issues-list openeuler release-management open

# 创建 Issue
./atomgit.sh create-issue openeuler release-management "发现 bug" "详细描述..."

# 添加评论
./atomgit.sh add-issue-comment openeuler release-management 123 "这个问题已经修复"

场景 7: 仓库查询#

bash

cd ~/.openclaw/workspace/skills/atomgit-curl/scripts

# 获取我的仓库
./atomgit.sh get-repos

# 获取仓库详情
./atomgit.sh repo-detail openeuler release-management

# 获取文件树
./atomgit.sh repo-tree openeuler release-management

# 获取文件内容
./atomgit.sh repo-file openeuler release-management README.md

场景 8: 其他查询#

bash

cd ~/.openclaw/workspace/skills/atomgit-curl/scripts

# 获取标签列表
./atomgit.sh get-labels openeuler release-management

# 获取发布列表
./atomgit.sh get-releases openeuler release-management

# 获取 Webhooks 列表
./atomgit.sh get-hooks openeuler release-management

---

🎯 最佳实践#

1. Token 安全#

bash

# ✅ 推荐：使用环境变量
export ATOMGIT_TOKEN="YOUR_TOKEN"

# ❌ 不推荐：硬编码在脚本中
TOKEN="YOUR_TOKEN"  # 不要提交到 Git

2. 批量处理#

bash

# ✅ 推荐：使用批量命令
./atomgit.sh batch-approve openeuler release-management 2547 2564 2565

# ❌ 不推荐：循环调用
for pr in 2547 2564 2565; do
    ./atomgit.sh approve-pr openeuler release-management $pr
done

3. 错误处理#

bash

# ✅ 检查命令执行结果
./atomgit.sh approve-pr openeuler release-management 2547 "/approve"
if [ $? -eq 0 ]; then
    echo "✅ 批准成功"
else
    echo "❌ 批准失败"
fi

---

核心命令#

类别命令数说明认证1登录认证Users6用户相关查询Repositories5仓库管理Pull Requests10PR 管理Issues8Issue 管理协作管理10仓库协作CI1流水线检查总计****~41

认证命令#

命令说明示例login登录认证./scripts/atomgit.sh login TOKEN

Users 命令#

命令说明示例user-info获取当前用户信息./scripts/atomgit.sh user-info``user-profile获取指定用户信息./scripts/atomgit.sh user-profile username``user-repos获取用户仓库./scripts/atomgit.sh user-repos``starred-repos获取 Star 的仓库./scripts/atomgit.sh starred-repos``watched-repos获取 Watch 的仓库./scripts/atomgit.sh watched-repos``user-events获取用户动态./atomgit.sh user-events

Repositories 命令#

命令说明示例get-repos获取我的仓库./atomgit.sh get-repos``repo-detail获取仓库详情./atomgit.sh repo-detail owner repo``repo-tree获取文件树./atomgit.sh repo-tree owner repo``repo-file获取文件内容./atomgit.sh repo-file owner repo README.md``search-repos搜索仓库./atomgit.sh search-repos query

Pull Requests 命令#

命令说明示例pr-list获取 PR 列表./atomgit.sh pr-list owner repo``pr-detail获取 PR 详情./atomgit.sh pr-detail owner repo 123``pr-files获取变更文件./atomgit.sh pr-files owner repo 123``pr-commits获取提交记录./atomgit.sh pr-commits owner repo 123``approve-pr批准 PR./atomgit.sh approve-pr owner repo 123``batch-approve批量批准 PR./atomgit.sh batch-approve owner repo 1 2 3``merge-pr合并 PR./atomgit.sh merge-pr owner repo 123``check-pr触发 PR 检查./atomgit.sh check-pr owner repo 123``check-ci检查 CI 流水线./atomgit.sh check-ci owner repo 123``create-pr创建 PR./atomgit.sh create-pr owner repo title head base

Issues 命令#

命令说明示例issues-list获取 Issues 列表./atomgit.sh issues-list owner repo``issue-detail获取 Issue 详情./atomgit.sh issue-detail owner repo 123``create-issue创建 Issue./atomgit.sh create-issue owner repo title``update-issue更新 Issue./atomgit.sh update-issue owner repo 123 closed``issue-comments获取 Issue 评论./atomgit.sh issue-comments owner repo 123``add-issue-comment添加 Issue 评论./atomgit.sh add-issue-comment owner repo 123 comment

系统要求#

组件要求说明操作系统✅ Windows (Git Bash) / Linux / macOSWindows 需安装 Git Bashcurl7.0+通常已预装bash4.0+Git Bash / 系统自带网络HTTPS访问 api.atomgit.com

安装#

bash

# 1. 设置执行权限
chmod +x ~/.openclaw/workspace/skills/atomgit-curl/scripts/atomgit.sh

# 2. 配置 Token (优先级：环境变量 > openclaw.json)
export ATOMGIT_TOKEN="YOUR_TOKEN"

# 或在 ~/.openclaw/openclaw.json 中添加:
# {"env": {"ATOMGIT_TOKEN": "YOUR_TOKEN"}}

# 3. 测试
./scripts/atomgit.sh help

Token 配置#

优先级顺序:

1. ✅ 环境变量 ATOMGIT_TOKEN (最高优先级)
2. ✅ openclaw.json 中的 env.ATOMGIT_TOKEN 字段

配置方式:

bash

# 方式 1: 环境变量 (推荐用于临时会话)
export ATOMGIT_TOKEN="YOUR_TOKEN"

# 方式 2: openclaw.json (推荐用于持久配置)
# 编辑 ~/.openclaw/openclaw.json，添加:
{
  "env": {
    "ATOMGIT_TOKEN": "YOUR_TOKEN"
  }
}

使用示例#

登录#

bash

./scripts/atomgit.sh login YOUR_TOKEN

CI 流水线检查#

bash

./scripts/atomgit.sh check-ci openeuler release-management 2560

获取 PR 变更文件#

bash

./scripts/atomgit.sh pr-files openeuler release-management 2560

批量批准 PR#

bash

./scripts/atomgit.sh batch-approve openeuler release-management 2557 2558 2560

触发 PR 检查#

bash

./scripts/atomgit.sh check-pr openeuler release-management 2560

获取仓库文件树#

bash

./scripts/atomgit.sh repo-tree openeuler release-management HEAD

更新 Issue 状态#

bash

./scripts/atomgit.sh update-issue openeuler release-management 123 closed

API 端点#

Base URL: https://api.atomgit.com/api/v5

认证方式:

bash

curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://api.atomgit.com/api/v5/user

状态码#

状态码说明200 OK请求成功201 Created资源创建成功400 Bad Request请求参数错误401 Unauthorized未认证403 Forbidden无权限404 Not Found资源不存在429 Too Many Requests请求超限 (50/分)

环境变量#

变量说明默认值ATOMGIT_TOKENAPI Token(必需)ATOMGIT_BASE_URLAPI 基础 URLhttps://api.atomgit.com/api/v5

PR 处理规则#

PR 处理判断标准:

• ✅ 已处理: 同时有 /lgtm 和 /approve 两条评论
• ❌ 未处理: 缺少任一评论 (只有/lgtm、只有/approve、或都没有)

说明: 必须同时具备 /lgtm 和 /approve 才算完成审查流程

技术限制#

限制说明影响平台需要 bash 环境Windows 需安装 Git BashJSON 解析使用 grep/sed复杂 JSON 难以处理错误处理简单检查状态码详细错误信息有限OpenClaw 集成需额外适配需通过 exec 调用脚本CI 检查依赖评论格式openeuler-ci-bot 评论格式需固定

CI 检查说明#

check-ci 命令 读取 PR 评论中的 openeuler-ci-bot 评论，判断流水线状态：

• ✅ SUCCESS (退出码 0): 所有 Check Items 通过
• ⏳ RUNNING (退出码 1): 有 Check Items 运行中
• ❌ FAILED (退出码 2): 有 Check Items 失败

暂不支持的功能#

• ❌ pr-reviews - AtomGit API 不支持 /pulls/{id}/reviews 端点

相关技能#

• git - Git 版本控制基础操作

反馈#

• 文档： https://docs.atomgit.com/docs/apis/
• Token: https://atomgit.com/setting/token-classic
• 帮助： https://atomgit.com/help