用途:为在 GitHub Actions 中运行的自动化代理提供 CI 环境操作规则,覆盖安全、CI 监控、评论格式与运行排查。
主要能力与用法:
- 读取上下文:被评论或 issue 触发时,先从提示中的 URL 提取 PR/issue 编号,用 gh pr view、gh pr diff、gh pr checks 或 gh issue view 读取描述、diff 与近期评论后再行动。
- 安全:禁止运行可能泄露密钥的命令(env、printenv、set、export,或对含凭据的配置文件执行 cat/echo),禁止在回复或评论中暴露环境变量、API key、token 或凭据。
- PR 创建与推送:用 gh pr create 直接创建;创建前用 gh pr list 与 git branch -r 检查是否已有同类工作。推送时始终用不带 remote 的 git push,因为 gh pr checkout 已配置正确跟踪;若推送失败(fork PR 禁用编辑),改为在评论中贴代码片段。
- CI 监控:推送后等待 CI 再报告完成。用 run_in_background: true 轮询 gh pr checks <number> --required,每 60 秒一次,最多约 10 分钟,忽略非必需检查。必需检查失败时用 gh run view <run-id> --log-failed 诊断后修复重推。必需检查通过后单独轮询 codecov/patch(最多约 5 分钟),失败时用 cargo llvm-cov report --show-missing-lines 排查。不要用 gh run watch 或 gh pr checks --watch,可能无限挂起。
- 评论回复与格式:行内评论用 gh api .../comments/{id}/replies 在线程内回复,会话评论发普通评论。评论保持简洁,细节放入 <details> 标签;文件、issue、PR 与文档使用 markdown 链接,行引用优先用 permalink。
- Shell 引用:评论正文与 shell 敏感参数始终写入临时文件,用 << 'EOF' 防止展开;gh pr comment 用 -F /tmp/file,gh api 用 -F body=@/tmp/file。
- 排查其他 CI 运行:主要证据是会话日志 artifact,用 gh run download <run-id> -n claude-session-logs 下载,再用 jq 解析 JSONL 中的技能加载、工具调用与推理。
适用场景:在 CI 中自动响应 PR/issue 评论、创建与更新 PR、监控检查状态、回复评审意见、诊断 CI 失败。
限制:CI 运行非交互,每条结论须有证据支撑,不能声称失败为“既有问题”而未核对 main 分支 CI;语气上只提观察,不替作者创建任务清单。具体仓库、分支与命令参数需按实际替换。