プロジェクトスキル監査

概要

スキルを推奨する前に、プロジェクトの実際の反復的なワークフローを監査します。一般的なブレインストーミングよりも、メモリ、ロールアウトサマリー、既存のスキルフォルダ、および現在のリポジトリ慣例からの証拠を優先します。

既存のプロジェクトスキルが既に必要な動作に近い場合、新しいスキルを作成する前に更新を推奨します。

ワークフロー

1. 現在のプロジェクト表面をマッピングします。 リポジトリルートを特定し、最初に最も関連するプロジェクトガイダンス (例: AGENTS.md、README.md、ロードマップ/台帳ファイル、ワークフローや検証要件を定義するローカルドキュメント) を読みます。

2. メモリ/セッションパスを最初に作成します。 $CODEX_HOME が設定されている場合はそれをメモリベースとして解決し、設定されていない場合はデフォルトで ~/.codex を使用します。 以下の場所を使用します:

   • メモリインデックス: $CODEX_HOME/memories/MEMORY.md または ~/.codex/memories/MEMORY.md
   • ロールアウトサマリー: $CODEX_HOME/memories/rollout_summaries/
   • raw セッション: $CODEX_HOME/sessions/ または ~/.codex/sessions/

3. この順序でプロジェクトの過去のセッションを読みます。 ランタイムプロンプトにメモリサマリーが既に含まれている場合、そこから開始します。 次に MEMORY.md で以下を検索します:

   • リポジトリ名
   • リポジトリベース名
   • 現在の cwd
   • 重要なモジュールまたはファイル名 最初に最も関連する 1-3 個のロールアウトサマリーのみを開きます。 サマリーに必要な正確な証拠がない場合のみ、raw セッション JSONL にフォールバックします。

4. 新しいものを提案する前に、既存のプロジェクトローカルスキルをスキャンします。 現在のリポジトリルートを基準に以下の場所をチェックします:

   • .agents/skills
   • .codex/skills
   • skills SKILL.md と agents/openai.yaml の両方が存在する場合はそれらを読みます。

5. プロジェクトローカルスキルを反復的な作業と比較します。 過去のセッションで繰り返されるパターンを探します:

   • 繰り返される検証シーケンス
   • 繰り返される障害シールド
   • 繰り返される所有権の境界
   • 繰り返されるルート原因カテゴリー
   • 繰り返してリポジトリ固有のコンテキストが必要なワークフロー パターンが繰り返し出現し、既に十分にキャプチャされていない場合、それはスキル候補です。

6. 新しいスキル と 既存スキルの更新 を分離します。 既存のスキルが既に正しいカテゴリーであるが、古いトリガー、不足している保護メカニズム、古いパス、弱い検証命令、または不完全なスコープを持っている場合は、更新を推奨します。 ワークフローが十分に異なり、既存のスキルを拡張するとあいまいまたは混乱を招く場合のみ、新しいスキルを推奨します。

7. プロジェクトローカルスキルをレビューした後でのみグローバルスキルとの重複をチェックします。 $CODEX_HOME/skills と $CODEX_HOME/skills/public を使用して、一般的な共有スキルで既に解決されているワークフローのプロジェクトローカルスキルを提案することを避けます。 グローバルスキルが存在するという理由だけでプロジェクトローカルスキルを却下しないでください。プロジェクト固有の保護メカニズムは依然としてローカル特化を正当化できます。

セッション分析

1. メモリインデックスを最初に検索

• rg を使用してリポジトリ名、ベース名、cwd で MEMORY.md を検索します。
• 既に同じリポジトリパスのロールアウトサマリーを引用するエントリを優先します。
• キャプチャします:
  • 繰り返されるワークフロー
  • 検証コマンド
  • 障害シールド
  • 所有権の境界
  • マイルストーンまたはロードマップの結合

2. ターゲットされたロールアウトサマリーを開く

• memories/rollout_summaries/ の最も関連するサマリーファイルを開きます。
• ファイル名、cwd、または keywords が現在のプロジェクトと一致するサマリーを優先します。
• 以下を抽出します:
  • ユーザーが繰り返し要求したもの
  • 何度も繰り返されるステップ
  • 何度も壊れたもの
  • 正確性が証明されたコマンド
  • 再発見が必要だったプロジェクト固有のコンテキスト

3. raw セッションはフォールバックのみとして使用

• ロールアウトサマリーに具体的な詳細が不足している場合のみ、sessions/ JSONL ファイルを検索します。
• 以下で検索します:
  • 正確な cwd
  • リポジトリベース名
  • ロールアウトサマリーのスレッド ID
  • 特定のファイルパスまたはコマンド
