메뉴
別セッションのエージェントが会話文脈なしで読んで下流タスクに着手できる、自己完結な引き継ぎドキュメントを書く。要件定義・基本設計・引き継ぎ書・PRD・README など、別セッションのエージェントへ渡して作業を継続させる成果物を書く・仕上げるときに使う。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
xp-harness の skill / subagent が意図どおり振る舞えているか (発火するか・あるべき振る舞いができているか) を transcript で事実確認する手順。skill / subagent を改修した後に sandbox で動作検証したいとき、または本番の実運用セッションを「あるべき振る舞い」に照らして分析したいとき、「検証したい」「発火するか確かめたい」「このセッションを分析したい」と言われたときに発火させる。核は発火・振る舞いができたかの事実確認で、本番セッションでは自走の良し悪し (止まり方・判断の質など) も見る。
要件が固まった機能・変更について、アーキテクチャ・ER・シーケンス・論理設計までを対話で固める「基本設計フェーズ」のスキル。docs/working/<title>/要件定義.md が既にある状態で「設計を進めて」「basic-design」と言われたら必ず発火させる。要件定義が終わって設計フェーズに入りたい依頼、データモデルや API 設計や画面遷移の議論、コンポーネント分割や責務分離の相談、「どう作るか」の構造的な設計が必要な場面で使う。
新規・変更・削除・改善などの要望やレビュー指摘を受けたら、設計や実装に入る前にまず必ず発火させる「要件定義フェーズ」のスキル。依頼者のインテントを読み取り、Why / Done / スコープ / 影響範囲を引き出す。見える挙動が変わる依頼全般が対象で、やることが具体的でも md にまとめられていても発火させ、複数の要望が混ざる依頼ほど積極的に発火させる。発火しないのは、再現条件と期待動作が完全に明確なバグ修正、依存更新・タイポ修正などの定型作業、要件定義と基本設計の文書が両方揃った実装フェーズの続き（メモや TODO があるだけでは除外しない）だけ。
依頼者と議論・対話を進める場面で必ず発火させる skill。共創を目指して、認識を小さく揃えながら、同じ抽象度・レイヤーで話すための対話の進め方を扱う。要件・設計フェーズの対話、実装中の設計判断の議論、レビュー結果の共有、複数の論点・選択肢を依頼者に渡す場面、依頼者からの指摘・反論に応答する場面、「確認したい」「議論したい」「相談したい」と問いかけたいとき、いずれも発火対象。「会話」ではなく「対話」を成立させたい全場面で効く。
Git 運用の規律 (branch / worktree 運用、commit / push / pull / rebase / conflict 解決、remote 同期、完了時の統合) を一元的に担う skill。コード変更を伴う依頼・セッション開始・Git 操作の話題のいずれかに該当したら、他より先に必ず最初に使う。ファイルを 1 行でも書き換える依頼なら Git に無関係に見えても発火し、セッション開始・作業再開 (「前回の続き」「何から始めよう」等) でも必ず発火する。発火しないのはコードを読むだけの質問、Git の概念学習質問、doc のサマリ依頼。project 固有ルールでの部分上書きに対応する。
設計判断・ライブラリ選定・アーキ判断・実装アプローチが 2 つ以上ありえる場面で必ず発火させる、「複数案＋メリデメ＋推奨」を提示する横断スキル。「どっちがいい？」「これでいい？」「方針を相談したい」と聞かれたとき、ライブラリ選定・ディレクトリ構成・API 設計・テスト戦略のように選択肢が複数ある相談を受けたとき、要件定義 / 設計 / 実装の中で「複数アプローチがありそう」と感じたときに必ず使う。一案だけポンと出さない。
| name | handoff-docs |
| description | 別セッションのエージェントが会話文脈なしで読んで下流タスクに着手できる、自己完結な引き継ぎドキュメントを書く。要件定義・基本設計・引き継ぎ書・PRD・README など、別セッションのエージェントへ渡して作業を継続させる成果物を書く・仕上げるときに使う。 |
別セッションのエージェントへ引き継ぐ成果物を書くとき、書き手の会話文脈が "のり" になる。ドキュメントに書かれていない前提を書き手は脳内で補完しながら読むため、本人には完成・自己完結して見える。だから書き手自身の自己点検では穴が見つからない。
この skill は、そういう「別セッションへ引き継ぐ前提の成果物」を自己完結に書くための規律と、書き終えたときに文脈ゼロで点検する動線を配る。
引き継ぎ先が会話文脈ゼロで読んで下流タスクに着手できるように、次を漏らさず書く:
表現の規律:
成果物を「自己完結した」「引き継げる」と宣言する前に、handoff-verifier subagent を呼んで文脈ゼロで点検する。書き手自身は会話文脈が "のり" になって穴が見えないので、自己点検では引き継ぎ可能性を担保できない。文脈ゼロの読み手を再現できるのは、会話を持たない独立の点検者だけ。
呼び出し側の規律 (文脈ゼロを壊さないために必須):
handoff-verifier は「Yes / No と穴の具体指摘」を返す。read-only なので成果物は直さない。ループを回すのは呼んだ側 (あなた):
handoff-verifier が Yes になったら、成果物を「引き継げる」と宣言して終わりにせず、次のセッション / エージェントへの引き継ぎの一言 を出す。成果物を書いただけでは、受け手はどのファイルを読み何に着手すればいいか分からない。実際に引き継ぎを起動する一言まで出して、引き継ぎが完了する。
一言に含めるもの:
出す形は、依頼者がそのまま次のセッションに渡せる短い依頼文にする。
この skill が担うのは成果物の 自己完結性 (文脈ゼロで読んで下流タスクに着手できるか) だけ。成果物の 妥当性 (Why が正しいか、設計に無理がないか) は別の役割 (要件・設計の第三者レビュー) の責務で、この skill は問わない。
引き継ぐ前提の成果物を書く場面ならどこでも、書き終える箇所でこの skill を効かせ、handoff-verifier で引き継ぎ可能性を点検してから次へ渡す。
