vibe-shared-roles

概要

4つのvibe-teamスキルで共通利用するワーカーロール定義を一元管理するスキル。 各スキルは起動時にこのSKILL.mdを動的Readし、必要なロールの instructions を取得して team_recruit に渡す。

対象スキル

共通ロール一覧（ビルトイン3 + カスタム16 = 19ロール）

ビルトインロール（vibe-team標準 — 3ロール）

vibe-team MCP が内部で自動管理するロール。references/role-instructions/ にファイルを作成しない。 team_recruit の対象外であり、vibe-team 起動時に自動的に存在する。

カスタムロール（本スキルで定義 — 16ロール）

ロール設計原則

1. 7±2 ルール

1つの Supervisor（Leader）が直接管理するワーカーは最大 7±2 体。 8体を超える場合は Sub-leader を挟んでスパンを管理する。

2. Role Card 超詳細化

各ロールの instructions に以下5項目を必ず明記する:

3. 稟議型 Human Gate

AIが提案→人間が最終責任を持つパターンを全スキルで採用。 CRITICAL判定は必ずユーザー承認を経由させる。

4. エンジン固定原則

各ロールの engine は本スキルの一覧テーブルで固定。 呼び出し側スキルが勝手に変更しない。

エンジン選択ガイドライン

codex 選定の具体的基準

• 実装者（claude）と別の視点でコードを検証したい → codex
• ファイル全件 grep して影響範囲を網羅的に列挙したい → codex
• JSON状態ファイルの機械的な読み書き → codex
• 抽象的な設計判断・複雑なリファクタ → claude

依存スキル埋め込みマトリクス

各ロールの instructions に埋め込むべきスキルルールの対応表。 ○ = 全文埋め込み、△ = クイック版埋め込み、- = 不要。

ビルトイン3ロール（leader, hr, skill_architect）は vibe-team が内部管理するため本マトリクスの対象外。

凡例:

• ○ = そのスキルの該当セクション全文を instructions に埋め込む
• △ = references/judgment-policy-quick.md のクイック判定表を埋め込む
• - = 埋め込み不要

instructions テンプレート

各ロールの詳細 instructions は references/role-instructions/ 配下を参照。 ビルトイン3ロール（leader, hr, skill_architect）は vibe-team が内部管理するため、このディレクトリには含めない。

ファイル一覧（カスタム16ロール分）

references/role-instructions/
├── state_keeper.md
├── risk_scorer.md
├── codex_scout.md
├── codex_analyzer.md
├── codex_final_checker.md
├── reviewer_tech.md
├── reviewer_arch.md
├── reviewer_devil.md
├── reviewer_security.md
├── reviewer_scenario.md
├── implementer.md
├── slice_implementer.md
├── cross_checker.md
├── nver_implementer.md
├── e2e_tester.md
└── external_llm_synthesizer.md

32KiB超の場合

instructions が 32KiB を超える場合は .vibe-team/tmp/<short_id>.md にファイル書き出し、 team_recruit の instructions には「サマリ + ファイルパス」のみを渡す。

使い方

基本フロー

1. 呼び出し側スキルが本 SKILL.md を動的 Read
2. 必要なロールの role_id を特定
3. references/role-instructions/<role_id>.md を Read
4. ファイル内容をそのまま team_recruit の instructions に渡す
5. 必要に応じて judgment-policy-quick.md の内容を instructions 末尾に追記

team_recruit 呼び出し例

// 1. ロール定義ファイルを Read
const instructions = Read("../vibe-shared-roles/references/role-instructions/risk_scorer.md");
// vibe-team SKILL.md: ../vibe-team/SKILL.md

// 2. team_recruit に渡す
team_recruit({
  role_id: "risk_scorer",
  engine: "codex",
  label: "リスク判定者",
  description: "15シグナルTier判定",
  instructions: instructions
});

動的カスタマイズ

呼び出し側スキルが、ロール定義ファイルの内容にプロジェクト固有の情報を追記してもよい:

