mcpField
C
claude

claude

github.com/dzhngエージェントワークフロー1.4k245 回インストール1 日前に更新
リポジトリ

claude について

認証済みの `claude` コマンドラインエージェントに限定したタスクを委任したり、別の視点を求めたりする Claude Code スキルです。証拠の確認、依頼範囲の明確化、提案された変更の検証を重視します。

主な機能

  1. 01別エージェントへの相談
  2. 02タスク範囲の限定
  3. 03証拠に基づくレビュー
  4. 04明示依頼による実装委任
  5. 05モデルと effort の既定値

活用シーン

  1. 01コードレビューの意見を求める場面
  2. 02明示的に依頼された実装の委任
  3. 03リポジトリの証拠によるエージェントの主張確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/dzhng/skills --skill claude

インストール後、Claude Code で/claudeを入力して読み込まれたか確認します。

詳細

Claude

Claude Code は PATH 上の独立したエージェント(claude)であり、この作業ツリーを共有し、すでに認証済みです。第二の意見や委任先として利用し、絶対的な正解として扱わないでください。主張を検証し、変更には自分で責任を持ち、タスクの契約範囲を狭く保ってください。

デフォルト

ユーザーまたはタスクが別のモデルや思考レベルを指定していない限り、claude -p --model opus --effort high を使用します。Claude Code が現在の Opus リリースを解決できるよう、opus をエイリアスとして使い続けてください。このスキルでは日付付きのモデル ID を固定しないでください。

  • モデル: 現在の Claude リリースに追従する opus、sonnet、fable などのエイリアスを優先します。フルモデル名を受け入れるのは、ユーザーまたはタスクでその特定のモデルが必要とされ、かつそれが現行であることを先に確認した場合に限ります。デフォルトは opus です。
  • 思考レベル: Claude Code の --effort フラグを指定します。有効なレベルは low、medium、high、xhigh、max です。デフォルトは high です。
  • コスト上限: 探索的な依頼では、ユーザーが予算を指定している場合、またはタスクが広がる可能性が高い場合に、--max-budget-usd <amount> を追加します。

例:

claude -p --model opus --effort high "<prompt>"

Claude へのプロンプト

Claude にはオペレーターとして、簡潔で、ブロック構造に沿い、必要な成果物を明示してプロンプトを作成します。曖昧さを減らした契約のほうが、努力量を増やすより効果的です。

  • 1 回の実行につき 1 つのタスク。 レビュー、実装、ドキュメント作成は、別々のプロンプトに分けます。
  • 関連する場合は、リポジトリのスキル名を指定します。 Claude はリポジトリ内のファイルを読めるため、スキルをプロンプトに貼り付けるのではなく、「ドキュメントでは write-docs に従ってください」や「refactor-clean に従い、互換性ラッパーを追加しないでください」と指示します。
  • 必要な場合にのみブロックを追加します。
    • <task> — 具体的な作業、コンテキスト、期待する完了状態。
    • <output_contract> — 正確な回答形式。最も重要な内容を先にします。
    • <default_follow_through> — リスクの低い解釈で作業を続けます。不足情報によって正確性、安全性、または取り消せない操作に影響する場合に限り、停止します。
    • <verification_loop> — 要件に照らして結果を確認し、確定前に修正します。
    • <grounding> — すべての主張をコードまたはツールの出力に基づかせ、推論にはその旨を明記します。
    • <action_safety> — 差分を対象範囲内に厳密に限定し、ついでのリファクタリングを行いません。
  • アンチパターン: 曖昧なプロンプト、複数の作業の混在、出力契約の欠如、タスクを明確にする代わりに「もっとよく考えて」と求めること、証拠を確認せずに回答を受け入れること。

コンサルテーション

