aes - アグレッシブエンジニアリングプロトコル (AEP) は何をしますか?
SKILL.md - アグレッシブエンジニアリングプロトコル (AEP)
概要
AEP(アグレッシブエンジニアリングプロトコル)は、AIエージェントがコードベースに対して能動的かつ厳格なエンジニアリングレビューを実行するためのフレームワークです。このプロトコルは、開発者が見落としがちなパフォーマンスのボトルネック、セキュリティの脆弱性、設計上の欠陥、テスト不足などを自動的に検出し、具体的な改善提案を生成します。
対象プラットフォーム
- Claude Code(Anthropic)
- Cursor(Anysphere)
- Codex / GitHub Copilot(GitHub)
- その他のコード認識AIエージェント
プロトコルの動作手順
- コードベースのスキャン: エージェントはまず、指定されたプロジェクトの全ファイルを再帰的にスキャンします。
- 問題の特定: スキャン結果に基づき、以下のカテゴリで問題を特定します。
- パフォーマンスの問題
- セキュリティリスク
- コードスタイルの不整合
- 設計パターンの逸脱
- テストカバレッジの不足
- 優先順位付け: 発見された問題は、重大度(クリティカル / 高 / 中 / 低)で分類され、影響範囲と修正難易度に基づいて優先順位が付けられます。
- 改善提案の生成: 各問題に対して、具体的な修正コードと説明を含む改善提案を生成します。
- レポート出力: すべての分析結果と提案をまとめたMarkdownレポートを生成します。
評価基準
- パフォーマンス: アルゴリズムの効率性(時間計算量、空間計算量)、非効率なデータ構造の使用、不必要なAPIコール、メモリリークの可能性。
- セキュリティ: インジェクション脆弱性、認証バイパス、機密データの露出、依存関係の既知の脆弱性(CVE)。
- 保守性: コードの複雑度(サイクロマティック複雑度)、重複コード、命名規則、ドキュメンテーションの欠如。
- テスト品質: 単体テストの網羅性、統合テストの有無、エッジケースのテスト、テストの実行速度。
- 設計: SOLID原則の遵守、アーキテクチャの一貫性、適切な抽象化レベル、依存関係の管理。
提案テンプレート
各提案は以下の構造に従います:
### [重大度] [問題カテゴリ] - [概要]
**ファイル**: `path/to/file.ext`(該当行番号)
**現在のコード**:
```[言語]
[現在のコードスニペット]
問題の説明: [問題の詳細な説明]
推奨される修正:
[修正コードスニペット]
期待される効果: [修正により得られる改善点]
修正難易度: [簡単 / 中程度 / 難しい]
## 使用例
```bash
# Claude Code で使用する場合
claude --skill rodolfomatos/aes --path ./my-project
# Cursor で使用する場合(コマンドパレットから)
> Use Skill: rodolfomatos/aes
# Codex で使用する場合
@codex apply-skill rodolfomatos/aes
注意事項
- このスキルはAIエージェントの自律的な分析に依存するため、結果の正確性はエージェントの能力に依存します。
- 生成された提案はあくまで参考であり、本番環境に適用する前には必ず人間によるレビューを推奨します。
- 既存のCI/CDパイプラインと統合して使用することで、より効果的なコード品質管理が可能です。