handoff-bridge

English | 日本語

handoff-bridge は、コーディングエージェントの元セッションから、次のセッションが迷わず再開できる必要十分な引き継ぎ Markdown を作る skill です。

全文ログを複製するのではなく、目的、現在地、採用済みの判断、次の行動、未解決事項、正本への参照を選びます。引き継ぎは生成時点の派生物として扱い、常に参照先の正本を優先します。

インストール

プロジェクトのルートで、利用するエージェントを1つ指定します。

npx handoff-bridge@latest --codex
npx handoff-bridge@latest --claude

別のプロジェクトへ入れる場合はパスを末尾に指定します。

npx handoff-bridge@latest --codex /path/to/project

配置先は次のとおりです。

| エージェント | 配置先 | |---|---| | Codex | .agents/skills/handoff-bridge/ | | Claude | .claude/skills/handoff-bridge/ |

このインストーラーはモデルを実行せず、API key や Claude Subscription の認証も使いません。npx が npm package を取得する通信だけが発生し得ます。

使い方

インストール後、エージェントへ次のように依頼します。

handoff-bridgeで次のセッションへの引き継ぎを作って。

保存先を明示しなければ、検証済みの Markdown を会話へ返すだけです。ファイルへ保存したい場合は、依頼の中で完全な保存先を指定してください。

ファイル保護

インストール前に全対象を確認します。

• 対象が無ければ新規作成します。
• 同じ内容の通常ファイルは変更せずスキップします。
• 内容が異なる既存ファイルが1つでもあれば、書き込み前に全体を中止します。
• 配置経路に symbolic link や通常ディレクトリ以外があれば中止します。
• 既存ファイルは上書きしません。

書き込み開始後に I/O error やプロセス停止が起きた場合、自動 rollback は行わず、新規ファイルの一部が残ることがあります。同じ内容は再実行時にスキップされるため、原因を直して再実行できます。

設計

詳しい考え方は 理論的背景 を参照してください。skill の実行契約は SKILL.md にあります。

開発と公開

npm test
npm run check:package

公開手順は scripts/PUBLISHING.md にあります。

License

MIT