check について
checkは、マージ前の実行時検証や差分レビュー、またはその両方を支援するエンジニア向けAgent Skillです。実行確認と読み取り専用のコードレビューを別モードで扱います。
主な機能
- 01アプリを実行し仕様どおりか検証
- 02別のモデルで差分をレビュー
- 03レビュー結果を重要度順に整理
- 04実行検証とレビューを別モードで実施
活用シーン
- 01受け入れ条件に照らした機能の確認
- 02PR前のコード差分レビュー
- 03レビュー依頼前の実行検証
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ jsmastery-pro/ skills --skill checkインストール後、Claude Code で/checkを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
review-agent-prompt.mdreview-guide.mdagents/openai.yamlmodes/review.mdverify.md詳細
出力スタイル(平易な言葉、ダッシュやハイフンなし)
このスキルが作成するファイルやメッセージなど、すべてを平易でシンプルな言葉で書いてください。読者には「あなた」と呼びかけ、同僚に話すように温かく、率直に伝えてください。すべての手順は、実行しても省略してもよい提案として示し、命令はしないでください。本当に意味のある専門用語は残し、それぞれを平易な言葉で説明してください。句読点としてダッシュやハイフンは使わないでください。em ダッシュ、en ダッシュ、ハイフンでつないだ複合語は使えません。read-only ではなく read only と書いてください。平易な言葉で述べるか、文を書き換えてください。コード、ファイルパス、コマンドフラグ、ほかのスキルが照合する値に含まれるハイフンはそのまま残してください。短い文を使い、読点や括弧を使ってください。巧みさより明快さを優先してください。
このスキルの役割
/check はマージ前の確認ゲートです。役割の異なるモードが2つあります。通常は両方を使い、最初に確認します。
verify(実行時の検証):実際のアプリを動かし、変更後の動作を確認します。テストがすべて成功しても明らかにならない、仕様どおりに動作すること(すべての受け入れ条件を満たし、仕様で定めたすべての箇所が実装されていること)を証明します。コードは読み取り専用で、永続的なファイルは作成せず、メインスレッドで実行します。通常は/developの後に行います。review(新しいモデルによるコードレビュー):コードを書いたモデルとは別のモデルが差分を詳しく読みます(モデルが自分の出力をレビューすると、同じ見落としが生じます)。重大度順に所見をdocs/reviews/に書き出します。読み取り専用です。通常は PR の前に行います。
どちらのモードもコードは編集しません。verify で見つかった失敗は /debug または /develop に報告し、review では修正すべき所見を報告します。
モードを選ぶ(ほかの作業より先に振り分ける)
最初に行うのは、モードファイルを読んだりリポジトリに触れたりする前の振り分けです。/check に続く入力を確認してください。
verify(またはrun)で始まる場合 →modes/verify.mdを読み、内容に従ってください。残りの引数(機能名、範囲)も引き継いでください。reviewで始まる場合 →modes/review.mdを読み、内容に従ってください。追加の指定も変更せずに引き継いでください(例:/check review with opus、/check review uncommitted)。- モードの語がない場合、または曖昧な場合(
/checkのみ、または/check authのように機能名はあるがモードがない場合)→ 推測せず、デフォルトも選ばないでください。2つの選択肢をプレーンテキストのパネルで示し、そこで止まって、エンジニアの選択を待ってください。
選択肢の示し方(プレーンテキスト、あらゆるエージェントで使用でき、対話型モーダルは不要):
次の内容をそのまま表示し、そこで止まって返答を待ってください。相手が答える前に verify を選ばないでください。入力された語(verify/review/both)に応じて振り分けてください。
Which check do you want to run? Type one:
• verify run the real app and prove the change works against its spec (usually right after /develop)
• review a fresh model senior read of the diff, ranked findings (usually right before a PR)
• both verify first, then review
対話型のピッカーやモーダルは使わないでください。入力による選択をそのまま表示する方法なら、どの AI ツールでも同じように使えます。(argument-hint のフロントマターも Claude Code の自動補完に verify | review を表示しますが、ほかのツールでは無視されます。そのため、このインラインパネルがどこでも使える方法です。)
モードを指定せずに機能名(/check auth)が入力された場合は、選択後も対象として引き継いでください。モードは必ず確認してください。
1回の実行でモードを混在させないでください。both の場合は、最初に verify を行い、次に review を実施するか確認してください。
移植性(あらゆる OS とエージェントに対応)
macOS、Linux、Windows の Agent Skills クライアントで使用できます。必須の CLI は git のみです。そのほかのシェルコードは POSIX を参考にしたもので、そのまま実行するスクリプトではありません。エージェントが備える、クロスプラットフォーム対応のファイル、プロセス、ブラウザ用ツールを使ってください。各モードのファイルには、それぞれ移植性に関する説明があります。サブエージェントに対応していない場合はインラインで実行し、その手順は各モードに記載されています。
同梱ファイル:modes/verify.md、modes/review.md、レビュー用の review-agent-prompt.md と review-guide.md。振り分けたモードのファイルだけを読んでください。レビュアーを起動するときは、レビュー用の同梱ファイルを絶対パスで指定してください。