Communitygithub.com

Council — 多視点分析

コードベースやプロジェクトを多角的かつ客観的に評価し、既存コードへの固執を防ぐフレームワークです。

Council — 多視点分析 とは?

Councilは、AIエージェント(Claude Code、Cursorなど)向けに設計された多視点分析スキルです。従来のAIツールが既存コードに過度に依存する「アンカリング」問題を解決するため、複数の視点(アーキテクト、チャレンジャー、セキュリティ専門家など)とデバイアス技法(新鮮な目モード、挑戦モード、再構築モード)を組み合わせます。ユーザーはリポジトリパスや問題定義を入力し、スキルがフェーズ1(スカウト:事実収集)、フェーズ2(視点生成:複数エージェントで並列または逐次分析)、フェーズ3(統合:合意・不一致・新たな洞察を抽出)、フェーズ4(検証:矛盾チェック)を実行します。複雑なターゲットでは`spawn_agents`機能を使って視点を並列実行し、グループシンクを防止。最終出力は構造化されたレポート(エグゼクティブサマリー、重要発見、優先度付き推奨事項、代替案比較)として提供されます。特に、大規模リファクタリング、意思決定の検証、隠れた前提の発見に有効です。プラットフォーム非依存で、Markdownベースのリソース(`references/debiasing.md`、エージェント設定)がバンドルされています。

対応~Claude Code~Codex CLI~Cursor
npx skills add adulari/forge

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Council — 多視点分析 は何をしますか?

コードベース、プロジェクト、ドキュメントを客観的かつ公平に評価する多視点分析フレームワークです。複数の視点とデバイアス技法を用いて、既存コードに固執する傾向を克服します。

解決する問題

AIツール(そして人間も)は既存コードに固執しがちです。現状を見て、「あるべき姿」を想像するのに苦労します。検証ではなく探索を怠ります。Councilは以下を使用します:

  1. デバイアス技法 — 新鮮な思考を強制する方法
  2. 複数の視点 — 異なるメンタルモデルが異なる問題を捉える
  3. 構造化された統合 — 意見の相違を追跡しながら洞察を統合

使用すべきタイミング

  • 現在のアプローチが最適か評価する場合
  • 既存実装の代替案を探る場合
  • プロジェクトの隠れた前提を特定する場合
  • 重要な決断の前に客観的なフィードバックを得る場合
  • 局所最適で行き詰まった場合
  • 「もっと良い方法があるはずだが、見えない」と感じる場合
  • AIツールが既存のパターンを繰り返し返す場合

入力

ユーザーが提供するもの:

  • ターゲット:リポジトリパス、ドキュメント、または具体的な問題の説明
  • 目標(オプション):成功の定義(例:「収益性を最大化する」)
  • 制約(オプション):維持すべきもの(例:「既存のデータモデルを使用する必要がある」)

実行フロー

フェーズ1:スカウト

ターゲットを徹底的に読み理解する。以下の項目を記録:

  • プロジェクトの目的
  • 現在の構造
  • 存在する制約
  • 明示された目標

まだ意見を形成しないこと。 事実だけを収集する。

フェーズ2:視点の生成

ターゲットに基づいて3~5の関連する視点を選択:

視点焦点最適な用途
アーキテクト構造、パターン、結合度、凝集度システム設計、リファクタリング
チャレンジャー前提、リスク、代替案意思決定の検証、リスク軽減
オポチュニスト新技術、近道、簡略化最適化、負債削減
セキュリティ信頼境界、障害モード安全性、信頼性
エコノミストコスト、複雑さ、ROIリソース配分、優先順位付け
ユーザーユーザビリティ、価値、摩擦UX、製品決定
アーキオロジストレガシー、負債、履歴理解、移行
フューチャリストトレンド、スケーリング、進化長期計画

複雑なターゲットの場合:spawn_agentsを使用して視点を並行実行 — 各エージェントはグループシンクを避けるために独立して作業し、フェーズ3で結果を統合。

単純なターゲットの場合:単一のエージェントで視点を逐次実行。

各視点は以下のデバイアス技法を適用:

  1. 新鮮な目モード:既存の実装を意図的に無視する。「目標だけを知っていて、ゼロから作るとしたら何を構築するか?」と問う。
  2. 挑戦モード:すべての前提に疑問を投げかける。なぜこのコンポーネントは存在するのか?削除したらどうなるか?逆のことが真ならどうか?
  3. 再構築モード:「今日の知識でゼロから解決しなければならないとしたら、何を変えるか?」

詳細なデバイアス技法とプロンプトについては references/debiasing.md を参照。

フェーズ3:統合

視点を構造化された出力に統合:

  1. 合意:複数の視点が一致する点(信頼度が高い)
  2. 不一致:視点が衝突する点(トレードオフを明らかにするため深掘り)
  3. 新たな洞察:1つの視点だけが捉えた点
  4. 優先度順の推奨事項:影響と信頼度でランク付け

サブエージェントを使用する場合の詳細な統合手順については agents/synthesizer.md を参照。

フェーズ4:検証

  • 推奨事項が互いに矛盾しないか確認
  • 検証されていない前提にフラグを立てる
  • 結論を変える可能性のある情報を特定

出力形式

# Councilレポート:[ターゲット]

## エグゼクティブサマリー
[2~3文の客観的評価 — 何を行ったかの要約ではなく、結論]

## 重要発見

### [発見名]
- **内容**:[発見の明確な説明]
- **同意する視点**:[リスト]
- **異議を唱える視点**:[リスト + 簡潔な理由]
- **信頼度**:[高/中/低]
- **証拠**:[具体的なファイル:行、指標、または観察結果]

## 推奨事項

### [高影響] [推奨タイトル]
- **解決する問題**:[この推奨事項が修正する発見]
- **解決策**:[具体的なアクション]
- **期待される影響**:[何がどの程度改善されるか]
- **労力**:[低/中/高]
- **リスク**:[低/中/高]
- **支持する視点**:[リスト]

### [中影響] ...

### [低影響] ...

## 検討された代替アプローチ

| アプローチ | 長所 | 短所 | 判定 |
|----------|------|------|---------|
| ...      | ...  | ...  | 維持/置換/さらに調査 |

## この評価を変えるもの
- [X]が真の場合、[推奨Y]が変わる
- [影響を与える未検証の前提]

バンドルリソース

  • references/debiasing.md — 視点タイプごとの詳細なデバイアス技法とプロンプト
  • agents/perspective.md — 個々の視点分析を実行するサブエージェント向けの手順
  • agents/synthesizer.md — 複数の視点出力を統合する統合サブエージェント向けの手順

関連スキル