Menu
既存コードの結合構造を 3 次元（統合強度・距離・変動性）で分析し、不均衡を検出する。 既存システムのモジュール境界を見直したいとき、分散モノリスや泥団子の兆候を調査したいとき、 リファクタリング前に結合構造を把握したいとき。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | modularity-review |
| description | 既存コードの結合構造を 3 次元（統合強度・距離・変動性）で分析し、不均衡を検出する。 既存システムのモジュール境界を見直したいとき、分散モノリスや泥団子の兆候を調査したいとき、 リファクタリング前に結合構造を把握したいとき。 |
既存コードのモジュール間結合を構造的に分析し、不均衡を検出するワークフロー skill です。design-and-plan（balanced-coupling-design）が「これから作るもの」の設計に使うのに対し、この skill は「すでにあるもの」の構造診断に使います。 ゴール駆動で使うため、最初に達成したいゴール、成功条件、確認手段を短く固定します。
分析対象のシステム/コードベースを理解する。
やること:
入力:
出力: モジュール一覧と業務領域マッピング
モジュール間の統合を特定し、3 次元で評価する。
やること:
出力: 統合マップ（テーブル形式）
統合マップにバランスルールを適用し、構造的リスクを特定する。
バランスルール: BALANCE = (統合強度 XOR 距離) OR NOT 変動性
不均衡の分類:
出力: 不均衡リスト（統合 / 3 次元評価 / 重大度 / 根拠）
分析結果をレビュー文書にまとめ、是正策を提案する。
レビュー文書に含めるもの:
# Modularity Review: [対象システム/モジュール名]
## 分析概要
- 対象範囲: [全体 / 特定モジュール群]
- モジュール数: N
- 統合数: M
- 分析日: YYYY-MM-DD
## サブドメイン分類表
| 業務領域 | 分類 | 根拠 | 変動性 |
|---------|------|------|--------|
| ... | Core / Supporting / Generic | ... | High / Medium / Low |
## 結合評価表
| 統合 | 統合強度 | 距離 | 変動性 | バランス? | 重大度 |
|-----|---------|------|--------|----------|--------|
| A → B | Contract / Model / Functional / Intrusive | ... | ... | ✅ / ❌ | Critical / Significant / Minor |
## 不均衡リスト
### Critical
- [統合名]: [問題の説明と根拠]
### Significant
- [統合名]: [問題の説明と根拠]
### Minor
- [統合名]: [問題の説明と根拠]
## 是正提案
| 統合 | 提案 | 優先度 | 影響範囲 |
|-----|------|--------|---------|
| ... | ... | High / Medium / Low | ... |
## 保留事項
- [追加調査が必要な項目]
| やりたいこと | やること |
|---|---|
| 既存コードの結合構造を分析したい | ステップ 1 から順に進める |
| 特定モジュール群だけ分析したい | ステップ 1 で対象範囲を限定する |
| 不均衡の是正策を提案してほしい | ステップ 3 の結果を基にステップ 4 で具体案を作る |
| design-and-plan で検出した課題を深掘りしたい | 該当モジュールを対象にステップ 1 から分析する |
plugins/happy-coding/skills/design-and-plan/SKILL.md — 設計の入口plugins/happy-coding/skills/design-and-plan/_foundation/DDD_GLOSSARY.md — 用語集plugins/happy-coding/skills/design-and-plan/SKILL.md — 是正策の構造判断plugins/happy-coding/skills/interview-with-docs/SKILL.md — 是正策を用語・前提・ADR と照合するときdocs/local_references/balanced-coupling/README.md — Balanced Coupling モデルの参照ガイドこんなときに使う: Ubuntu / Linux サーバーに SSH で接続し、sudo、systemd サービス、HTTP 監視を一連で安全に進めたいとき。 接続前に SSH_AUTH_SOCK を含む認証状態を固定し、認証で止まらずに サーバー接続・権限確認・サービス起動・停止・再起動・状態確認を一気に行いたいとき。
調査→修正→検証→ふりかえり/後続 Issue 化までを 1 つの改善ループで回したいときに使う。 実装前の再現確認や、review 指摘・検証結果をもとに次のアクションへつなぐ。
こんなときに使う: 現在の会話内容をもとに、実装・エージェント発注に直結する PRD を作りたいとき。 追加のインタビューはせず、すでに会話に出ている内容だけから構成する。 情報が不足している場合は捏造せず「未確定」として明示する。
こんなときに使う: ユーザーが「インタビューして」「質問して」「設計を詰めたい」などと言ったら使う。 計画や設計の重要な判断軸を洗い出し、具体例・反例・影響範囲まで深掘りして要件整理に落とす。
Copilot の custom skill / agent / repository instructions の作成・改善・構造確認を 1 つの入口にまとめる。複合スキルとして、対象に応じて適切な authoring ルートへ 分けつつ、実行時のモデル呼び出しを抑止してルーティングを優先する。試作から `plugins/*` 配布へ昇格するときの name / description 整備も扱う。skill / agent / repo-wide instructions / path-specific instructions を新規作成したいとき、既存定義を育てたいとき、公開前に責務や導線を確かめたいとき。
新しい custom agent を既存 agent 群と同じ型で立ち上げる。agent の新規追加、役割分離のための専門 agent 作成、既存群の隙間を埋めたいとき。