claude-skill

Claude Code ヘッドレスモード

Claude Code 自体を通じて実行する作業のために、claude コマンドを作成して実行します。

参照先	参照するタイミング
references/flags-and-permissions.md	-p 以外の設定が必要な場合 — 権限モード、ツールの範囲指定、出力形式、フラグ一覧、インストール
references/examples.md	特定のタスク形式のコマンド例を確認したい場合（読み取り専用の分析、安全な編集の実行、JSON レポート、再開、MCP、サンドボックス化された無人実行）

対象のマシンに claude CLI がインストールされ、認証済みである必要があります。

基本ルール

• 対象のマシンで実行した claude --help の内容が、互換性の最低基準です。 CLI フラグや権限ルールの構文は、ドキュメントやコピーされた例よりも速く変更され、ビルドによっても異なります。一般的でないフラグを出力する前に、そこで確認してください。
• ユーザーから上書きを求められた場合、または再現性のためにワークフローでモデルを固定する必要がある場合を除き、--model を追加しないでください。ユーザーが設定したモデルをデフォルトとして使用してください。
• Claude Code のデフォルトの動作を置き換えることが目的でない限り、--system-prompt より --append-system-prompt を優先してください。
• タスクに適合する範囲で、最も制限の厳しいモードを選んでください。 コーディングの自動化では、通常 acceptEdits から始めます。完全に無人で実行する場合は、まず明示的な権限ルールか dontAsk を使用してください。bypassPermissions は、すでに隔離された環境でのみ使用してください。

タスクに必要なものを確認する

実行前に、CLI が利用可能で認証済みであることを確認してください。このコマンドで必要となるフラグは claude --help で確認します。互換性やインストールに不確かな点がある場合は、バージョン確認コマンドや診断コマンドを使用してください。コマンド例を求める依頼は、そのタスクの実行を許可するものではありません。

基本形

claude -p "summarize the repository architecture"
claude -p "review the auth layer for risks" --output-format json

それ以外は、ツールと権限の範囲を設定します。詳しくは参照先を確認してください。

一時停止する場合

必要な認証情報がない場合、必要な機能を利用できない場合、または権限の拡張が必要な場合は、一時停止してください。同等のサポート対象コマンドで依頼の範囲内に収まるなら、承認の手順を追加せずに使用してください。

返す内容

実行を依頼された場合は、許可されたコマンドを実行し、その結果と関連する成果物を確認してください。コマンドを表示するだけで終わらせたり、終了コードがゼロであることを依頼された作業の完了の証明として扱ったりしないでください。作業が残っている場合は、既存の範囲内で限定的な後続作業を続けてください。コマンドのみを求められた場合は、実行せずにコマンドを返してください。

コマンド、結果、関連する確認事項、権限や検証に関する不足を報告してください。ワークフローを後で続ける予定がある場合に限り、再開用コマンドを含めてください。