agentleFS
ozzy-labsozzy-labs/opshub/.claude/skills/handoff-draft/SKILL.md

handoff-draft

Skill2 starsChanged 5 months agoMITView on GitHub

「引き継ぎ書作って」「handoff 書く」「後任向け資料まとめて」「業務引継メモほしい」と頼まれたら、opshub MCP の task.list (state=in_progress) + decision.list + recall.search + graph.related を読み取り系で組み立て、ホスト LLM が引き継ぎ書 text を構成して返す。persist しない (text-only、ADR-0016 §決定 (l)(a))。propose.generate を経由せず候補保存 / apply 経路を持たない。ユーザーが受け取った text を手で SaaS (Notion / Confluence / docs / Slack 等) に貼り付ける。

1 other project uses a version of this.

Adopted by

Most recently taken up by

The file

Files
SKILL.md

handoff-draft — 引き継ぎ書 text を opshub の context から組み立てて返す

opshub MCP server (opshub mcp serve、ADR-0022) の read tool 群 (task.list / decision.list / recall.search / graph.related) をホスト LLM が合成して、後任向け引き継ぎ書の text を 1 発で組み立てる。Phase 12 H5 (docs/phase-12-plan.md §3 H5) で導入された Tier 2 draft 系 skill。

persist しない: reply-draft と異なり、本 skill は propose.generate + propose.apply 経路を 使わない。引き継ぎ書は自発生成で natural key を持たないため (返信元 source のような対応付けがない)、proposal table に保存しても operator から見て idempotency / 削除 / 編集の semantics が曖昧になる。ADR-0016 §決定 (l)(a) で「返信元 source の有無」で persist 境界を切る方針が pin されており、本 skill は text-only 返却に留める。

何が起きるか

  1. ユーザーが「引き継ぎ書作って」「handoff 書く」「後任向けにまとめて」と頼む
  2. ホストが本 skill を発火
  3. ホストが下記「呼び出し順」に従って read tool を順次呼ぶ
  4. 戻り値を集約してホスト LLM が引き継ぎ書 text を 1 発で構成 (Markdown)
  5. ユーザーに text を提示 (画面表示のみ)
  6. ユーザーが手で SaaS (Notion / Confluence / docs / Slack 等) に貼り付ける

opshub 側に候補保存 / apply 経路は存在しない (propose.generate / propose.apply を呼ばない)。「保存」のような UX を提示しないこと。

呼び出し順 (MCP tool)

Step 1: 進行中 task を列挙

tool: task.list
input:
  state: "in_progress"
  limit: 50

戻り値の items[] を引き継ぎ書の「進行中タスク」セクション素材として使う。Phase 12 H1 (ADR-0022 改訂) で物理列ベースの時間フィルタが追加されたが、引き継ぎ書は時点スナップショットなので時間フィルタは不要 (state=in_progress で全進行中を拾う)。

state 値が active / in_progress のどちらか projection 側で正規化されているため、projection の SSOT に従う (src/opshub/projections/tasks.py)。

Step 2: 最近の decision を列挙

tool: decision.list
input:
  recorded_after: "<引き継ぎ対象期間の開始 ISO 8601>"   # 任意、例: 過去 3 ヶ月
  limit: 30

「なぜそう決めたか」を後任に伝えるため、最近の decision を引く。引き継ぎ範囲をユーザーが「直近半年」「過去 1 年」のように指定したらホストが ISO 8601 で recorded_after を埋める。指定がなければ recorded_after を省略 (全 decision を新しい順で limit 件)。

Step 3: 周辺コンテキストを recall で拾う

tool: recall.search
input:
  query: "<引き継ぎトピック or プロジェクト名 or 担当領域>"
  limit: 20

進行中 task / decision だけでは抜け落ちる周辺シグナル (Slack 上の議論 / GitHub の進行中 PR / Office 文書 等) を recall で拾う。ADR-0012 hybrid recall (本文 embedding + FTS5 + graph 補強) で意味検索を効かせる。

Step 4: 関連エンティティを graph で広げる

tool: graph.related
input:
  entity_id: "<Step 1-3 で hit した重要 task / decision / source の ULID>"
  limit: 20

