1仕組みと動作原理
完全なプロンプトオーケストレーション、コードゼロ:機能は完全にホストモデルによって実行されます(現在の会話の読み取り、要約、指示に従ったOS一時ディレクトリへのドキュメント書き込み)。ディレクトリ内にはSKILL.mdの主指示とagents/openai.yamlのメタデータ以外にスクリプト、テンプレート、参照ファイルは一切存在しません。
productivity/handoff/SKILL.md
Write a handoff document summarising the current conversation so a fresh agent can continue the work. Save to the temporary directory of the user's OS - not the current workspace.
全文でわずか5つの命令文で構成されています(cat -A によりコードブロックや隠しコンテンツがないことをバイト単位で確認済み)。'document summarising the current conversation' はホストモデルの要約能力に依存しており、スキル自体は振る舞いの制約のみを行います。
出力先規律:ユーザーのリポジトリやプロジェクトディレクトリへの混入を防ぐため、現在のワークスペースではなく意図的にOSの一時ディレクトリへ書き込みます。
productivity/handoff/SKILL.md
Save to the temporary directory of the user's OS - not the current workspace.
ここで行っていること:リポジトリ汚染を防ぐため出力の副作用を一時領域に隔離しています。ただしファイル名やサブパスは指定されておらず、ホストモデルの判断に委ねられます。
重複防止設計:既存の成果物(specs/plans/ADRs/issues/commits/diffs)についてはpathやURLを参照するのみでコンテンツを複製せず、ハンドオフを簡潔に保ちソース成果物との乖離を防ぎます。
productivity/handoff/SKILL.md
Do not duplicate content already captured in other artifacts (specs, plans, ADRs, issues, commits, diffs). Reference them by path or URL instead.
引き継ぎドキュメントは「コンテンツのスナップショット」ではなく「ポインタ集+要約」として位置付けられており、次のエージェントが必要に応じて元の成果物を再読み込みします。
パラメータ化されたカスタマイズ:ユーザーが入力したargument(argument-hint のプロンプト「What will the next session be used for?」)を次回セッションの用途説明として扱い、それに応じてドキュメントの重点を調整します。
productivity/handoff/SKILL.md
If the user passed arguments, treat them as a description of what the next session will focus on and tailor the doc accordingly.
argument-hint はフロントメタデータにホストへのトリガープロンプトとして現れるのみで、スキーマ制約はなく、argument は自由形式のテキストです。
デュアルエコシステムでの明示的トリガー:Claude側の disable-model-invocation: true、OpenAI側の allow_implicit_invocation: false の両方でモデルによる自動呼び出しを禁止しており、ユーザーが明示的に開始した場合のみ実行されます。
productivity/handoff/agents/openai.yaml
policy: allow_implicit_invocation: false
フロントマターにも 'disable-model-invocation: true' があります。引き継ぎはユーザーの明確な意図に基づく締め括りアクションであり、暗黙的なトリガーは行いません。
2コア機能
01現在の会話を新しいエージェントが引き継ぐためのハンドオフドキュメントに圧縮
02ドキュメントをOSの一時ディレクトリに書き込み、ワークスペースを回避
03次のエージェントが呼び出すべきSkillを示す「suggested skills」提案セクションの生成
04既存の成果物を複製せずpath/URLで参照
05機密情報のマスキング(APIキー/パスワード/PII)
06ユーザーのargumentに応じたドキュメントの重点カスタマイズ
4推奨統制措置と判定根拠
安全運用のための推奨統制措置
Agent 向け
作業ディレクトリを限定
管理者向け
操作ログを保持
判定根拠(ファイルパスと抜粋)
- 本地工作目录: ファイルの読み書きと成果物の出力: ハンドオフドキュメントがユーザーのOSの一時ディレクトリに書き込まれる(指示で明記: 'Save to the temporary directory of the use
監査ノート: スクリプトの実行なし、外部ネットワーク通信なし、認証情報の読み取りなし。唯一の振る舞い面はOSの一時ディレクトリへのドキュメント書き込み(ローカル書き込み、かつワークスペースは明示的に除外)であり、6段階分類基準では「ローカル読み書きのみ」に該当します。留意すべき点は、tempファイルが同じマシン上の他のプロセスから参照可能であることと、自動クリーンアップの指示がないことのみです。
5二重目の独立検証
- [ok] 外部依赖:无(external_deps 为空) — 第二遍逐词重扫两文件正文:无任何 CLI/API/网络端点/第三方包引用;唯一提及的 'Skill tool' 是宿主自身工具而非外部依赖
- [ok] 无脚本/无可执行代码 — find productivity/handoff -type f 仅返回 SKILL.md 与 agents/openai.yaml;cat -A 显示正文为 5 段纯文本,无代码围栏
- [ok] 文件写入:仅 OS 临时目录 — quote 'Save to the temporary directory of the user's OS - not the current workspace.' 逐字节核实;无其他写路径指令
- [ok] 无网络调用/凭证读取 — 正文无 curl/gh/API 字样;未引用任何 env/keychain/配置文件
- [ok] 触发方式:仅显式 — SKILL.md frontmatter 'disable-model-invocation: true' 与 openai.yaml 'allow_implicit_invocation: false' 两处独立证据一致
- [ok] 功能声明 vs 实际能力相符性 — description 'Compact the current conversation into a handoff document' 与正文指令一致;无夸大——能力边界即宿主模型的总结+写文件
- [ok] 元数据:license/stars/last_push — GitHub API:MIT、stargazers_count 253948、pushed_at 2026-09-04(与 pin commit 日期吻合)
6結論
最適な用途: セッション間やエージェント間で複雑な作業を引き継ぐ必要がある個人開発者(Matt Pocockスタイルのワークフローなど)、「次のエージェントへの引き継ぎ」を標準化したいチーム、引き継ぎドキュメントをリポジトリに入れず一時領域に残したいシナリオ。
不向きな用途: 固定の引き継ぎテンプレートや構造化スキーマを必要とするチーム(本スキルにはフォーマット制約がなく完全な自由形式テキスト)、引き継ぎの自動トリガーが必要なワークフロー(暗黙的呼び出しが禁止されているため)、引き継ぎドキュメントをリポジトリや共有の場所に残す必要がある、またはドキュメントのライフサイクル(削除/アーカイブ)管理が必要なシナリオ。
Install Agent-Ready
① Verified Mirror 2026-09-06
Option A · Direct DownloadDownload handoff.tar.gz
sha256:
Option B · Copy Guide for Agentfa26a009eb0d810a…Agent はこの JSON ガイドから自動的にダウンロードして検証します。
② Upstream GitHub
GitHub Repo ↗
Pinned to commit 3cca18b368.