Communitygithub.com

RayShark/codex-goal-writer

Codexスキル。検証可能な /goal コマンドをドラフトします。

codex-goal-writer とは?

このスキルは、Codexエージェント向けに、検証可能で自己完結した `/goal` コマンドを生成するためのプロンプトテンプレートと決定フローを提供します。フラグメントな会話の記憶に依存せず、将来のCodexスレッドがそのまま実行できる形式でコマンドを作成します。スキルは、既存の計画文書がある場合、有用な会話コンテキストがある場合、まったくコンテキストがない場合の3つのシナリオに応じた出力形状とルールを定義しており、常に具体性、検証可能性、有限性を保証します。出力は常にアプリオリにコピー可能な状態で提供され、プレースホルダーや曖昧な表現は禁止され、品質ゲートによる厳格なチェックが行われます。このスキルは、Codex CLIやVSCode拡張などのCodex環境向けの `/goal` 機能を使用するすべての開発者を対象としており、AIエージェントによるタスク実行の信頼性と再現性を大幅に向上させます。

対応~Claude Code✓Codex CLI~Cursor
npx skills add RayShark/codex-goal-writer

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Codex Goal Writer

将来のCodexスレッドが、断片的な会話の記憶に依存せずに実行できる、コピー可能なCodex /goal コマンドを1つ作成します。ユーザーから明示的に依頼がない限り、ゴールの実行や実装を開始しないでください。

出力契約

デフォルトの出力:

  1. 前提条件:最大5個の箇条書き。前提条件が重要でない限り省略可。
  2. コピー準備完了:正確に1つの /goal ... コマンドを含む、コードフェンスで囲まれたブロックが1つ。
  3. 注記:主要な設計上の判断や残存リスクを説明する、最大3個の箇条書き。

ユーザーがコマンドのみを要求した場合は、コードフェンスで囲まれたブロックのみを出力します。

コマンドの接頭辞は /goal でなければなりません。本文はユーザーの言語を使用して構いません。

公式制約

  • /goal テキストを開始プロンプトと完了基準の両方として扱います。
  • 目的は空でなく、4,000文字未満に保ちます。
  • 長い指示の場合は、markdownファイルを作成または参照し、/goal は短く保ちます。
  • /goal が利用できない場合は、[features].goals = true の有効化または codex features enable goals について言及します。
  • /goal --tokens のような、サポートされていないスラッシュフラグを発明しないでください。予算が有用な場合は、テキストによる停止条件または一時停止条件として表現してください。

決定フロー

1. 既存の計画またはMarkdown計画

計画、PRD、Issue、OpenSpec/OSpecの変更、PLAN.md、GOAL.md、tasks.md、または実装文書が言及または明らかな場合、このパスを使用します。

ルール:

  • コマンドに正確なパスを含めます。できればリポジトリ相対パスで指定します。
  • Codexに、まず計画を読み、それを真実の情報源として扱うように指示します。
  • 忘却防止の句を追加します:コンテキスト圧縮、再開、または不確実性の後、続行する前にパスを再読み込みする。
  • ユーザーが計画の一部のみを要求した場合は、そのスライスを含めます。
  • 詳細なタスクリストは /goal テキスト内ではなく、ファイル内に保持します。

形式:

/goal 真実の情報源として、<パス>にある実装計画を実行してください。ファイルを変更する前にそれを読み、コンテキスト圧縮、再開、または不確実性の後にそれを再読み込みしてください。<計画の全体またはスライス>を完了し、<制約>を維持し、<チェック/証拠>で検証し、<ブロック条件>の場合はブロッカーレポートを添えて停止してください。

2. 有用な会話コンテキスト

以前のターンがタスクを定義している場合、このパスを使用します。

ルール:

  • 最新のユーザー指示が古いコンテキストよりも優先されます。
  • 明示的な制約を維持します:読み取り専用、編集禁止、コミット禁止、特定のファイル、新しい依存関係禁止、必須テスト、レビューのみ、言語、出力形式。
  • 既知の場合は、正確なファイルパス、コマンド、Issue ID、PRリンク、アーティファクトパスを含めます。
  • 最新のリクエストと競合する古い指示は無視します。

形式:

/goal <最新の意図された成果>。現在の会話は背景情報としてのみ使用してください。範囲: <ファイル/サブシステム>。制約: <維持すべきもの>。完了条件: <検証可能な基準>。検証方法: <コマンド/証拠>。停止条件: <ブロック条件>。

