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 安装技能 (自动完成)

1. 设置执行权限:

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

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

# 验证
ls -la scripts/

1. 验证安装:

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

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

文件说明

快速参考

💡 使用示例

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

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

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 状态

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

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

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

场景 5: 协作管理

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 管理

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: 仓库查询

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: 其他查询

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 安全

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

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

2. 批量处理

# ✅ 推荐：使用批量命令
./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. 错误处理

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

核心命令

认证命令

Users 命令

Repositories 命令

Pull Requests 命令

Issues 命令

系统要求

安装

# 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 字段

配置方式:

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

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

使用示例

登录

./scripts/atomgit.sh login YOUR_TOKEN

CI 流水线检查

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

获取 PR 变更文件

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

批量批准 PR

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

触发 PR 检查

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

获取仓库文件树

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

更新 Issue 状态

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

API 端点

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

认证方式:

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

状态码

环境变量

PR 处理规则

PR 处理判断标准:

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

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

技术限制

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