Skip to content
cccskills
FreePublished on GitHub

codex-consult

Codexへの単発の相談・調査・診断依頼を、ハング防止(watchdog)付きで実行する。反復・収束判定・コミットゲートは持たない。行き詰まって一回だけCodexに相談・調査を依頼したいときに使う。

コミット前のレビュー収束が目的ならcodex-review-loopを使う。

The English summary is being prepared. Showing the original description.

See how to install

Files included (1)

  • SKILL.md6.6 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Codex 単発相談(ハング防止付き)

Codex への一回限りの相談・調査・診断・修正方針のヒアリングを、codex-watchdog スキルの契約で ハングを防ぎながら実行する。codex-review-loop と異なり、反復・収束判定・コミットゲートは 持たない(一回相談すれば終わり)。

いつ使うか

  • 行き詰まって Codex に一回相談したい、調査・診断を依頼したい場面。
  • コミット前のレビュー収束を取りに行く場面は対象外(codex-review-loop を使う)。

起動可否

特別なゲートはない(呼び出し判断は通常どおり Claude が行う)。ただし codex-watchdog スキルの 使用不可の検知と再試行のとおり、前ラウンドで記憶した「使用不可」の状態が無いか先に確認する。

手順

手順1: 相談内容の整理

依頼を、Codex に渡すタスク指示文としてまとめる。グラウンド済みの事実(実コードで確認した内容)と、 評価・判断を求める論点を分けて書き、何を達成するための相談かを冒頭に明記する。

手順2: 実行モードの決定

既定はread-only(相談・調査・診断が目的で、repo を編集させないため)。ユーザーが明示的に 「Codex に直してもらう/修正を実行してもらう」ことを求めている場合に限り、 codex-watchdog の作法に従って write-capable(--write)で起動する。

手順3: 相談実行(1回)

codex:codex-rescue エージェント(Agent ツール、 subagent_type: "codex:codex-rescue")を、codex-watchdog スキルの契約のとおりに 実行する(同スキルが定める契約全体に従う。一部だけを選んで適用しない)。 タスク指示文には手順1でまとめた内容と、 手順2で決めた read-only/--write の指定を含める。node を Bash で 直接叩かない(層違い)。

合否解釈(codex-watchdog の機械的な判定に、相談固有の解釈を重ねる)

  • エージェントの応答に、codex/companion/app-server が起動失敗・完走不能だったことを示す記述 (EPERM・初期化失敗・アクセス拒否等)と、タスク内容への回答(確認結果・分析・助言等)が同時に 含まれる場合(自己代行) → 契約違反として失敗と同様に扱い、応答内容を採用しない(参考にも しない)。「念のため自分で確認した」等の注記が付いていても、codex 自身が完走していない以上 採用しない(Codex 未完走時の自己代行禁止参照)。この判定は、失敗の症状が EPERM かつ呼び出し側 原因の既知パターンに一致する場合であっても変わらない(自己代行は codex 未完走時にエージェント 自身がタスク回答を代行した独立の契約違反であり、EPERM の原因分類とは別軸のため)。新しい RUNID を発行して1回だけ再試行する(下記の失敗時と同じ再試行ルールに従う)。
  • 上記の自己代行に該当せず、かつ codex が完走した(起動コマンドとエラーのみを報告する失敗報告 ではない)応答を返す → Codex の回答として採用する。
  • watchdog 正常終了なのにエージェント応答が来ない場合(ログ走査で 代替する経路) → 抽出できた内容を参考情報としてユーザーへ提示してよいが、「Codex の 正式な回答」として断定しない(ラウンド同一性が保証されないため)。通知取りこぼしが起きた旨も 明示する。
  • codex-watchdog が失敗と判定した場合(stall/no-start/wall-cap/失敗、エージェントの失敗報告・ 早期復帰) → EPERM の場合は、無対策のまま再試行することを禁止する: codex-watchdog の EPERM は呼び出し側の失敗と推定するの手順どおりジョブログ本文(ジョブ状態ログの書き込み 自体がサンドボックス制限で拒否され参照できない場合はエージェント報告の起動コマンドと生の エラー出力)と起動コマンドを起動コマンドの既知の不備パターンと照合し、特定した具体的な不備を名指しした禁止文を 再試行のタスク指示文に追加してから、新しい RUNID を発行して1回だけ再試行する。起動コマンドの既知の不備パターンのいずれにも該当しない未知のパターンの 場合は、その旨を手順4の報告に含めた上で、EPERM 以外の失敗と同じくそのまま新しい RUNID で 1回だけ再試行する。 再試行後に(失敗理由が初回と同じか異なるかを問わず)再び失敗と判定されたら、その時点で再試行を 止め、試みた内容と失敗理由(stall/no-start/wall-cap/失敗のいずれか、拒否されたコマンドが あればそれも)をユーザーへ平文で報告する(このスキルは反復ループを持たないため、 codex-review-loop のような千日手・複数ラウンドの再試行はしない)。

