indexion-agent-orient は何をしますか？
コードエージェントが実装前に、コードの所有者、影響範囲、および安全でない編集箇所を学習するための事前編集構造ブリーフを生成して使用します。
概要
このスキルは、AIコードエージェントがコードベースの構造を事前に理解するための「構造ブリーフ」（Structure Brief）を生成します。これにより、エージェントは以下の情報を把握した上で編集を行えます：
- コード所有者: 各ファイルやモジュールの責任者またはチーム
- コンシューマーサーフェス: 変更が影響を与える可能性のあるAPI、UI、ワークフロー
- 安全でない編集箇所: 危険なリファクタリング箇所、共有リソース、依存関係のクリティカルパス
使用方法
-
構造ブリーフを生成するには、以下のコマンドを実行します：
orient generate ./path/to/project -
生成されたブリーフは
structure-brief.mdとして保存されます。 -
ブリーフをエージェントのコンテキストに含めるには：
@structure-brief.md
サポートされるプラットフォーム
- Claude Code
- Cursor
- Codex (GitHub Copilot)
- その他のAIエージェント（カスタムプロンプトで対応可能）
動作の仕組み
構造ブリーフは、プロジェクトのファイル構造、インポートパス、コメント、ドキュメントを解析して自動的に生成されます。解析結果をもとに、各ファイルの役割と所有権、外部への影響範囲、および編集時に注意すべき危険領域を特定します。エージェントはこのブリーフを事前に読み込むことで、より安全で文脈に適したコード変更を行うことができます。
注意事項
- 構造ブリーフは静的なスナップショットであり、プロジェクトの変更に応じて定期的に再生成する必要があります。
- すべてのコードベースで正確に機能するとは限らないため、必要に応じて手動で調整してください。
- ブリーフ内の情報は参考として使用し、エージェントの判断を完全に置き換えるものではありません。