autogoal について
Autogoalは、エージェントのワークフローで明示された目標や長期目標を管理するスキルです。目標や計画の再利用、一時停止と再開、証拠の記録、完了条件を定めます。
主な機能
- 01明示的な目標と通常タスクの区別
- 02既存の目標と計画の再利用
- 03一時停止と再開の手順
- 04義務と証拠の追跡
- 05完了条件とブロック規則
活用シーン
- 01複数段階の監査や移行の管理
- 02長期作業の一時停止と再開
- 03完了までの受け入れ証拠の追跡
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ udecode/ dotai --skill autogoalインストール後、Claude Code で/autogoalを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
README.mdassets/templates/docs.mdgoal-repair.mdgoal.mdmajor-task.mdtask.mdassets/templates/packs/agent-native.mdbrowser.mddocs.mdpackage-api.mdperformance-observability.mdreferences/method.mdplans.mdscripts/check-complete.mjscreate-goal-scratchpad.mjscreate-goal-scratchpad.test.mjscreate-goal-template.mjsinit-templates.mjs詳細
Autogoal
ユーザーが目標を明示的に要求した場合は、直接の要求であるか、現在の依頼に適用される継続的な指示によるものであるかを問わず、ネイティブの goal ツールを使用してください。その指示を適用し、再度確認したり、別途スキルの実行を求めたりしないでください。そのような要求がない場合、通常のタスク、計画、監査、測定可能な成果だけでは create_goal の使用は許可されません。
継続的な要求
プロジェクトまたは現在の会話に、長期にわたる作業では既定で Autogoal を使用するというユーザーの要求が記録されている場合があります。その正確な適用範囲に従ってください。長期にわたる作業とは、大規模な監査、複数のギャップを埋める実装、移行、継続的な調査など、複数の実行・調査・検証のチェックポイントと受け入れ台帳を伴う、相応の規模の目標を指します。あらゆる質問、小規模な編集、時間のかかるコマンド、時間制限のあるタスクが該当するわけではありません。分数やトークン数による基準を独自に設定する必要はありません。
この継続的な要求が適用される場合は、長時間の作業に入る前に目標を開始するか、既存の目標を再利用してください。最初は小規模だった作業が該当する規模に拡大した場合は、その時点で要求を適用してください。「目標は不要」など、明示的なオプトアウトがあればそちらを優先します。読み取り専用、計画のみ、人間への割り当て、公開に関する制約は変更しないでください。目標の完了基準は、実際に要求された成果で終わるようにしてください。スキルの説明や編集は、そのスキルの実行にはあたりません。ただし、その作業自体が継続的な要求の対象となる場合はあります。
一時停止と再開
「一時停止」「停止」「保留」という明示的な指示があった場合は、既存の計画をただちに Status: Paused にし、ユーザーの指示を記録し、未完了の義務と保存済みの次の手順を維持したうえで、ユーザーから明示的に再開の指示があるまで、現在の次のアクションを待機状態にしてください。スキルやタスク履歴の修復など、依頼された別作業に取りかかる前に行ってください。口頭での了承や非公開のメモだけでは、計画を一時停止したことにはなりません。
現在の仕様で許可されている場合に限り、サポートされているネイティブの一時停止機能を使用し、その結果を検証してください。利用できる機能がない場合は、その制約を同じ計画に記録し、ユーザーには一度だけ伝えてください。ネイティブの目標が一時停止されたと偽ったり、完了またはブロック状態を装ったり、目標の内部ストレージを変更したりしてはいけません。そのターンは速やかに終了してください。スリープやポーリングのループ、繰り返しのリマインダー、一時停止を管理するための別の目標を作成してはいけません。
自動継続または復旧の際は、作業を選択する前に計画の一時停止状態を確認してください。スケジューラーによる継続は、ユーザーからの直接の再開指示ではありません。一時停止中の作業は停止したままにしてください。明示的に依頼された修復は、その範囲内で実行できます。ユーザーから直接指示があった場合に限り再開し、その後、既存の計画を更新して、保存済みの次の手順を再検証してください。一時停止の処理を参照してください。
1つの目標と計画
長期にわたる作業では、実行中、中断中、コンテキスト圧縮後も、適用される要件を維持する必要があります。既存の計画またはリンクされた正規の台帳に、各義務を重複なく、その出典、証拠、未解決状態とともに記録してください。詳細な項目を複製せず、参照してください。複数の成果がある場合は、範囲を限定したバッチ処理と証拠の再利用を使用してください。受け入れ項目は、個別の実行サイクルではありません。判断に該当する場合に限り、手法を読み込んでください。参照があるだけで、新たな義務が生じることはありません。受付、重要なチェックポイント、再開、終了の際には、チェックリストの保持に従ってください。短時間の作業では、新しい目標や計画を作成せず、要件を直接確認してください。
新しい目標を作成する前に、既存の目標を確認してください。現在の計画と目標を再利用し、競合するライフサイクル状態を作成してはいけません。トークン予算を設定するのは、明示的に要求された場合に限ります。実際の成果、範囲、完了基準、証拠、実際の阻害要因を1つの計画に記録してください。 ファイルヘルパーは通常のプランにも使用できます。その歴史的な名前がネイティブのゴールを作成することはありません:
node .agents/skills/autogoal/scripts/create-goal-scratchpad.mjs --template task --title "<title>" [--with <pack>] [--ticket <id>]node .agents/skills/autogoal/scripts/create-goal-template.mjs --skill <name> --from <template>node .agents/skills/autogoal/scripts/check-complete.mjs docs/plans/<plan>.mdnode .agents/skills/autogoal/scripts/init-templates.mjsは、明示的なテンプレート初期化が必要な場合にのみ使用します。
プロジェクトテンプレートは共有の組み込みテンプレートを上書きします。作成時はフラグ、パス、上書きしない動作を維持し、無関係なテンプレートを自動的にシードすることはありません。有用なパックのみを選択してください。コンパクトなプランは、目的、しきい値、検証サーフェス、制約、境界、ブロック条件、チェックリスト、エビデンス、リスク、次のアクションを保持します。必須のゲート/フェーズ/再起動テーブルや信頼度のパーセンテージはありません。
複数の担当者が関与する作業では、メソッドの適格な担当者の走査と人的支援キューに従ってください。エビデンスに基づく手動の前提条件は直ちに先送りしてください。不明確なツール/アクセスの診断は、十分な情報に基づく 2 回の試行または 10 分間のいずれか早い方に制限してください。先送りは継続をまたいで維持し、イテレーションの会計とゴール全体の完了を分けて扱ってください。
リポジトリの証明と公開の担当者に従ってください。ファイルチェッカーの合格は、記録された義務が解決されたことを証明しますが、実行時、デプロイ済み、または外部の証明を捏造することはできません。ゴールを完了とマークする前に、リンクされた子プランや該当するリリース義務を含め、すべての必須の受け入れ項目を完了してください。
実際のゴールツールのステータスルールに従ってください。ブロック済みとマークするのは、必須の反復ブロックしきい値を満たし、かつ有用な進捗を生み出せない場合に限られます。予算の枯渇や難易度はブロッカーではありません。ユーザーがブロックされたゴールを再開した場合は、ツールの新規ブロック監査を適用してください。単に停止するために完了とマークしないでください。予算付きのゴールが完了した際は、最終的なトークン使用量を報告してください。
ゴールが存在するというだけで、メモリを書き込んだり、公開したり、他者にメッセージを送ったり、定期的な自動化を作成したりしないでください。
該当する状況が発生した場合にのみ、該当するメソッドのセクションを読んでください:
- 既存のゴールが要求された目的と異なる場合: アクティブゴールの競合。
- 新しい目的の定義または不確実な証明: ゴールの構造、測定可能な成果、エビデンスの種類。
- 壊れたゴール状態またはプラン/ヘルパー契約の修復: 修復モード。
- 一時停止または復旧: 一時停止の処理、再開プロトコル。
- 複数の担当者または手動の前提条件: バウンド付きバッチ。
- プランの作成、パックの選択、または要求されたプランニングモード/制限時間の解釈: プランの選択。独立した子プランには、リンクされたプランツリーを使用してください。
- 受け入れのクローズまたは反復ブロッカーの宣言: 完了ルール、ブロックルール。
- リサーチの成果: リサーチゴール。
例と完全な手順はそこに引き続き用意されています。通常のチェックポイントで参照資料全体を読み直す必要はありません。