mcpField
H
holistic

holistic

github.com/agentivestack開発7236 回インストール26 週間前に更新
リポジトリ

holistic について

コードや機能、計画をシステム全体の視点で理解するためのスキルです。プロジェクト文書やコードベースを調べ、コンテキスト、データフロー、依存関係、変更の影響、リスクを整理します。

主な機能

  1. 01ドメインやプロジェクトの文書を確認
  2. 02ドメイン上の位置とデータフローを整理
  3. 03コンテキスト間の影響と変更範囲を分析
  4. 04最近の変更や既知の課題を確認
  5. 05隠れた依存関係と文書の不足を提示

活用シーン

  1. 01不慣れなコード領域と呼び出し元の把握
  2. 02コンポーネント変更の影響範囲の評価
  3. 03機能のエンドツーエンドのデータフロー追跡
  4. 04大規模な変更前の依存関係とリスクの確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/agentivestack/skills --skill holistic

インストール後、Claude Code で/holisticを入力して読み込まれたか確認します。

詳細

全体像の把握

コード、機能、計画がより大きなシステムの中でどのように位置づけられるかを、多層的かつ包括的に示します。このスキルが扱うのはシステムレベルであり、実装レベルではありません。

プロセス

1. プロジェクトの背景を把握する

既存のドメインドキュメントを読み、分析の土台を築きます。

  1. docs/CONTEXT_MAP.md — 境界づけられたコンテキストとその関係
  2. docs/UBIQUITOUS_LANGUAGE.md — 標準用語
  3. docs/contexts/*/CONTEXT.md — コンテキストごとの責務と契約
  4. CLAUDE.md — プロジェクトレベルの背景情報

これらが存在しない場合は、コードベースを調べながら全体像を把握します。

2. 注目する対象を特定する

ユーザーが何を理解したいのかを判断します。対象には、次のようなものがあります。

  • 特定のファイル、モジュール、パッケージ
  • 機能や能力
  • 計画中の変更や新機能
  • バグや予期しない動作
  • ユーザーが確信を持てずにいる概念や用語
3. コンテキストをマッピングする

注目する対象について、多層マップを作成します。

レイヤー 1：ドメイン内の位置づけ
  • どの境界づけられたコンテキストに属しますか？
  • どのようなドメイン概念を実装していますか？
  • そのコンテキスト内でどのような役割を担いますか？（コアロジック、インフラストラクチャ、表層/UI、契約／境界）
レイヤー 2：データフロー
  • このコンポーネントにどのようなデータが流入しますか？（上流の依存関係）
  • どのようなデータが流出しますか？（下流の利用者）
  • どの共有カーネルや契約に関与していますか？
  • 発生元から宛先まで、リクエスト／データの経路全体を追跡します
レイヤー 3：コンテキスト間の影響
  • ほかにどの境界づけられたコンテキストに関係しますか？
  • 結合点は何ですか？（共有テーブル、イベント、API、ウィンドウグローバル）
  • これが壊れた場合、ほかに何が壊れますか？（影響範囲）
  • これを変更した場合、ほかに何を変更する必要がありますか？（変更の波及）
レイヤー 4：時間軸での視点
  • 最近の変更とどのように関連していますか？（git log を確認）
  • 影響する可能性がある計画中の変更はありますか？（仕様書、未解決の Issue を確認）
  • この領域は安定していますか、それとも活発に変化していますか？
  • 既知の技術的負債や未解決の疑問はありますか？（CONTEXT.md の未解決の疑問を確認）
4. インサイトを明らかにする

マッピングの後、次の点を強調します。

  • 隠れた依存関係 — import だけでは明らかにならない結合（例：共有 ClickHouse テーブル、ウィンドウグローバル、慣習に基づく契約）
  • システム上のリスク — 単一障害点、テストされていない境界、古くなった前提
  • 改善の機会 — 現在の構造が不要な摩擦を生んでいる箇所や、小さな変更で大きな効果が期待できる箇所
  • 不足しているドキュメント — 調査を通じて CONTEXT.md、UBIQUITOUS_LANGUAGE.md、CONTEXT_MAP.md の不足が見つかった場合、追加すべき内容を記します
5. マップを提示する

出力を次の形式で構成します。

## [Focal Point Name]

### Domain Position
[Which context, what role, what concepts]

### Data Flow
[Upstream → This → Downstream, with specific contracts]

### Cross-Context Impact
[What it touches beyond its own context, blast radius]

### Key Insights
[Hidden dependencies, risks, opportunities]

### Recommended Reading
[Specific files or docs to read for deeper understanding]

簡潔にまとめます。目的は全体像をつかむことであり、網羅的なドキュメントを作成することではありません。

このスキルを使う場面

  • 「このコード領域に詳しくありません」→ モジュールと呼び出し元をマッピングする
  • 「X を変更すると何が壊れますか？」→ 影響範囲を追跡する
  • 「機能 Y は実際にどのように最初から最後まで動作しますか？」→ データフローを追跡する
  • 「この概念はコードベースのどこにありますか？」→ 境界づけられたコンテキストと責務にマッピングする
  • 「大きな変更に着手するところです。何を把握しておくべきですか？」→ 全体像を把握する

関連スキル

  • /domain — ドメインモデルに照らして計画をストレステストする（より深く、対話的）
  • /architect — 摩擦を明らかにし、より優れたインターフェースを設計する（具体的な提案）
  • /spec — 全体像を把握した後、計画を明文化する

コメント

Markdown 対応