• raw セッションを使用して正確なプロンプト、コマンドシーケンス、diff、または障害テキストを復元し、サマリーパスの代替ではなく。

4. セッション証拠をスキル候補に変換

• 候補 新しいスキル は、繰り返されるトピックだけではなく、繰り返されるワークフローに対応する必要があります。
• 候補 スキル更新 は、トリガー、保護メカニズム、または検証命令が記録されたセッションと一致しなくなったローカルスキルで既にカバーされているワークフローに対応する必要があります。
• 以下のような具体的な証拠を優先します:
  • 「この検証シーケンスは 4 つのセッションに出現した」
  • 「この所有権の混乱はエクストラクタとランタイム修正にわたって繰り返された」
  • 「同じローカルスクリプトとテレメトリプローブを何度も再発見する必要があった」

推奨ルール

新しいスキルを推奨する場合:

• 同じリポジトリ固有のワークフローまたは障害モードが複数のセッションに複数回出現する
• 成功はプロジェクト固有のパス、スクリプト、所有権ルール、または検証ステップに依存する
• ワークフローは強力なデフォルトまたは障害シールドから利益を得る

更新を推奨する場合:

• 既存のプロジェクトローカルスキルが既にニーズのほとんどをカバーしている
• SKILL.md と agents/openai.yaml が相互にドリフトしている
• パス、スクリプト、検証コマンド、またはマイルストーン参照が古い
• スキルボディが、プロジェクトが実際にどのように作業されているかを反映するには一般的すぎる

スキルを推奨しない場合:

• パターンが再利用可能なワークフローではなく単なる一度限りのバグである
• 一般的なグローバルスキルが既に有意義なプロジェクト固有の追加なしでフィットする
• ワークフローが保守コストを正当化するほど十分に繰り返されていない

スキャン内容

• 過去のセッションとメモリ:

  • コンテキストに既にある場合はメモリサマリー
  • $CODEX_HOME/memories/MEMORY.md または ~/.codex/memories/MEMORY.md
  • 現在のリポジトリの最も関連する 1-3 個のロールアウトサマリー
  • サマリーが不十分な場合のみ raw $CODEX_HOME/sessions または ~/.codex/sessions JSONL ファイル

• プロジェクトローカルスキルの表面:

  • ./.agents/skills/*/SKILL.md
  • ./.agents/skills/*/agents/openai.yaml
  • ./.codex/skills/*/SKILL.md
  • ./skills/*/SKILL.md

• プロジェクト慣例:

  • AGENTS.md
  • README.md
  • ロードマップ、台帳、アーキテクチャ、または検証ドキュメント
  • コンテキストに必要な場合、現在のワークツリーまたは最近触れられた領域

出力期待値

以下を含むコンパクトな監査を返します:

1. 既存のスキル 見つかったプロジェクトローカルスキルと各スキルがカバーする主なワークフローをリストします。

2. 推奨される更新 各更新候補について以下を含めます:

   • スキル名
   • なぜそれが不完全または古いのか
   • 実行する最も価値の高い変更

3. 推奨される新しいスキル 各新しいスキルについて以下を含めます:

   • 推奨されるスキル名
   • なぜそれが存在する必要があるのか
   • それをトリガーするもの
   • エンコードする必要があるコアワークフロー

4. 優先順位順 予想される価値によって最上位の推奨をランク付けします。

ネーミングガイダンス

• 短いハイフン区切りの名前を優先します。
• 明確性を改善する場合、プロジェクトローカルスキルのプロジェクトプリフィックスを使用します。
• 曖昧な名詞よりも動詞主導またはアクション指向の名前を優先します。

障害シールド

• セッションまたはリポジトリ証拠なしに繰り返されるパターンを発明しないでください。
• 既存のスキルへの更新で十分な場合は重複スキルを推奨しないでください。
• 現在のリポジトリが以降進化していることが明らかな場合は、単一のメモリノートに依存しないでください。
• すべてのロールアウトサマリーを一括ロードしないでください。ターゲット化を保ちます。
• サマリーが不十分な場合を除き、ロールアウトサマリーをスキップして raw セッションにジャンプしないでください。
• テーマだけからはスキルを推奨しないでください。推奨は繰り返される手順、繰り返される検証フロー、または繰り返される障害モードから来るべきです。
• プロジェクトの現在の実装タスクとその再利用可能なスキルのニーズを混同しないでください。

フォローアップ

ユーザーが推奨されたスキルの 1 つを実際に作成または更新するよう求める場合、$skill-creator に切り替えて、監査を続けるのではなく選択されたスキルを実装します。