loop-skill について
loop-skillは、指定したスキルを連続して実行し、最終的な差分のみを報告するエージェントスキルです。中間報告を省いて複数回実行するワークフローに向いています。
主な機能
- 01指定スキルの反復実行
- 02既定で3回実行
- 03各回に引数を引き継ぎ
- 04最終的な差分のみ報告
活用シーン
- 01スキルを繰り返して結果を改善
- 02複数回にわたるスキル実行
- 03反復実行後の変更を集約
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ paulrberg/ agent-skills --skill loop-skillインストール後、Claude Code で/loop-skillを入力して読み込まれたか確認します。
同梱ファイルagents/openai.yaml
詳細
ループスキル
別のエージェントスキルを複数回続けて実行し、最終的な差分のみを報告します。
引数
- 対象スキルの呼び出し:必須です。
$skill-name、skill-name、SKILL.mdへのパス、またはスキルとその引数を指定する自然言語の指示を指定できます。 --runs <n>または-n <n>:省略可能な正の整数の反復回数です。既定値は 3 です。- 追加の対象引数:各反復で対象スキルにそのまま渡します。
前提条件
- Plan モードでは実行しないでください。現在のモード、ツール、またはユーザーの指示が計画のみの作業を示している場合は、停止して
$loop-skillは実行専用であり、Plan モードでは実行できないと伝えてください。実行モードまたは既定モードに切り替えて、もう一度呼び出すよう案内してください。 - 対象スキルが必要です。リクエストで対象が指定されていない場合は、スキルの呼び出しを尋ねてください。
- 開始前に対象スキルを特定してください。
$skill-nameまたはskill-nameの場合は、../skill-name/SKILL.mdを読みます。- パスの場合は、その
SKILL.mdを読みます。 - 会話内にすでに読み込まれたスキルのブロックがあり、指定された対象に明確に一致する場合に限り、そのブロックを使用します。
- 対象を特定できない場合は停止し、スキルが見つからないことを伝えてください。
loop-skill自体を対象にすることは拒否してください。- 必須のワークフローでコミット、タグ、スタッシュ、強制リセット、または中間的な Git 履歴に依存するその他の操作を行う対象は拒否してください。このループではコミットを作成しません。
ワークフロー
1. 初期化
- 実行回数を解析します。ユーザーが別の正の整数を明示的に指定していない場合は、3 を使用します。
- 対象スキルの指示を一度読みます。
- 対象が差分を確認する可能性がある場合は、
git rev-parse --git-dirでリポジトリの状態を確認します。失敗した場合は、対象スキルが明示的にリポジトリ作業以外のものである場合に限り続行します。 - 最終的な差分レポート用に初期状態を記録します。
git status --shortgit diff --statgit diff --name-only --diff-filter=ACMRgit ls-files --others --exclude-standard
2. 反復
指定された実行回数に達するまで、各反復で次の手順を実行します。
- ユーザーの対象引数を指定したものとして、対象スキルをインラインで実行します。
- 以下のループ制約を対象スキルに適用します。
- コミット、タグ、ブランチ、スタッシュ、その他の永続的な Git 履歴を作成しないでください。
- 対象スキルの指示でより狭い範囲が必要になる場合を除き、対象範囲を維持してください。
- 対象スキルが停止または指示を求める必要がある場合を除き、ユーザー向けの完全なレポートを作成しないでください。
- 対象スキルが停止条件に該当した場合はループを停止し、完了した作業の差分レポートと停止理由を報告します。
3. 検証
最後の反復が完了した後、変更された動作を証明できる最小限のコマンドで、最終的な差分を検証します。
just test、just lint、just mdformat-checkなどのプロジェクトの手順を優先します。より限定的な手順がある場合は、それを使用します。- 実行しなかったチェックとその理由を明記します。
4. 報告
最終レポートを 1 件だけ作成します。途中の修正ではなく、初期状態から最終状態までの差分に基づいて報告してください。
以下の見出しを順番どおりに使用し、該当しないセクションは省略します。
Loop
対象スキル、対象引数、要求された反復回数、完了した反復回数、およびループが途中で停止したかどうか。
Net Changes
最終的に変更されたファイルと動作。途中の作業は、最終的な判断や残存リスクの説明に必要な場合に限り記載します。
Verification
実行したコマンドとその結果。実行しなかったチェックも含めます。
Residual Risks
リスク 1 件につき 1 行で記載します。形式は 前提を置いた。誤っている場合は<壊れるもの>。<コマンドまたは確認方法>で確認する。 とします。リスクがない場合は なし。 と記載します。
コメント
Markdown 対応