Community研究&データ分析github.com

chen-985211/circular-dependency-skill

循環依存関係を grep ではなく証拠とともに発見します。Python および JS/TS 向けの Codex スキルおよびノー・デペンデンシー・アナライザーです。

circular-dependency-skill とは?

このスキルは、Python および JavaScript/TypeScript プロジェクトにおける循環依存関係(circular dependencies)を自動的に検出し、その証拠を提示するための Codex スキルです。grep を用いた単純なパターンマッチングではなく、実際のインポート・依存関係のグラフを解析することで、循環が発生している箇所を正確に特定します。開発者はスキルを呼び出すだけでプロジェクト全体の依存関係をスキャンし、循環の原因となっているモジュールとその循環パスを可視化できます。これにより手動での調査時間を削減し、コード品質の向上やリファクタリングの計画立案に貢献します。Codex 上で動作し、追加の依存関係を必要としないため、すぐに利用可能です。

対応~Claude Code✓Codex CLI~Cursor
npx skills add chen-985211/circular-dependency-skill

Installed? Explore more 研究&データ分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

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

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

ドキュメント

circular-dependency-skill は何をしますか?

循環依存関係を grep ではなく証拠とともに発見します。Python および JS/TS 向けの Codex スキルおよびノー・デペンデンシー・アナライザーです。

概要

このスキルは、プロジェクト内の循環依存関係を自動的に検出し、それらの依存関係の証拠(どのファイルがどのファイルをインポートしているか)を提示します。grep では追跡が難しい複雑な循環も、依存関係グラフの解析によって正確に特定できます。

対応言語

  • Python(.py)
  • JavaScript / TypeScript(.js、.jsx、.ts、.tsx)

使用方法

  1. Codex 上でスキルを有効にします。
  2. 以下のコマンドを実行します:
codex circular-dependency --scan .

または特定のディレクトリを指定:

codex circular-dependency --scan ./src

オプション

オプション説明
--scanスキャンするディレクトリを指定
--exclude除外するファイル/ディレクトリのパターン(例:node_modules、__pycache__)
--format出力形式(text または json)

出力例

循環依存関係が見つかりました:

1. `module_a.py` → `module_b.py` → `module_c.py` → `module_a.py`
   証拠:
   - `module_a.py` が `module_b.py` をインポート(行 3)
   - `module_b.py` が `module_c.py` をインポート(行 5)
   - `module_c.py` が `module_a.py` をインポート(行 2)

注意事項

  • このスキルは追加の依存関係を必要としません。Python と JavaScript/TypeScript の標準ライブラリのみを使用して依存関係グラフを構築します。
  • 大規模プロジェクトでは解析に時間がかかる場合があります。その場合は --exclude オプションを使用してスコープを絞ってください。

ライセンス

MIT

関連スキル