address-findings

指摘への対応

Entire のトレイルにある未解決のレビュー指摘を修正し、解決します。指摘とは、entire.io のトレイルに投稿されたレビューコメントのことです。ファイルと行の位置、本文、重大度があり、統一差分形式の修正案が含まれる場合もあります。このスキルは未解決の指摘を取得し、現在のワークツリーでそれぞれを適用するか手動で修正してから、トレイル上で解決済みにします。

使用する場合／使用しない場合

ユーザーがトレイルを指定し、その指摘またはレビューコメントへの対応／修正／解決を依頼した場合に使用します。トレイルの指定方法は、https://<host>/<forge>/<owner>/<repo>/trails/<number>/<slug> のような URL、トレイル番号のみ、またはブランチ名です。

次の場合はこのスキルを使用しないでください。

• 現在の差分をコードレビューする場合。これは読み取り専用の review スキルです。
• 新しい指摘を作成する場合。entire trail finding add を使用してください。

応答形式

このスキルの呼び出しに対する最初の応答は、次の行から始めます。

Entire Address Findings:

その後に空行を入れ、本文を続けます。このヘッダーを適用するのは最初の応答のみです。エラーまたは早期終了の場合（CLI がない、認証されていない、トレイルが見つからない、ブランチが一致しない、未解決の指摘がない場合）は省略します。

ルール

1. 各指摘に対応する、正確で最小限の変更を行います。スコープを広げないでください。
2. 実際に対応した指摘のみ、解決済みにします。指摘が曖昧な場合や、人の判断が必要な場合は未解決のままにして、その旨を報告します。
3. コミットやプッシュは行わないでください。ユーザーが確認できるよう、変更はワーキングツリーに残します。
4. 指摘を解消するためだけに、テストやアサーションを決して弱めないでください。

手順

1. CLI を確認する

entire version を実行します。コマンドが見つからない場合は中止し、ユーザーに次のように伝えます。 「Entire CLI が必要ですが、インストールされていません。https://entire.io/docs/cli からインストールして、もう一度お試しください。」

2. トレイルの指定を解決する

• 引数がトレイル URL の場合は、/trails/<number>/ のパス部分から番号を取得し、その番号を使用します。
• 引数がトレイル番号、ID、またはブランチ名のみの場合は、そのまま使用します。
• トレイルを特定できない場合は中止し、トレイル URL または番号をユーザーに尋ねます。

以下の各コマンドでは、この値を <trail> セレクターとして使用します。entire trail はトレイル番号、ID、ブランチ名のいずれでも受け付けるため、番号を調べる必要はありません。ブランチ名をそのまま使用できます。

3. 未解決の指摘を取得する

entire trail finding list <trail> --json --status open

• 出力で認証が必要と報告された場合は中止し、ユーザーに次のように伝えます。 「entire trail finding list を実行するには認証が必要です。entire login を実行してから、もう一度お試しください。」
• trail finding サブコマンドを利用できない場合、または API からこの機能が有効になっていないと報告された場合は中止し、このアカウントまたはリポジトリではトレイルの指摘機能が有効になっていない可能性があるとユーザーに伝えます。指摘を捏造しないでください。
• JSON を解析します。各指摘には ID、重大度、ステータス、本文、位置（ファイルパスと行範囲）があり、修正案（統一差分）が含まれる場合もあります。
• 未解決の指摘がない場合は、「このトレイルに未解決の指摘はありません。」と報告して終了します。

4. ブランチの確認（トレイルのブランチにいる必要があります）

entire trail finding apply はローカルのワークツリーを編集するため、ファイルを変更する前にトレイルのブランチにいる必要があります。

git rev-parse --abbrev-ref HEAD                # current branch
entire trail list --json --status any -n 200   # locate the trail's branch

number または branch がセレクターに一致するトレイルを探し、その branch を確認します。

• トレイルのブランチが現在のブランチと異なる場合は中止し、ユーザーに次のように伝えます。 「トレイル <trail> の対象ブランチは <trail-branch> ですが、現在のブランチは <current-branch> です。先にチェックアウトして（entire trail checkout <trail>）、再実行してください。」ファイルは編集しないでください。
• トレイルを一覧から見つけられない場合（ページネーションなど）は、即座に失敗として扱わないでください。ブランチを確認できなかったことを警告し、続行する前にトレイルのブランチにいることをユーザーに確認してください。

5. 各指摘に対応する

指摘は重大度の高いものから順に処理します（高 → 中 → 低）。各指摘について、次の手順を実行します。

1. 統一差分形式の変更案がある場合は、まずドライランを実行します。

   entire trail finding apply <trail> <finding-id> --check
   

   問題なく適用できる場合は、適用と解決を一度に行います。

   entire trail finding apply <trail> <finding-id> --resolve
   

2. それ以外の場合（パッチがない、パッチが競合する、または修正に判断が必要な場合）： 指摘の本文を読み、該当箇所のファイルを開いて、問題に対処するための最小限かつ適切な編集を行います。変更したコードに対して、手早く実行できる適切なローカルチェック（ビルドや対象を絞ったテスト）があれば実行します。その後、解決します。

   entire trail finding resolve <trail> <finding-id> -m "<one line: what you changed>"
   

3. 自信を持って対応できない場合（内容が曖昧、プロダクトやデザイン上の判断が必要、または対象範囲外の場合）：未解決のままにし、解決済みにせず、報告用に記録します。

6. 報告

次の内容をまとめます。

• 推奨パッチで解決 — 指摘 ID とファイルを列挙します。
• 手動編集で解決 — 指摘 ID、ファイル、変更内容を一行で列挙します。
• 判断が必要なため未解決 — 指摘 ID とその理由を列挙します。
• 発生したエラー。

変更は未コミットで、レビューできる状態であることをユーザーに伝えてください。

失敗時の対応

• CLI がインストールされていない → 手順 1 のインストール案内を表示します。
• 認証されていない → 「entire trail finding list には認証が必要です。entire login を実行してから、もう一度お試しください。」と伝えます。
• Trail findings が有効になっていない／API エラー → この機能が利用できない可能性があることを伝え、指摘を捏造しないでください。
• Trail が見つからない → URL または番号を確認するよう伝えます。entire trail list --status any を提案します。
• ブランチが違う → 手順 4 のチェックアウト指示を伝えて停止します。
• パッチが適用できない → 手動編集に切り替えます。自信を持って修正できない場合は、指摘を未解決のままにして報告します。
• Git リポジトリではない → Trail のリポジトリ内から実行するよう伝えて停止します。