ワークフロー&基本ツール · mattpocock/skills

handoff

現在の会話を、別のエージェントが引き継ぐためのハンドオフドキュメントに圧縮します。

L2 ローカル · 作業ディレクトリ限定V1 コミット固定ファイル書き込みDual-pass Audit
Author mattpocockGitHub mattpocock/skills ↗Stars 253948License MITCommit 3cca18b368
管理レベルは Skill の能力と推奨統制措置を示すものであり、品質や安全性の認証、利用可否の判定ではありません。使用の可否はユーザーおよび管理者が決定します。Agent 環境によって制約が異なるため、自動保護を仮定しないでください。第三者製 Skill の著作権は原著作者に帰属し、利用リスクは利用者が負います。

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結論

  • ゼロ副作用面:スクリプトなし、ネットワークなし、認証情報なし。唯一の動作は一時ドキュメントを1つ書き込むことのみ
  • 優れた出力規律:'not the current workspace' としてOSの一時ディレクトリへの書き込みを明確に要求し、ユーザーリポジトリを汚染しない
  • 重複防止設計:既存の成果物は複製せずpath/URLで参照し、ドキュメントを簡潔に保ち元の成果物との乖離を防止
  • 組み込みのプライバシー指示:APIキー/パスワード/PIIのマスキング(redact)を明示的に要求
  • 制御可能なトリガー:Claude/OpenAIの両エコシステムのメタデータで自動呼び出しを禁止し、ユーザーが明示的に要求した時のみ実行
  • 最適な用途: セッション間やエージェント間で複雑な作業を引き継ぐ必要がある個人開発者(Matt Pocockスタイルのワークフローなど)、「次のエージェントへの引き継ぎ」を標準化したいチーム、引き継ぎドキュメントをリポジトリに入れず一時領域に残したいシナリオ。
    不向きな用途: 固定の引き継ぎテンプレートや構造化スキーマを必要とするチーム(本スキルにはフォーマット制約がなく完全な自由形式テキスト)、引き継ぎの自動トリガーが必要なワークフロー(暗黙的呼び出しが禁止されているため)、引き継ぎドキュメントをリポジトリや共有の場所に残す必要がある、またはドキュメントのライフサイクル(削除/アーカイブ)管理が必要なシナリオ。
    Install Agent-Ready
    ① Verified Mirror 2026-09-06
    Option A · Direct DownloadDownload handoff.tar.gz
    sha256: fa26a009eb0d810a…
    Option B · Copy Guide for Agent
    install.json
    Agent はこの JSON ガイドから自動的にダウンロードして検証します。
    ② Upstream GitHub
    GitHub Repo ↗
    Pinned to commit 3cca18b368.