메뉴
xp-harness 本体 (skill / agent / instruction / kanban 等) のレビューを進めているときに必ず発火させる skill。依頼者がレビュー中の気づきを次々と伝えてくるので、それを改修バックログ（かんばん）に記録していく作業に特化した振る舞いを規定する。「レビューしている」「気づきを記録」「かんばんに追加」「TODO に追加」「あとは…」「次は…」のような連続入力を受けたときに発火。1 つの気づきへの返答が終わってから次の気づきを受けるリズム。発火しないのは、レビューではなく実際に手を動かして実装 / 修正している場面、依頼者から明示的に「議論したい」「相談したい」と言われた場面。
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 | review-recording |
| description | xp-harness 本体 (skill / agent / instruction / kanban 等) のレビューを進めているときに必ず発火させる skill。依頼者がレビュー中の気づきを次々と伝えてくるので、それを改修バックログ（かんばん）に記録していく作業に特化した振る舞いを規定する。「レビューしている」「気づきを記録」「かんばんに追加」「TODO に追加」「あとは…」「次は…」のような連続入力を受けたときに発火。1 つの気づきへの返答が終わってから次の気づきを受けるリズム。発火しないのは、レビューではなく実際に手を動かして実装 / 修正している場面、依頼者から明示的に「議論したい」「相談したい」と言われた場面。 |
xp-harness の本体 (skill / agent / instruction / かんばん) を依頼者がレビューするとき、気づきを次々と伝えてくる場面がある。その場で議論したり、優先度を勝手に付けたり、複数気づきを合体させたりすると、後から個別に着手 / 削除 / 整理しにくくなる。
このモードでは「気づきを記録に徹する」振る舞いをルール化する。
依頼者が「やる際に検討する」と判断したものは、記録段階では議論しない。
例外: 依頼者から明示的に「相談したい」「議論したい」と言われた場面のみ議論モードに切り替わる。
これはレビューでの気づきの記録であって、運用痛から駆動された TODO ではない。
kanban skill の規約に従う（現状のデフォルトは backlog）同じ対象ファイル / 同じ agent への複数指摘でも、合体させずに別カードとして記録する。理由: 後から個別に着手 / 削除 / 優先度変更しにくくなる（1 項目 1 カードはかんばんの基本）。
合体が許される場面: 既存カードが同じ概念をカバーしている、かつ依頼者が「他のカードに書いてあるなら統合してよい」と明示した場合のみ。
意図そのものが分からないときに限り、確認質問をする。
気づき 1 件につき 1 カードを新規作成する。記録先はかんばんなので、カードの置き場所・ファイル名規約・本文テンプレ・優先度の扱いはかんばんの規約に乗る（具体は振る舞いの流れで kanban skill を呼ぶ）。本文には背景 / Why・状況・再開時の起点を含める。
kanban skill を呼び、その規約に従ってカードを作る）backlog 既定に留める)