Communitygithub.com

AFK (自動進行)

このスキルは、ユーザーが/afkを呼び出したとき、またはGracieポートフォリオサイトを人間の介入なしに完了まで自動駆動したいときに使用します。準備ができたチケットを次々と(独立したものは並列化して)すべて出荷し終えるまで処理を続けます。

AFK (自動進行) とは?

このスキルは、Gracieポートフォリオサイトを単一セッションで完全に完了するまで自動的に進める「AFK(自動進行)」スキルです。一度に人間の入力を必要としない全てのチケット(フロンティア)を見つけ、それぞれを「Done」状態まで出荷し、結果を統合するラウンドを繰り返します。各チケットは独立しており並列処理が可能なため、サブエージェントに同時に割り当てることができ、効率的に作業を進めます。手動テストはプロジェクト全体のガイドに対して最後に一度だけ行います。Claude Code、Cursor、Codexなど標準的なエージェントツール向けに設計されており、.gracie-vault/のディレクトリ構造を用いてチケット管理と知識統合を行います。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jaidetree/gracieanimator/tree/HEAD/.claude/skills/afk

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

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

ドキュメント

AFK (自動進行) は何をしますか?

Gracieポートフォリオサイトを一度のセッションで完了まで駆動します。「人間の入力を必要としない」(フロンティア) チケットを繰り返し見つけ、それぞれを Done へと出荷し、結果を統合します。これをラウンドごとに繰り返し、チケットがなくなるまで続けます。手動テストはプロジェクト全体のガイドに対して最後に一度だけ行い、チケットごとには行いません。

フロンティア

チケットは、ready-for-agent タグを持ち、すべての blocked_by が .../Done/ 内のファイルに解決されている場合にフロンティアとなります。.gracie-vault/Projects/gracie-portfolio/issues/Ready/ から計算します。Ready/ にフロンティア対象のチケットがない場合のみ、Backlog/ から計算します。フロンティアチケットは人間からの入力を一切必要としません。互いにブロックしないため、サブエージェントに並列で安全に渡せるチケットです。

ステップ

  1. 知識サマリーを読む: scan-knowledge.sh .gracie-vault/Knowledge (knowledge スキルから)。最も関連性の高いポイントを表面化します。
  2. フロンティアを計算する(上記参照): Ready/ を最初に、Ready/ にフロンティア対象チケットがない場合は Backlog/ を使用します。
  3. フロンティアが空?
    • Backlog/ に ready-for-agent タグのないチケットがある場合: それらは /triage が必要です。数を報告して停止します。
    • Backlog/ も空(または残っているチケットがすべてブロックされている): プロジェクトは完了です — ステップ8にスキップします。
  4. 全フロンティアを1つのメッセージでディスパッチ — チケットごとに1つのサブエージェント、各サブエージェントは isolation: worktree を使用します。フロンティアチケットは互いにブロックしないため、並列ディスパッチは安全です。各サブエージェントに、自身の隔離されたコピー内で以下を実行するよう指示します:
    1. /slice <ticket> をエンドツーエンドで実行 — これによりチケットが Review を通過し、現在成立している受け入れ基準をチェックします。
    2. /slice が人間のために停止する箇所では、代わりにループを閉じます: チケットの受け入れ基準を差分と照らし合わせて再読み込みします。すべてのチェックボックスがチェックされ、make build/make lint、make test が green であることが、ここでの人間のレビューに代わるものです。チケットを Review → Done に移動し、その移動をコミットします。
    3. チケット名、最終状態(Done、またはチェックアウトできなかった場合は Review に残った理由)、および /slice が生成した手動テスト手順を返します。
  5. 統合: 各サブエージェントが報告してきたら、ディスパッチ順に1チケットずつ統合します: サブエージェントのワークツリーブランチ(コミットと Done 移動を含む)をマージし、統合ブランチで make build/make lint を再実行し、次に make test を実行して、組み合わせたときにのみ現れる問題を検出します。競合は resolving-merge-conflicts スキルで解決し、決して --abort は使用しません。マージ後、ワークツリーを削除します。報告された手動テスト手順を、チケットをキーとした実行中のプロジェクト全体のリストに追加します。
  6. 停滞チケット。 Review に残ったチケット — 受け入れ基準がチェックアウトできなかった、サブエージェントが修正できなかった検証の失敗、またはスライス中に HITL ブロッカーに遭遇した場合 — は停滞チケットであり、このラウンドでの再試行対象ではありません。そのままにし、理由とともに実行中の停滞チケットリストに追加し、先に進みます。差分が失われないよう、ステップ5でマージは行われます。
  7. フロンティアを再計算します — Done/ にマージされたチケットが他のチケットのブロックを解除する可能性があります — そしてステップ4に戻ります。
  8. 手動テストガイドを作成します。 1つのファイル、.gracie-vault/Projects/gracie-portfolio/MANUAL-TESTING.md: Done チケットごとに1セクション(名前、リンク、収集した手順)と、チケットが関連するサーフェスに触れている場合はプロジェクト全体の短いエンドツーエンドパスを含めます。これが人間の唯一の手動テストエントリポイントです — チケットごとのテストはありません。コミットし、その後報告します: すべて Done に出荷済み、停滞チケットリスト、およびガイドへのポインタ。

関連スキル