codex-doctor

Codex Doctor

2 層のヘルスチェックを実行します。

1. Codex の安定した組み込みコマンド codex doctor --json を再利用して、インストール、設定、認証、ランタイム、Git 環境、ターミナル、app-server、更新、スレッドインベントリをチェックします。インデックス化された履歴のうち、デフォルトプロバイダーが占める割合がごく少ない場合に限り、範囲を絞った警告を 1 つ導き出します。
2. バンドルされた読み取り専用スキャナーを実行し、組み込みコマンドではカバーされないワークスペースコンテキストのガバナンスをチェックします。

スキャナーは決定論的な証拠を収集します。意味に基づく判断はあなたが行います。この分離は重要です。スクリプトでテキストの反復は証明できますが、業務上の事実、安全上の境界、ブランドの語調、ディレクトリのルールが不要かどうかを安全に判断することはできません。

チェックを実行する

読み込まれた Skill のパスから Skill ディレクトリを特定し、次を実行します。

python3 <skill-dir>/scripts/scan_workspace.py --cwd "$PWD" --compact-json

組み込みレポートを同じタスク内ですでに実行している場合は、より高速なワークスペースのみのチェックとして次を実行します。

python3 <skill-dir>/scripts/scan_workspace.py --cwd "$PWD" --compact-json --skip-built-in

--compact-json は、すべての指摘事項と組み込みチェックのすべての行を保持しつつ、大きな Skill インベントリと詳細な合格チェック情報を省略します。完全な決定論的インベントリ証拠が必要な場合に限り、--json を使用してください。

生の組み込みレポートをリポジトリ内に保存しないでください。一時保存が必要な場合は、/tmp を使用し、完了前に削除してください。

指摘事項を解釈する

クリーンアップや修正を提案する前に、checks-and-repair-policy.md を読んでください。重大度と確信度は分けて扱います。

• S0：秘密情報の露出、または破壊的なリスクが証明されている
• S1：有効な設定の破損、重要なルールの切り捨て、有効化された実行可能ファイルの欠落、またはインストールと更新の不一致
• S2：完全な重複、アクティブな名前／ソースの重複、または明らかなプロジェクトの衛生上の違反
• S3：保守上の負担、古くなった無効なエントリ、新バージョンのお知らせ、または過度に長い説明
• S4：情報提供、意味的な候補、または証拠の不足

semantic_candidates は検査を促す項目として扱い、指摘事項とはみなさないでください。該当するソースセクションを読み、次のいずれかに分類します。

• 動作ルールまたは安全上の境界：維持する
• ユーザー設定、ブランドの語調、業務上の事実、またはディレクトリの取り決め：維持する
• 複数ファイルを統合して判断する必要があるリポジトリの事実：通常は維持する
• 直接確認できるインベントリ、フレームワークのバージョン、依存関係の一覧、またはディレクトリ一覧：削減候補
• 古くなった記述または矛盾する記述：変更を提案する前にリポジトリと照合する

未使用 Skill の証拠

静的な検出だけでは、Skill が使われていないことを証明できません。ユーザーが未使用または使用頻度の低い Skill を明示的に尋ねた場合は、インストール済みの codex-skill-admin Skill を読み取り専用の監査モードで使用します。

python3 <codex-skill-admin-dir>/scripts/codex_skill_admin.py audit-unused --cwd "$PWD" --days 30

証拠の対象期間と、重複しないセッション／ソースの数を報告します。ユーザーが別途依頼し、対象リストを承認しない限り、無効化しないでください。

レポートの構成

全体的な結果を先に示し、その後、対応が必要な項目または判断に関わる項目のみを表示します。

# Codex 健康检查

状态：PASS / WARN / FAIL

## 需要处理
- [finding id] severity / confidence — conclusion
  Evidence: source and observed state
  Impact: concrete failure or context cost
  Recommendation: exact next action

## 建议人工审查
- semantic candidates with why they may be inferable or stale

## 已通过
- grouped domains, not every low-level row

## Evidence gaps
- checks that cannot be proven from public/local data

組み込み doctor のサブチェックは、それぞれ別の事実として維持します。たとえば、HTTP 到達性の失敗と WebSocket の成功は 2 行に分けたままにしてください。「ネットワークに問題がある」のようにまとめてはいけません。

修復プロトコル

診断を行っても、修復が許可されたことにはなりません。ユーザーから指摘事項の修正を依頼された場合：

1. 指摘事項 ID、正確な原文、問題の理由、単一ファイルの unified diff を 1 件ずつ提示します。
2. 変更によって指示を削除または意味的に書き換える場合、設定を変更する場合、コンポーネントを有効化または無効化する場合、あるいはファイルを移動する場合は、その指摘事項 ID について明示的な承認を求めます。
3. パッチを適用する直前に、対象ファイルの SHA-256 を再計算します。スキャン時の証拠と異なる場合は中止します。
4. 承認された diff のみを apply_patch で適用します。
5. 該当するチェックを再実行し、修正前後の結果を報告します。

次の操作は決して自動で行わないでください。

• 安全規則、ブランド／ペルソナ規則、ビジネス上の事実、プロジェクトに関する事実、Git ゲート、またはディレクトリ境界を削除または弱める
• AGENTS.md と CLAUDE.md の両方に記載されているという理由だけでテキストを削除する。ホスト間の同等性を意図している場合があります
• パフォーマンスを測定するためにフックを実行する
• フックを信頼する、MCP にログインする、認証情報を公開する、依存関係をインストールする、Codex を更新する、またはプロバイダーを変更する
• サンドボックス、承認、モデル、ネットワーク、または認証の設定を変更する
• 破壊的な Git コマンドを実行する、追跡対象外のファイルを削除する、または保護対象のプロジェクトディレクトリを移動する

完了チェック

完了を報告する前に、次の点を確認します。

• スキャナーによるリポジトリの変更がないことを確認します
• 組み込みの Codex 診断とワークスペースガバナンスに関する指摘事項を区別します
• 推論には「推論」と明記します
• スキップしたチェックと証拠の不足を報告します
• 修復が承認されていた場合は、変更した各ファイルを検証し、該当するドメインチェックを再実行します