手順4: 報告(日本語)

Codex の回答の構造(判定・要約・根拠・確認事項の区別)を保ったまま提示する。コミットや修正の 自動適用はしない(相談結果を踏まえてどうするかはユーザー/呼び出し元が判断する)。

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

仕様書/実装計画書をもとに、計画を見出し単位のステップへ分解し、各ステップで「テスト作成→レビュー→収束ならコミット」「実装→レビュー→収束ならコミット」(必要なら「ドキュメント修正→レビュー→収束ならコミット」)を自律反復する。ユーザーから自律進行(止まらず最後まで進める・ステップを自動で回す等)の明示的な指示があったときだけ使う。単に計画に沿って実装してほしいだけの依頼(自律進行の指示を伴わない)では使わない。レビューは codex-review-loop、コミットは commit に委譲し、仕様整合(参照の記法・用語規約)はエージェントが直接確認する。

The English summary is being prepared. Showing the original description.

skyflash521/mmd-toolbox13Updated Oct 14, 2026

codex:rescueにレビューさせ、各指摘を実コードで検証して修正/反証/受容/保留に仕分け、再レビューを反復する。未解決ゼロ・千日手・要ユーザー判断のいずれかで終了。コードレビューを回したいときに使う。

The English summary is being prepared. Showing the original description.

skyflash521/mmd-toolbox13Updated Oct 14, 2026

codex:codex-rescueエージェントを起動する各スキル(codex-review-loop・codex-consult等)が共有する、ハング防止付きの起動・監視・再試行契約の正本。内部専用でユーザーが直接使うものではない。

The English summary is being prepared. Showing the original description.

skyflash521/mmd-toolbox13Updated Oct 14, 2026

commit

Free

gitコミットをcommit-workerエージェントに委譲して実行する。コミットの依頼を受けたとき、変更をコミットするときに使用する。

The English summary is being prepared. Showing the original description.

skyflash521/mmd-toolbox13Updated Oct 14, 2026

fable-reviewer(Fableモデル、read-only)にレビューさせ、各指摘を実コードで検証して修正/反証/受容/保留に仕分け、再レビューを反復する。未解決ゼロ・千日手・要ユーザー判断のいずれかで終了。Fableモデルでコードレビューを回したいときに使う。

The English summary is being prepared. Showing the original description.

skyflash521/mmd-toolbox13Updated Oct 14, 2026

opus-reviewer(Opusモデル、read-only)にレビューさせ、各指摘を実コードで検証して修正/反証/受容/保留に仕分け、再レビューを反復する。未解決ゼロ・千日手・要ユーザー判断のいずれかで終了。Opusモデルでコードレビューを回したいときに使う。

The English summary is being prepared. Showing the original description.

skyflash521/mmd-toolbox13Updated Oct 14, 2026

See all skills by skyflash521

Report a problem with this skill