mcpField
G
goal-framing

goal-framing

github.com/ganyuanranエージェントワークフロー1.4k52 回インストール3 日前に更新
リポジトリ

goal-framing について

goal-framing は、作業開始前に目標と境界を簡潔に整理する、オプトインの Aegis スキルです。成功の証拠、停止条件、範囲、非目標を明確にしたいタスクに向き、その後の作業を適切なワークフローへ導きます。

主な機能

  1. 01簡潔なタスク意図フレームの作成
  2. 02成功の証拠と停止条件の定義
  3. 03範囲、制約、非目標の記録
  4. 04目標フレームに基づくワークフロー選択
  5. 05委任用コンテキストパケットの作成
  6. 06目標と範囲の変更の追跡

活用シーン

  1. 01複数段階のタスク開始前に境界を設定
  2. 02タスクの完了条件を明確化
  3. 03実装前に対象外の事項を定義
  4. 04サブエージェントへ簡潔なタスク背景を共有

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/ganyuanran/aegis --skill goal-framing

インストール後、Claude Code で/goal-framingを入力して読み込まれたか確認します。

詳細

Aegis Goal Framing

実行前に簡潔な目標フレームを作成するには、このスキルを使用します。これは任意で、境界を設定することのみを目的とします。

ユーザーが明示的に /aegis-goal または Aegis goal: を指定しない限り、簡単な編集、1 コマンドで済む確認、通常の迅速な Q&A には使用しないでください。

権限の境界

現在の担当範囲:

  • Method Pack のタスクフレーミング

ここでは担当しないこと:

  • 権威ある GateDecision
  • 最終的なエビデンスの十分性
  • 最終的な完了判断の権限
  • ホストデーモン/自動停止の強制

入力形式

以下は同等の入力として扱います。

  • /aegis-goal <task description>
  • Aegis goal: <task description>
  • 「開始前に目標/停止条件を定義する」

スラッシュコマンドは、ホスト側で使える任意のショートカットです。自然言語形式は、どこでも使える代替手段です。

例:

Aegis goal: Fix the auth refresh bug without rewriting the auth system.

出力

最小限で役立つフレームを作成し、同じターン内にルーティングされたワークフローへ進みます。

TaskIntentDraft:
- Requested outcome:
- Goal:
- Success evidence:
- Stop condition:
- Non-goals:
- Constraints:
- Scope:
- Risk hints:
- Aegis Visibility:
- Route:
- Next:

デフォルトの動作:

  • TaskIntentDraft の後で止まらないでください。
  • フレームは最終回答ではなく、実行開始のプロトコルとして扱います。
  • ユーザーが作業の実行を依頼した場合は、簡潔なフレームの提示後、選択したルートの Next アクションに直ちに進みます。
  • 目標が明確な場合は、ユーザーに見せるフレームを自然で短いものにします。ユーザーが正式なフレームを求めていない限り、内部向けに見える大きなカードを出力しないでください。
  • 目標フレームによってルート、停止条件、または対象外の事項が制約される理由を伝えるには、Aegis Visibility を使用します。ユーザーが監査可能性を明示的に求めない限り、トレースに関する形式的な手順を追加しないでください。

フレームのみを作成する場合の動作:

  • ユーザーが目標の定義のみ、停止条件の定義のみを明示的に求めた場合、または実行しない、実装しない、計画を作成しない、続行前に確認を待つよう求めた場合に限り、フレームの提示で終了します。
  • 必要な情報が不足している場合は、不足している入力を示し、続行するふりをせず blocked の状態で終了します。

停止条件では、次の状態を区別します。

状態の一覧:done、blocked、needs-verification、scope-exceeded。

  • done:成功を示すエビデンスが満たされています
  • blocked:必要な依存関係、権限、または情報が不足しています
  • needs-verification:実装は存在しますが、エビデンスが不十分です
  • scope-exceeded:続行すると目標または対象外の範囲を超えます

ルーティング

フレーミングの後:

  • リスクが低く、担当者が一人の作業は、通常の迅速な手順または TDD で続行します
  • 曖昧なプロダクト/アーキテクチャ/契約に関する作業は brainstorming にルーティングします
  • 承認済みの要件は writing-plans にルーティングします
  • 複数ステップにわたる作業、コンテキスト圧縮の影響を受けやすい作業、引き継ぎ、またはサブエージェントを使う作業は long-task-continuation にルーティングします
  • バグの診断は systematic-debugging にルーティングします
ルートマトリクス
目標の兆候ルート
担当者が一人、低リスク、検証方法が明確迅速な手順または test-driven-development
バグ、失敗、リグレッション、予期しない動作systematic-debugging
曖昧なプロダクト、アーキテクチャ、契約、モジュール間の動作brainstorming
承認済みの仕様、安定した要件、実装の分割writing-plans
複数ステップにわたる作業、コンテキスト圧縮の影響を受けやすい作業、引き継ぎ、サブエージェントを使う作業long-task-continuation
完了、リリース、引き継ぎ、「これは完了していますか?」verification-before-completion

ルーティングされたワークフローで永続的なエビデンスが必要な場合に限り、docs/aegis/ の記録を作成します。目標のフレーミングだけでは、プロジェクトファイルは作成しません。

サブエージェント向けコンテキストパケット

作業を委任する際は、会話全体ではなく、簡潔なパケットを渡します。

SubagentContextPacket:
- Task:
- Goal:
- Stop condition:
- Relevant baseline refs:
- Relevant files:
- Known facts:
- Unknowns:
- Non-goals:
- Expected output:
- Verification expected:
- Must-read excerpts:
- Unsafe assumptions:

このパケットはファイルの重複読み込みを減らしますが、エビデンスの代わりにはなりません。サブエージェントも、重要な事実を検証するために必要な最小限の生ファイル/ログ/テストの抜粋を読む必要があります。

会話の全トランスクリプト、セッション履歴の全体、または範囲に上限のないログをパケットに貼り付けないでください。重要な事実は、ファイル参照、行または範囲のヒント、あるいは必読の簡潔な抜粋を含めてください。

逸脱時のルール

タスクの途中で目標が変わった場合、黙って上書きしないでください。以前の目標、新しい目標、変更された範囲、新たなリスクを記録し、長期タスクの記録が存在する場合は DriftCheckDraft を経由してください。

コメント