ユーザーが Claude の見解を求めた場合、または別のエージェントによる確認でリスクを大きく減らせる場合は、Claude に相談します。ユーザーが明示的に編集を依頼していない限り、読み取り中心にします。

  1. 雰囲気ではなく証拠を求めます。ファイルパス、観察した動作、コマンド出力、または推論であることの明記を要求します。
  2. レビューには読み取り専用のツール環境を優先します。 --tools "Read,Grep,Glob,Bash" --permission-mode dontAsk
  3. 出力契約で必要とするツールを制限しないでください。 自分のプロンプトを読み返し、要求した各主張をどのツールが裏付けるか確認します。コマンドを実行できない審査役に数値で回答するよう求めると、何も測定していないのに、整合性の取れた数値や、作成したとする成果物を回答してしまいます。ツールを制限しても慎重になるわけではありません。捏造を見つけにくくするだけです。必要なツールを許可するか、その主張を求めるのをやめてください。
  4. 数値には必ず根拠を添えるよう求めます。回答に含める数量には、それを生成したコマンドとその出力を必ず付けさせます。この条件を満たさない指摘は、重みを下げるのではなく退けます。
  5. 対応する前に、すべての指摘をコードと照合して選別します。Claude が指摘した内容、採用した内容、退けた内容を報告します。

実装 — 明示的な依頼がある場合のみ

ユーザーがタスクで Claude を指定した場合に限り、実装を Claude に委任します。 自分の判断で委任してはならず、新たな依頼なしに後続作業を再委任しては なりません。

  1. タスクを明確に切り分けます。目標、制約、許可する範囲、検証方法を定めます。 仕様が曖昧なタスクは、新しいエージェントが誤解しようのない状態になるまで、 自分で担当します。
  2. クリーンなツリーから開始するか、ベースラインのコミットを記録して、 Claude の差分を自分の変更と分離できるようにします。プローブ、ダンプ、 メモなどの一時ファイルをツリーに置かないよう Claude に伝えます。 差分には成果物のみを含めます。
  3. タスクに必要な作業に応じて権限を選択します。
    • 読み取り/レビュー:--tools "Read,Grep,Glob,Bash" --permission-mode dontAsk。
    • 限定的な編集:編集ツールを追加し、プロンプトで許可するパスを明示します。
    • 広範な自律作業:専用のワークツリー内でのみ --dangerously-skip-permissions を使用し、自分で作成したプロンプトを使い、 作業後に必ず差分をレビューします。
  4. 特に指定がなければ、--output-format text で応答を取得します。 呼び出し元が構造化メタデータを必要とする場合に限り、 --output-format json を使用します。
  5. 結果の責任は自分にあります。差分を確認し、関連するテストを実行してから報告します。 「Claude が完了したと言った」だけでは完了ではありません。

稼働性

claude -p はネットワーク接続と認証を必要とする非対話型の実行です。 失敗した場合は、再試行する前に原因を分類します。

  • 認証エラー:ユーザーから依頼がない限り、認証情報を修復してはなりません。 ブロッカーとして報告します。サンドボックス内の claude -p が Not logged in と表示した場合は、ローカル認証がキーチェーンやセッションへの アクセスに依存することがあるため、必要な承認を得て一度だけ再試行します。
  • サンドボックス/ネットワークエラー:タスク上重要なコマンドであれば、 必要な承認を得て再実行します。
  • 長時間実行:実行時間の上限を引き上げる前に、 --max-budget-usd を指定するか、プロンプトの範囲を狭めます。
  • ワークスペースの信頼性:-p は対話型の信頼確認ダイアログを省略するため、 信頼できると判断したリポジトリまたはワークツリーからのみ実行します。

ルール

  • デフォルトの呼び出し方法として claude -p --model opus --effort high を使用します。 エイリアスにはバージョンを指定せず、最新の Opus リリースに追従させます。
  • ユーザーが平易な言葉でモデルや effort の変更を指定した場合は、 それを --model と --effort に反映します。
  • 明示的な委任がない限り、Claude による書き込みを作業ツリーに反映してはなりません。
  • Claude が編集している間は、同じ作業ツリーに手を加えてはなりません。
  • Claude の出力は検証すべき証拠として扱い、そのまま正しいものとして伝えてはなりません。
  • 出力の契約に合ったツール構成を選択します。利用を許可していないツールによる 主張は、捏造されたものとして扱います。

コメント