Release v0.12.0 — handoff-docs skill と handoff-verifier subagent を追加 · sei-newbear/xp-harness

別セッションのエージェントへ引き継ぐ成果物を「会話文脈ゼロで読める自己完結」に書き、独立点検までつなぐ handoff-docs skill と handoff-verifier subagent を追加。

ユーザー向け (= xp-harness を使う人)

handoff-docs skill (新規): 要件定義・基本設計・引き継ぎ書・README など「別セッションのエージェントへ渡して作業を継続させる成果物」を書くとき、会話文脈ゼロで読んで下流タスクに着手できる自己完結性を効かせる。書き手の会話文脈が "のり" になって穴が見えない問題に対して、Why・決定の根拠・前提・却下案までを漏らさず書かせ、さらに 既にやった検証・調査の条件と結果、残タスクの高確率な続き（例: レビュー対応→再検証）に進める前提 まで残させる。書き終えたら handoff-verifier で点検し、Yes になったら次セッションへの**引き継ぎの一言（起動用の依頼文）**まで出す。
handoff-verifier subagent (新規): 会話文脈を持たずに成果物だけを読み、文脈ゼロの引き継ぎ先が下流タスクに着手できるか（自己完結しているか）を Yes/No と穴の具体指摘で返す。妥当性レビュー（pre-implementation-reviewer）やコードの Done 達成確認（done-verifier）とは責務が分かれ、「文脈ゼロで読めるか」だけを見る。

define-requirements / basic-design: 自己完結性の規律を handoff-docs 呼び出しに集約。要件定義.md / 基本設計.md を書くとき handoff-docs を呼んで自己完結性を効かせる形になり、成果物を別セッションへ渡す前に引き継ぎ可能性を点検する動線が入った。

announce-release skill (新規): リリース周知テキストを生成する改修者向け skill。
harness-verification: 検証セッションの自走駆動を強化。launcher に wait-idle（main + subagent の transcript 監視でターン完了を検知）、resume 起動（クラッシュ復帰）、send の submit 保証を追加、stop が script プロセスを見逃すバグを修正。あわせて、sandbox だけでなく本番の実運用セッションを「あるべき振る舞い」に照らして分析する射程を追加。

skill-design-style: subagent の書き方を追加。「subagent は本文の読み手が skill と違う（呼ぶ側は description しか読まない）」を核に、呼び出し規約は description に置く・本文は二人称・共有規律は preload、および subagent の description は公式に長さ推奨が無く字数で機械的に削らない、を明文化。

apm install sei-newbear/xp-harness#v0.12.0 --target claude

apm.yml の依存指定を新バージョンに書き換える:

 dependencies:
   apm:
-  - sei-newbear/xp-harness#v0.11.0
+  - sei-newbear/xp-harness#v0.12.0

そのあと:

apm install --target claude
# Content hash mismatch が出たら (= APM のサプライチェーン検出機構、想定挙動)
apm install --update --target claude

詳細は README "Update" セクション参照。

後方互換あり。既存の skill / subagent の削除・改名はなし。handoff-docs / handoff-verifier は新規追加で、既存フローに引き継ぎ点検の動線が足された形。