persona-crew

Derived from genshijin (MIT, InterfaceX-co-jp) — https://github.com/InterfaceX-co-jp/genshijin

persona-crew は圧縮形式で出力する3つの subagent プリセット。役割は標準の Explore / 編集系 agent / reviewer と同じで、違うのは返ってくる tool-result が 圧縮済みであること。委譲のたびに主コンテキストの消費が縮む。

キャラクター非依存。 agent の出力は口調ではなく圧縮形式に従う。

使い分け

• 「X の定義はどこ / Y を呼ぶ箇所 / Z の全用法」 → persona-investigator
• 同上に加えてアーキテクチャの解説や提案も欲しい → Explore（標準）
• スコープが明確な surgical 編集、2ファイル以下 → persona-builder
• 新機能 / 3ファイル以上 / 横断リファクタ → 主スレッド、または heavy-implementer
• diff / branch / file のバグレビュー → persona-reviewer
• 根拠と代替案つきの深いコードレビュー → 標準の Code Reviewer
• 1行で答えが確定している内容 → 主スレッドで完結。委譲しない

判断基準は単純で、subagent の出力を 1/3 のトークンで欲しいなら persona-crew、 散文で欲しいなら標準の agent。

なぜ存在するか

subagent の tool-result は主コンテキストにそのまま注入される。標準の Explore が 散文で 2k トークン返せば、毎回 2k を主コンテキストが負担する。同じ発見が persona-investigator なら 700 トークン前後で返る。1セッションで20回委譲すると、 コンテキスト枯渇か完走かの差になる。

出力契約

主スレッドが agent ごとに前提にしてよい形式。

persona-investigator:

<Header>:
- path:line — `symbol` — 短い注記
集計: <counts>。

該当なしは No match.。必ずファイルパスが先頭、行番号つき、シンボルはバッククォート。 path:\d+ で grep できる。

persona-builder:

<path:line-range> — <変更 10語以内>。
verified: <re-read OK | mismatch @ path:line>。

または終端行のいずれか: too-big. / needs-confirm. / ambiguous. / regressed.

persona-reviewer:

path:line: <emoji> <severity>: <問題>。<修正>。
totals: N🔴 N🟡 N🔵 N❓

指摘なしは No issues.。ファイル順、ファイル内は行の昇順。

チェイニング

位置特定 → 修正 → 検証（最頻）

1. persona-investigator で対象箇所の一覧を取る
2. 主スレッドが1〜2箇所を選び、パスを persona-builder に渡す
3. persona-reviewer が diff を監査する

並列スカウト（調査範囲が広いとき）

1メッセージで persona-investigator を2〜3個並列起動する（定義 / 呼び出し元 / テスト のように角度を変える）。集約は主スレッドで行う。

単発編集（箇所が既知のとき）

investigator を飛ばし、persona-builder に直接 path:line を渡す。

禁止

• ファイルを特定せずに persona-builder を使わない。先に investigator を通す。 でないと主スレッドがコンテキストを渡すためにトークンを消費する
• 5ファイル規模のリファクタで investigator → builder のチェーンを組まない。 builder は too-big. を返してターンを浪費する
• persona-reviewer に「全般的なフィードバック」を求めない。findings しか返らない
• 散文を期待しない。persona-crew の出力は構造化されており、時に読みにくい。 人間がそのまま読む場合は主スレッドが言い換える