3. 有用なコンテキストなし

ユーザーがゴールを要求したが、具体的なタスクを提供していない場合、このパスを使用します。

ルール:

  • 軽量な発見のみを行います:カレントディレクトリ、リポジトリ名、README*、AGENTS.md、CONTEXT.md、明らかな計画書、パッケージマニフェスト、テストスクリプト。
  • 製品の方向性を発明しないでください。
  • 発見ファーストで、小さな閉じたループの目的を生成します。
  • 「プロジェクト全体を最適化する」よりも、「発見 -> 最も価値の高い1つの狭い問題を選択 -> 修正または文書化 -> 検証」を優先します。
  • リポジトリや安全なターゲットがまったくない場合は、1つの簡潔な質問をするか、リポジトリに依存しない発見ゴールを出力します。

形式:

/goal <パス>内で、現在のプロジェクトの状態を調査し、ローカルで検証可能な、最も価値の高い小さなアクション可能な問題または最適化の機会を特定し、1つの保守的な閉じたループの改善を完了し、無関係な作業を維持し、関連する発見されたチェックで検証し、証拠と残りのフォローアップを報告してください。安全な検証可能なターゲットが見つからないか、必要なコンテキストが不足している場合は停止してください。

ゴールの構成要素

すべての強力なゴールには、これらのアイデアをコンパクトなラベルを使用して含める必要があります:

  • 目的(Objective): 活動ではなく、具体的な最終状態。
  • 範囲(Scope): ファイル、フォルダ、サブシステム、Issue、計画パス、または発見エリア。
  • 制約(Constraints): 変更してはならないもの。
  • 境界(Boundaries): 許可される書き込み、禁止されるパス、外部サービス、本番データ、認証情報、または破壊的操作。
  • 完了条件(Done when): 測定可能な受け入れ基準。
  • 検証(Verification): コマンド、ログ、アーティファクト、スクリーンショット、ベンチマークしきい値、CIチェック、またはソースに基づく引用。
  • 反復ポリシー(Iteration policy): 失敗への対処方法、集中的な改善ラウンドの回数、再チェックのタイミング。
  • 停止/一時停止条件(Stop/Pause if): 具体的なブロッカー、競合する要件、不足する認証情報、安全でないスコープ拡大、利用できない環境、繰り返される検証失敗、または人間の判断。
  • 出力証拠(Output evidence): 最終サマリーには、変更内容、証拠、実行したコマンド、失敗、残存リスク、次のステップを含める必要があります。

調査のみのゴールの場合は、主張と証拠のマッピング、ファイル/URLの引用、不確実性ラベルを要求し、明示的に許可されない限りコード編集は禁止します。

品質ゲート

コマンドを表示する前に:

  • 新しいCodexセッションが隠れたコンテキストなしで実行できることを確認します。
  • 最新のユーザーの意図が表現されていることを確認します。
  • 利用可能な場合は、計画/文書のパスが含まれていることを確認します。
  • ゴールが有限で監査可能であることを確認します。
  • 「改善」「最適化」「クリーンアップ」「全部」「徹底」「everything」「make it good」などの曖昧な用語を、測定可能な基準に置き換えるか、前提条件を明記します。
  • 既知の場合は正確なコマンドを使用し、それ以外の場合は「リポジトリの関連する文書化されたチェックを発見して実行する」とします。
  • コピー可能な最終出力に <パス>、[TODO]、TBD、待定 などのプレースホルダーを残さないでください。
  • ユーザーが明示的に要求し、リスクが低い場合を除き、「すべてを編集」などの広範な権限を許可しないでください。
  • 予算の枯渇、経過時間、または明らかなエラーの欠如から成功を主張しないでください。

ゴールが弱い場合は、最大3つの的を絞った質問をしてください。不足している詳細がリスクの低いものであれば、前提条件を仮定して進めてください。

参考資料とツール

  • ケースが曖昧な場合やユーザーがバリエーションを希望する場合は、references/examples.md を読んでください。
  • 設計の根拠を説明したり、実践方法を比較する場合は、references/source-patterns.md を読んでください。
  • 保存されたゴールファイルを監査する場合や、ドラフトしたコマンドを安価に検証できる場合は、scripts/lint_goal_command.py を使用してください。

関連スキル