comet-github-ci-triage について
comet-github-ci-triage は、現在の head の状態とジョブログを基に GitHub のプルリクエストチェックを診断する Comet スキルです。既定では修正を行わず、証拠、根本原因、最小限の次の対応を報告します。
主な機能
- 01PR チェックと現在の head SHA の照合
- 02失敗したジョブログの調査
- 03コード、テスト、環境、設定の失敗分類
- 04必要に応じたカバレッジメタデータの確認
- 05リモート状態とローカルチェックの区別
活用シーン
- 01プルリクエストチェックの失敗原因の特定
- 02古いチェックやマージ競合の判別
- 03カバレッジ失敗と影響ファイルの評価
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ rpamis/ comet --skill comet-github-ci-triageインストール後、Claude Code で/comet-github-ci-triageを入力して読み込まれたか確認します。
同梱ファイルagents/openai.yaml
詳細
プロジェクトの README よりComet GitHub CI 分诊
先读取 ../comet-github/references/maintainer-contract.md。默认只做诊断;只有用户要求时才实施修复。
检查准确的远端状态
- 解析 PR,记录当前 head SHA 和目标分支。
- 运行
gh pr checks <pr> --json name,state,bucket,link,workflow,startedAt,completedAt。 - 对失败 job 使用
gh run view <run-id> --log-failed或最小范围的 job 日志检查真实失败边界。不要在没有日志证据时相信聚合助手摘要。 - 检查可合并状态,并确认显示的检查属于当前 head。过期 run 不能证明当前代码有问题。
- Codecov 页面信息不完整时,通过可用 API 检查受影响文件和 patch coverage 元数据,并报告准确 head 和覆盖率范围。
分类失败原因
判断红色结果属于:
- 生产代码;
- 测试 fixture 或冻结契约投影;
- 生成 Runtime 漂移或构建输出不确定;
- 依赖、工具链或平台环境;
- 凭证、权限或 Runner 配置;
- 过期检查或合并冲突;
- 未解决的覆盖率阈值。
用户要求实施时,在本地复现最小决定性边界。Windows 环境需要先区分沙箱、凭证或占位可执行文件噪音与真实 CI 失败,再修改产品代码。
准确报告状态
返回当前 head SHA、失败 job、根因、证据和最小动作。把远端状态与本地检查分开报告。超时、缺失、过期或尚未启动的检查都标记为“未验证”。
在准确最终 head 的新检查成功前,绝不宣称 CI 全绿。如果需要修复,将已确认范围交给 comet-github-issue-fix,获得授权后再使用 comet-safe-delivery。
コメント
Markdown 対応