特定 task や decision の周辺 (関連 source / 派生 task / 引用 decision) を 1-hop で広げる。ホストが Step 1-3 の中から「これは確実に引き継ぐ」エンティティを 2〜3 個選び、それぞれに graph.related を呼ぶ。全件に呼ばないこと (コンテキスト爆発防止、ADR-0022 §(d))。

出力フォーマット (ホスト側、text として user に提示のみ)

ホスト LLM が以下の骨子で Markdown text を組み立て、画面に提示する。保存はしない。

# 引き継ぎ書 (<対象範囲>)

## 概要
<担当業務 / 対象期間 / 引き継ぎ理由を 2-3 行>

## 進行中タスク (task.list state=in_progress)
- [<title>] (<priority>, due: <due_at>) — <現在のステータス> / <次のアクション>
- ...

## 最近の重要 decision (decision.list)
- [<title>] (<recorded_at>) — <要旨>
  - 背景: <なぜそう決めたか、recall / graph で拾った context>
- ...

## 周辺コンテキスト (recall.search)
- <topic 1>: <要約>
  - 関連 source: <title> (<url>)
- ...

## 関連エンティティ (graph.related で広げた範囲)
- <task / decision / source> ↔ <related>
- ...

## 後任への申し送り
- <ユーザーが追加したい注意点 / 連絡先 / ノウハウを LLM が要約>

text は user に提示するのみ。user は手で Notion / Confluence / docs / Slack 等にコピペする。

自律範囲

  • すべて read tool (task.list / decision.list / recall.search / graph.related、readOnlyHint=true)。確認なしで呼んでよい
  • write tool は呼ばない — propose.generate / propose.apply / task.create / inbox.add / connector.sync 等 durable state を変える tool は本 skill では一切呼び出さない
  • 引き継ぎ書 text を opshub の durable state に書き戻さない (ADR-0016 §決定 (l)(a))

できないこと / やらない

  • 候補保存 / apply — propose.generate / propose.apply を呼ばない。本 skill は text-only (ADR-0016 §決定 (l)(a))。HandoffDraftCandidatePayload のような新 candidate kind も存在しない (ADR-0016 §決定 (l)(d) で Candidate discriminated union は task | decision | reply_draft の 3 kind で freeze)
  • 外部 SaaS への投稿 — Notion / Confluence / Slack に直接書き込まない (ADR-0010 §禁止事項 7)。user が手で貼り付ける
  • task の自動完了 / 状態変更 — 引き継ぎ書を生成しても task の状態は触らない
  • triage 値の付与 — §決定 (l)(c) で 3 値 triage (respond / notify / ignore) は reply_draft 専用と pin。本 skill は triage を持たない
  • propose.generate の mode 引数経由の dispatch — §決定 (l)(b) で mode 引数は persist 経路を持つ structured-output dispatch key に限定 (reply_draft / inbox_triage / source_extract / meeting_followup)。handoff_draft mode は存在しない

参考

  • ADR-0016 §決定 (l) (Draft 系統一方針、Phase 12 H1 で追加)
    • (a) persist 境界は「返信元 source の有無」で切る (handoff-draft は text-only)
    • (b) mode 引数の射程 (persist 経路を持つ 4 mode のみ)
    • (c) Triage は reply_draft 文脈のみ
    • (d) Candidate discriminated union freeze (3 kind: task / decision / reply_draft)
    • (e) 将来 persist 需要が出たら schema versioning パターンで追加
  • ADR-0004 (Agent Runtime Boundary、形A、能動 push なし)
  • ADR-0010 §禁止事項 7 + §改訂 (write-back 当面 scope 外)
  • ADR-0012 改訂 (本文 embedding hybrid recall)
  • ADR-0017 §決定 (graph link_type)
  • ADR-0022 改訂 (MCP Server Surface、physical-column 時間フィルタ)
  • Phase 12 plan (docs/phase-12-plan.md §3 H5)
  • docs/assistant-agent.md (Skill catalog SSOT、15 skills 責務マップ)
  • pair: announcement-draft (告知文、こちらも text-only)

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.