スキルベースアーキテクチャ は何をしますか？
散らばったAIエージェントのルールを統一されたスキルベースアーキテクチャに整理し、制御性とモジュール性を向上させます。
概要
AIエージェント（Claude Code、Cursor、Codexなど）は、プロジェクトごとに様々なルールや指示を必要とします。しかし、これらのルールは.cursorrules、CLAUDE.md、プロンプトファイルなどに散在し、管理が困難になることがよくあります。
このアーキテクチャは、これらのルールを「スキル」としてモジュール化し、統一された方法で整理、ロード、優先順位付けする方法を提供します。
利点
- モジュール性: 各スキルは独立しており、再利用可能です。
- 保守性: スキルを個別に更新、テスト、バージョン管理できます。
- 制御性: スキルのロード順序と優先順位を明確に定義できます。
- 可読性: ルールが意味のあるグループに整理されます。
- スケーラビリティ: 大規模プロジェクトでもルールの整理が容易です。
構造
推奨ディレクトリ構造:
.skills/
├── core/ # 常にロードされる基本スキル
│ ├── security.skill.md
│ └── conventions.skill.md
├── languages/ # 言語固有のスキル
│ ├── python.skill.md
│ └── typescript.skill.md
└── frameworks/ # フレームワーク固有のスキル
├── react.skill.md
└── django.skill.md
各スキルファイル（.skill.md）は、特定のルールセットとメタデータを含むマークダウンファイルです。
スキルファイルの形式
---
name: python
version: 1.0.0
description: Python開発に関するルールとベストプラクティス
priority: high
---
# Python スキル
## コーディング規約
- PEP 8に従うこと。
- タイプヒントを使用すること。
## テスト
- pytestを使用してテストを書くこと。
- テストカバレッジは80%以上を目標とすること。
使用方法
このアーキテクチャを使用するには、エージェントのルールファイル（例：CLAUDE.md）から.skills/ディレクトリ内のスキルを動的にロードする指示を含めます。
例（CLAUDE.md）:
# プロジェクトルール
以下のスキルを`.skills/`ディレクトリからロードし、優先順位順に適用すること。
エージェントの実装に応じて、スキルのロードと適用方法は異なります。詳細は各プラットフォームのドキュメントを参照してください。
貢献
このアーキテクチャへの貢献を歓迎します。プルリクエストを送信する前に、既存のスキルとの互換性を確認してください。
ライセンス
MIT