handoff-skill

Handoffは、同じ作業が複数のAIエージェントセッションに引き継がれるリポジトリを対象としたエージェントスキルです。その課題定義として、リスト内で未チェックのまま放置されたタスクが必ずしも未完了とは限らない点が挙げられます。別のエージェントが実装を終えている場合や、コミットによって要件が満たされている場合、要件が変わっている場合、あるいは他の誰かが対象ファイルを依然として所有している場合があるためです。このスキルでは、共有の台帳ファイルであるHANDOFF.mdと、Gitの履歴、現在のコード、テスト、所有権などのリポジトリの証拠を組み合わせて、何が実際に未解決であるかを判断します。 記録されるワークフローには6つの段階があります。プリフライト（Preflight）では、セッション名を確保し、バージョン管理された1つのスナップショットから、すべてのオープンな台帳エントリ（ステップ、最近完了したエントリの概要、構造エラー、Gitの状態を含む）を返します。インテーク（Intake）では、各リクエストを日付入りのタスクエントリに変換します。これには、「進行中」と「完了」の個別のチェックボックス、ステップ、検証項目、ステータス行が含まれます。プログレッシブ監査（Progressive audit）では、後続の台帳エントリ、コミット、現在のソース、ライブの所有権、古いエントリのチェックボックスを比較衡量し、実質的なスコープを「完了」「部分的に完了」「置き換え済み」「未完了」「不明」に分類します。履歴を保持するため、削除ではなく注釈付けを行います。所有権解決（Ownership resolution）では、ユーザーがすでに明確な順序を指定していない限り、新しいタスクを開始する前に、適格な作業を最初に完了させるべきか、あるいは現在の所有者に任せるべきかを問い合せます。安全な書き込み（Safe writes）では、他のピアが同じツリーに書き込む可能性がある場合に備え、ロックされた比較演算（CAS）を介して更新をルーティングします。最後に、エージェントは明示的なパスをステージングし、検証内容とコミット識別子を記録し、次のエージェントが継続できる状態を残します。 台帳エントリには、所有者ラベル、オプションのハーネスフィールド（Claude Code、Codex、Cursor、VS Codeで自動検出し、環境変数で上書き可能）、状態ボックス、チェック済みおよび未チェックのステップ、ステータス行、次のアクションが記録されます。完了したタスクは両方のボックスがチェックされたままになり、台帳が履歴として機能します。セッションは、100人の神話上の人物のロースターから名前を請求します。これらは先着順で割り当てられ、台帳にすでに存在する所有者と重複することはありません。 このプロジェクトには、標準ライブラリによるPython CLIが付属しており、エージェントとタスク用のライブcursesダッシュボードを備えています。完了したタスク対総タスク数、進行中および保留中の数、ステップの進捗状況、そして記録されている場合は各所有者が使用したハーネスが表示されます。また、プレーンテキストのスナップショットモード、読み取り専用モード、またはバージョン固定されたインストールを解決するPATHランチャーの配下でも実行できます。ダッシュボードでは、タスクを切り取って別の所有者に貼り付ける機能がサポートされており、所有者ラベルの書き換えと、同一ロック下での移動の記録が行われます。ステータスバーのスクリプトは、1行の進捗行を出力し、Claude Code、Grok CLI、Kimi Codeのステータス行で動作することが文書化されています。Codexやその他のCLI向けにはtmuxラッパーが用意されています。 ローカルエージェントチャネルは、デーモンやソケットなしで、1つのチェックアウトにスコープされたgitignore対象のSQLiteファイルにメッセージと確認応答を保存します。エージェントは、質問の送信、返信、可用性の報告、未完了バケットの解放、リースに対する更新期限の宣言、および別のエージェントが応答していることを示すためのチャレンジ／アテスト（nonce交換）を行うことができます。インストールの提供形態としては、マーケットプレイスからのClaude Codeプラグイン、Cursorマーケットプレイスのインポート、または他のホスト向けのnpx skills addがあります。READMEには、Git、リポジトリの読み取り／編集アクセス権を持つエージェント、Python 3.9以上が必要であり、APIキー、ホステッドサービス、サードパーティのPythonパッケージは不要であると記載されています。外部に送信される唯一の機能は、設定ファイルが存在するまで非アクティブなままとなるオプトインのsshパブリッシュステップです。5つのスラッシュコマンドが、台帳の初期化、表示、ステータス、継続、パージをカバーしています。また、READMEには、cursesダッシュボードとステータスバーの高速パスに関するWindowsの制限事項が記載されています。