何时使用

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

适用场景：

• - ✅ OpenClaw 技能（原生支持）
• ✅ Windows/Linux/macOS 跨平台
• ✅ 需要批量处理 PR
• ✅ 复杂 JSON 处理
• ✅ 需要结构化错误处理

不适用场景：

• - ❌ 无 PowerShell 环境
• ❌ 仅需简单单次 API 调用

快速参考

主题	文件
快速入门	README.md
命令参考

commands.md | | API 参考 | API-REFERENCE.md | | 更新日志 | CHANGELOG.md |

📦 安装说明

ClawHub 限制：由于 ClawHub 平台限制，PowerShell 脚本文件 (.ps1) 会被重命名为 .ps1.txt 发布。

安装步骤

1. 1. 从 ClawHub 安装技能（自动完成）

1. 2. 恢复脚本文件扩展名：

powershell

进入技能目录

cd ~/.openclaw/workspace/skills/atomgit-ps

恢复 scripts 目录中的 .ps1 扩展名

Rename-Item -Path scripts/*.ps1.txt -NewName { $_.Name -replace \.ps1\.txt$, .ps1 }

验证

Get-ChildItem scripts/*.ps1

1. 3. 验证安装：

powershell

加载技能

. ~/.openclaw/workspace/skills/atomgit-ps/scripts/atomgit.ps1

查看帮助

AtomGit-Help

文件说明

文件	说明
scripts/atomgit.ps1.txt	主执行脚本（需恢复为 .ps1）
scripts/atomgit-batch.ps1.txt

批量处理脚本（需恢复为 .ps1） |

核心命令

命令	说明	示例
AtomGit-Login	登录认证	AtomGit-Login token
AtomGit-GetPRList

获取 PR 列表 | AtomGit-GetPRList -Owner o -Repo r | | AtomGit-ApprovePR | 批准 PR | AtomGit-ApprovePR -Owner o -Repo r -PR 123 | | AtomGit-MergePR | 合并 PR | AtomGit-MergePR -Owner o -Repo r -PR 123 | | AtomGit-GetIssues | 获取 Issues | AtomGit-GetIssues -Owner o -Repo r |

完整命令列表：commands.md

特色功能

1. 批量并行处理

powershell

并行处理多个 PR，性能提升 80%

. ~/.openclaw/workspace/skills/atomgit-powershell/scripts/atomgit-batch.ps1
Invoke-BatchApprove -Owner openeuler -Repo release-management
-PRs @(2557, 2558, 2560)
-Parallel
-MaxConcurrency 3

性能对比：

• - 串行处理 3 个 PR：约 3 分钟
• 并行处理 3 个 PR：约 35 秒
• 提升：81% ⬇️

2. 处理规则

PR 处理判断标准：

• - ✅ 已处理：同时有 /lgtm 和 /approve 两条评论
• ❌ 未处理：缺少任一评论（只有 /lgtm、只有 /approve、或都没有）

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

3. CI 流水线检查（v2.5.0 新增）

powershell

加载脚本

. ~/.openclaw/workspace/skills/atomgit-powershell/scripts/atomgit.ps1

检查 CI 流水线

AtomGit-CheckCI -Owner openeuler -Repo release-management -PR 2560

状态码：

• - 0 - ✅ SUCCESS（全部通过）
• 1 - ⏳ RUNNING（有运行中）
• 2 - ❌ FAILED（有失败）

4. 暂不支持的功能

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

---

💡 使用示例

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

powershell

加载脚本

. ~/.openclaw/workspace/skills/atomgit-powershell/scripts/atomgit.ps1

查询开放 PR

$prs = AtomGit-GetPRList -Owner openeuler -Repo release-management -State open

检查每个 PR 的处理状态

foreach ($pr in $prs) { $comments = AtomGit-GetPRComments -Owner openeuler -Repo release-management -PR $pr.number $myComments = $comments | Where-Object { $_.user.login -eq panchenbo } $hasLgtm = $myComments | Where-Object { $_.body -eq /lgtm } $hasApprove = $myComments | Where-Object { $_.body -eq /approve }

if ($hasLgtm -and $hasApprove) {
Write-Host PR #$($pr.number): ✅ 已处理 -ForegroundColor Green
} elseif ($hasLgtm) {
Write-Host PR #$($pr.number): ⏳ 已 LGTM，待 Approve -ForegroundColor Yellow
} else {
Write-Host PR #$($pr.number): ❌ 未处理 -ForegroundColor Red
}
}

场景 2：批量批准 PR

powershell

加载批量脚本

. ~/.openclaw/workspace/skills/atomgit-powershell/scripts/atomgit-batch.ps1

并行批量批准（推荐）

Invoke-BatchApprove -Owner openeuler -Repo release-management -PRs @(2547, 2564, 2565) -Parallel -MaxConcurrency 3

场景 3：检查 CI 状态

powershell

检查 CI 流水线

AtomGit-CheckCI -Owner openeuler -Repo release-management -PR 2564

输出示例：

=== AtomGit CI Check ===

Total: 10

Success: 9

Failure: 1

Overall: FAILED

场景 4：创建 PR

powershell

创建 PR

AtomGit-CreatePR -Owner openeuler -Repo release-management
-Title 添加新包
-Head feature/new-package
-Base main
-Body 这个 PR 添加了新的软件包

场景 5：协作管理

powershell

获取协作者列表

AtomGit-GetCollaborators -Owner openeuler -Repo release-management

添加协作者

AtomGit-AddCollaborator -Owner openeuler -Repo release-management -Username newuser -Permission push

移除协作者

AtomGit-RemoveCollaborator -Owner openeuler -Repo release-management -Username olduser

场景 6：Issues 管理

powershell

获取 Issues 列表

AtomGit-GetIssues -Owner openeuler -Repo release-management -State open

创建 Issue

AtomGit-CreateIssue -Owner openeuler -Repo release-management -Title 发现 bug -Body 详细描述...

添加评论

AtomGit-AddIssueComment -Owner openeuler -Repo release-management -Issue 123 -Comment 这个问题已经修复

场景 7：仓库查询

powershell

获取我的仓库

AtomGit-GetRepos

获取仓库详情

AtomGit-GetRepoDetail -Owner openeuler -Repo release-management

获取文件树

AtomGit-GetRepoTree -Owner openeuler -Repo release-management

获取文件内容

AtomGit-GetRepoFile