scope について
編集を依頼内容に沿わせ、既存の動作を保つためのレビュー用スキルです。範囲の確認、依頼項目の追跡、以前の指示の遵守、意図しない変更の検査を扱います。
主な機能
- 01指定された対象だけを変更
- 02依頼項目を追跡して報告
- 03以前の指示や値を引き継ぐ
- 04リファクタリング時に既存機能を維持
- 05計画と実装を区別
活用シーン
- 01範囲を限定したUI変更のレビュー
- 02複数項目を含む依頼への対応
- 03リファクタリングでの機能欠落確認
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/scopeを入力して読み込まれたか確認します。
同梱ファイルagents/openai.yaml
詳細
スコープ
このスキルは、依頼の編集を担います。文字どおりの意味を最小限に読み取り、すでに機能しているものをすべて維持し、ユーザーが送った項目を漏れなく扱います。
最小限の解釈を優先する
指定された要素の外側に対する変更は、ユーザーが一括対応を求めていない限り、指摘事項です。広範な変更の前に短く質問を1つすることは、指摘事項ではありません。短いメッセージで1つの要素が指定されている場合、複数の依頼がまとめられている場合、リファクタリングの場合は、特に厳密に確認します。
頼まれていないものを削除することは restraint に該当します。変更が機能することを確認することは verify に該当します。
すべての依頼に回答する
メッセージを番号付きの項目に分割し、以前のやり取りに残っている未対応項目も追加します。最後に同じリストを示し、各項目について、対応済みか未対応かとその理由を記載します。4つの依頼のうち最初の1つだけを実行することは scope-list-every-ask に該当します。
指定された要素だけを対象にする
対象を数語で言い換えます。「カード」とはカードのことであり、周囲のページではありません。トップバーの依頼に対してシェル全体のスタイルを変更することは scope-smallest-reading に該当します。2通りの解釈が成り立つ場合は、短く質問を1つします。
以前の指示も引き続き有効
編集する前に、スレッド内のユーザーによる以前の修正指示と、リポジトリ内のルールを読みます。ユーザーが削除したものを再び追加することは scope-remember-instructions に該当します。ユーザーが指定した値（たとえば左側のパディング 16px）はそのまま維持します。新しい値を推測することは scope-keep-given-values に該当します。
機能していたものを維持する
リファクタリングの前に、現在ある機能、ボタン、状態を列挙し、その後、それぞれを確認します。戻るボタンがなくなることは scope-keep-what-worked に該当します。1つのプロパティを修正するときは、ほかのプロパティを維持します。幅のアニメーションを削除してクリップを修正することは scope-no-collateral に該当します。
未リリースの作業は今対応する
未リリースの作業について、ユーザーに確認せず、フェーズに分けたり対象外としたりしません。「フェーズ2」のリストを作ることは scope-no-phasing に該当します。計画中は計画だけを立てます。計画が承認される前にファイルを編集することは scope-plan-means-plan に該当します。
説明を求められたら説明する
ユーザーから仕組みを尋ねられたら、説明して待ちます。「これはどう動きますか」という質問に差分で答えることは scope-explain-when-asked に該当します。
対比
すべての確認項目は対になっています。問題のある行の横に、それを置き換える行を示します。
| ルール | 問題のある例 | 置き換え |
|---|---|---|
scope-list-every-ask | 4つの依頼のうち1つだけ対応し、3つを放置 | 4項目に番号を付け、それぞれ報告する |
scope-smallest-reading | 「トップバーを修正」でシェル全体のスタイルを変更 | トップバーだけを変更する |
scope-remember-instructions | ユーザーが削除したドットを再び追加 | 編集前に以前のやり取りを読む |
scope-keep-given-values | 左側のパディングを 12px と推測し直す | ユーザーが指定した 16px を維持 |
scope-keep-what-worked | リファクタリングで戻るボタンと進むボタンがなくなる | 前後の機能一覧を作り、両方のボタンを維持 |
scope-no-collateral | クリップを修正した結果、幅のアニメーションがなくなる | クリップを修正し、幅のアニメーションを維持 |
scope-no-phasing | 「保存済みフィルター：フェーズ2」 | 今すぐ実装するか、質問を1つする |
scope-plan-means-plan | 計画中にファイルを編集 | 承認されるまでは計画だけを立てる |
scope-explain-when-asked | 「仕組みを説明して」に差分で回答 | 説明してから待つ |
報告
重大度。 HIGH は機能の欠落、または以前の指示の取り消しです。MEDIUM は指定された要素の外側への変更、または未報告の依頼です。LOW は解釈が明らかな場合に質問することです。
形式。 根本原因ごとに指摘事項を1つ記載します。該当するファイルがない場合は、依頼を引用します。
file:line - [rule-id] what is wrong
request 2 - [rule-id] what is wrong
続けて Rule | Count | Severity のサマリーを記載します。HIGH が1つでも残っている場合は Block、それ以外は Approve とします。読んでいない差分を Approve にしてはいけません。実行できなかった確認項目はすべて Not verified と記載します。