const base = Read("../vibe-shared-roles/references/role-instructions/implementer.md");
const custom = base + "\n\n## プロジェクト固有ルール\n- staging経由必須\n- RLSポリシー確認必須";
team_recruit({ role_id: "implementer", engine: "claude", label: "実装者", description: "単一Issue実装（計画→コード→テスト）", instructions: custom });

ロール組み合わせパターン（スキル別）

vibe-issue-planner (VIP)

Leader
├── codex_scout x1-3     (Issue事前調査)
├── implementer x1-3     (実装計画作成)
└── external_llm_synthesizer x1  (外部LLM補助分析、条件付き)

vibe-autopilot-batch (VAB)

Leader
├── state_keeper x1      (バッチ状態管理)
├── codex_scout x1       (事前調査)
├── implementer x1-5     (Issue実装ワーカー)
├── codex_final_checker x1 (最終検証)
└── e2e_tester x1        (E2Eテスト)

vibe-fortress-review (VFR)

Tier A (5体):

Leader
├── risk_scorer x1       (Tier判定)
├── codex_analyzer x2    (影響範囲 + テスト網羅)
├── reviewer_tech x1     (技術正確性)
├── reviewer_arch x1     (アーキテクチャ)
├── reviewer_devil x1    (反論)
├── reviewer_security x1 (セキュリティ)
└── reviewer_scenario x1 (障害シナリオ)

Tier B (3体): risk_scorer + codex_analyzer x1 + reviewer_tech + reviewer_scenario Tier C (2体): risk_scorer + codex_analyzer x1 + reviewer_tech

vibe-fortress-implement (VFI)

Tier I0-I3 で段階的にロールを追加:

Leader
├── risk_scorer x1           (Tier判定)         [I0+]
├── slice_implementer x1     (Slice実装)         [I0+]
├── reviewer_tech x1         (ロジックレビュー)    [I0+]
├── codex_analyzer x1        (影響範囲)          [I1+]
├── codex_final_checker x1   (テスト強化)         [I1+]
├── reviewer_scenario x1     (障害シナリオ)       [I2+]
├── cross_checker x1         (クロスチェック)      [I2+]
├── nver_implementer x1      (N-version実装)     [I3]
├── e2e_tester x1            (E2Eテスト)         [I2+]
└── state_keeper x1          (状態管理)          [I1+]

共通出力フォーマット

レビュー系ロール共通（FR形式）

全レビューロール（reviewer_*, codex_analyzer）が出力する形式:

【検出項目】
- ID: {スキル略称}-{role短縮}-{連番}  (例: VFR-RT-01)
- ファイル: {パス}:{行番号}
- カテゴリ: ARCHITECTURE | LOGIC | SECURITY | DATA_INTEGRITY | REQUIREMENT | OPERATIONAL
- 深刻度: CRITICAL | HIGH | MEDIUM | LOW | INFO
- 判定: PASS | FAIL | WARN
- 問題: {1-2文}
- 根拠: {コードから直接証明可能な事実}
- 修正案: {深刻度HIGH以上の場合のみ}
- 残存リスク: {修正後も残るリスク}

問題なしの場合: 「全項目PASS」と1行で報告。

状態管理ロール（JSON形式）

state_keeper が管理する状態ファイルの共通スキーマ:

{
  "batch_id": "B-YYYY-MM-DD-N",
  "phase": "planning | implementing | reviewing | testing | completed",
  "issues": [
    {
      "number": 123,
      "status": "pending | claimed | in_progress | completed | failed",
      "claimed_by": "worker_id",
      "claimed_at": "ISO8601"
    }
  ],
  "self_healing_log": []
}

judgment-policy クイック版

全ワーカーが参照する判断基準の圧縮版は references/judgment-policy-quick.md に配置。 instructions に埋め込む際はこのファイルの内容を末尾に追記する。

外部スキル依存（オプショナル）

以下のスキルがインストール済みの場合は自動的に参照されます。未インストールでも動作します。

• judgment-policy: ユーザー判断基準（未設定時は都度ユーザーに確認）
• design-review-checklist: 設計レビューチェック（未設定時はスキップ）
• issue-naming: Issue命名規則（未設定時はデフォルト命名）

改訂履歴