actions-mention-to-slack: Skill for Claude Code

resolve-pr-threads skill

過去のレビュースレッドのうち修正済みのものを resolve する skill。 誤判定で未対応の指摘を畳むと見落としに直結するため、判定に迷う場合は常に「resolve しない」を選ぶこと。

入力

• OWNER / REPO / PR_NUMBER: 対象 PR
• THREAD_RESOLVE_SCOPE: resolve 範囲
  • all (デフォルト): すべての未 resolve スレッドを対象に、author 種別 (本レビュアー Bot / 他 Bot レビュアー / 人間レビュアー) を問わず resolve 候補にする。
  • own: 本アクション自身 (claude-code-action が用いる Bot) が author のスレッドのみ resolve 候補にする。判定は自身の過去コメントの author.login と一致するか否かで行う。判定が困難な場合は resolve しない。
  • none: 過去スレッドの resolve は一切行わない。本 skill 全体を skip する。
• SELF_LOGIN (任意): THREAD_RESOLVE_SCOPE=own 時に「自身」を判定するための author.login。caller が判明していれば渡す。未指定の場合は次の優先順で推定する:
  1. 直近の review / comment から *[bot] author で実行中アクションと一致するもの。
  2. それで決まらなければ、PR 内で *[bot] 投稿件数最多の author。複数 Bot 同居時は別 Bot (github-copilot[bot] 等) との取り違えに注意。
  3. 一意に決まらなければ scope=own をまるごと skip し、Step 5 で「SELF_LOGIN 推定不能」と報告する。

共通の resolve 判定ルール

• 既に isResolved: true のスレッドは触らない。
• resolve するのは 指摘内容どおりの修正が現在の差分・ファイル内容から確認できる場合のみ。
• 以下のいずれかに該当する場合は resolve しない:
  • 指摘箇所が削除されただけで、別の場所に同じ問題が残っている可能性がある。
  • isOutdated: true だが、修正されたか単に行がずれただけかが判別できない。
  • 指摘が複数論点を含み、一部しか対応されていない。
  • そもそも修正されたかどうか判断に迷う。

手順

Step 0. THREAD_RESOLVE_SCOPE のチェック

THREAD_RESOLVE_SCOPE=none の場合は何もせず終了する。

Step 1. レビュースレッド一覧を取得する

id (Step 4 の resolveReviewThread mutation で必須) / isResolved / isOutdated / 各コメントの author.login / path / line / body を GraphQL で取得し、未 resolve スレッドすべてを判定対象とする。

reviewThreads(first: 100) は GitHub GraphQL API の 1 ページあたりの上限値。100 件を超える可能性がある場合はページネーションする。

gh api graphql \
  -F owner=<OWNER> \
  -F name=<REPO> \
  -F number=<PR_NUMBER> \
  -f query='
    query($owner: String!, $name: String!, $number: Int!, $after: String) {
      repository(owner: $owner, name: $name) {
        pullRequest(number: $number) {
          reviewThreads(first: 100, after: $after) {
            pageInfo { hasNextPage endCursor }
            nodes {
              id
              isResolved
              isOutdated
              comments(first: 100) {
                nodes {
                  author { login }
                  path
                  line
                  originalLine
                  body
                }
              }
            }
          }
        }
      }
    }'