Watch PR

What it does

When your agent uses it

• Tasks that involve Pull requests

Example prompts

• “/watch-pr”

Requirements

• Pre-approved tools (allowed-tools): Bash(gh pr checks *), Bash(gh pr view *), Bash(gh run view *), Bash(gh api *), Bash(git rev-parse *), Bash(git branch *), Read, Grep, Skill

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

1. 1job 名と link を表示
2. 2gh run view --log-failed で失敗 step のログを fetch (最大 100 行)
3. 3ログを以下の pattern で分類
4. 4分類別に推奨アクションを提示

What it can do on your machine

Read from SKILL.md and the folder at commit 421d066. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves these tools, so the agent can use them without asking each time:

  • Bash(gh pr checks *)
  • Bash(gh pr view *)
  • Bash(gh run view *)
  • Bash(gh api *)
  • Bash(git rev-parse *)
  • Bash(git branch *)
  • Read
  • Grep
  • Skill

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Shell commands in SKILL.md call:

  • gh
  • git
  • cargo
  • dotnet

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  No URLs in SKILL.md. Its commands use gh and git, which can reach the network depending on how they are called.

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Watch PR loads about 2k tokens when it runs. Until then it costs about 123 tokens; SKILL.md has 724 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~123

When it runs · the whole SKILL.md, loaded when a task matches

~2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from ayutaz/piper-plus at commit 421d066, republished under its MIT licence (© ayutaz). 724 words, ~1,994 tokens.

name

watch-pr

description

PR push 直後 / PR 作成後の auto chain (`/create-pr` のフェーズ 6.2 から発動) / CI 監視 / レビュー対応 / merge 前確認 の文脈で発動。`gh pr checks` を一度 polling し green / red / pending を集計、 red なら失敗 job のログを fetch して「format drift / test fail / build error / flake / contract drift」に分類。 同時に unresolved review thread (人間 / Copilot) も集計し、 安全カテゴリ (stale / Copilot style ノイズ) は `/reply-review --auto-safe` を auto chain で起動して reply + resolve まで自動完了。 人間 reviewer / blocker 候補は user 判断のため提示のみ。 `/loop /watch-pr <PR>` で継続監視に使える。

allowed-tools

Bash(gh pr checks *), Bash(gh pr view *), Bash(gh run view *), Bash(gh api *), Bash(git rev-parse *), Bash(git branch *), Read, Grep, Skill

argument-hint

[pr-number]

disable-model-invocation

false

/loop /watch-pr 489       # 5 分間隔で polling、red/green/timeout で通知
/watch-pr                 # 引数省略時は現在ブランチに紐づく PR を自動検出

PR_NUM=$(gh pr view --json number --jq '.number' 2>/dev/null)

gh pr checks "$PR_NUM" --json name,state,conclusion,link --jq '.[]'

## PR #<N> CI Status (<HH:MM:SS>)

| State        | Count |
|--------------|-------|
| ✅ Success   | <n>   |
| ❌ Failure   | <n>   |
| 🔁 Pending   | <n>   |
| ⏭️ Skipped   | <n>   |
| ⚠️ Cancelled | <n>   |

Total: <total> checks

gh api graphql -f query='
query($owner: String!, $name: String!, $number: Int!) {
  repository(owner: $owner, name: $name) {
    pullRequest(number: $number) {
      reviewThreads(first: 50) {
        nodes {
          isResolved
          isOutdated
          comments(first: 1) {
            nodes {
              author { login }
              path
              body
              createdAt
            }
          }
        }
      }
    }
  }
}' -F owner=ayutaz -F name=piper-plus -F number="$PR_NUM" --jq \
'.data.repository.pullRequest.reviewThreads.nodes
 | map(select(.isResolved == false))
 | length, map(select(.isResolved == false))[]'

Skill({skill: "reply-review", args: "<PR_NUM> --auto-safe"})

/loop /watch-pr <PR>

# 現在ブランチの PR を 1 回チェック
/watch-pr

# PR #489 を 1 回チェック
/watch-pr 489

# 5 分間隔で継続監視 (loop skill が pace 決定)
/loop /watch-pr 489

# 固定 5 分間隔
/loop 5m /watch-pr 489

© ayutaz, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/watch-pr of ayutaz/piper-plus.

Open the folder on GitHubat commit 421d066