Shared Knowledge MCP Server

--- description: AIコードエージェントの機能、制限、および利用可能なツール ruleId: capabilities-01jpcvxfxs0zr4jqmx1jn4f9rh tags: - ai - capabilities - limitations aliases: - ai-capabilities globs: - '**/*.ts' - '**/*.tsx' - '**/*.js' - '**/*.jsx' - '**/*.go' - '**/*.rs' - '**/*.scala' --- # AIエージェントの機能と制限 ## 概要 このドキュメントでは、AIコードエージェントが提供する機能と、その制限事項について説明します。 開発者がAIエージェントの能力を最大限に活用できるよう、具体的な使用方法と注意点を提供します。 ## 利用可能な機能 ### 1. コードベース操作 #### コード検索 - セマンティック検索による関連コードの特定。 - 正規表現を使用した精密な検索。 - ファイル名やパスによるファイル検索。 #### コード編集 - 新規ファイルの作成。 - 既存ファイルの編集。 - ファイルの削除。 - コードのリファクタリング提案。 #### コード分析 - コードの意図の理解。 - 依存関係の分析。 - 潜在的な問題の特定。 - 改善提案の生成。 ### 2. 開発支援 #### ドキュメント生成 - コードドキュメントの作成。 - APIドキュメントの生成。 - 使用例の提供。 - README.mdの作成。 #### テスト支援 - テストケースの提案。 - テストコードの生成。 - エッジケースの特定。 - テストカバレッジの分析。 #### デバッグ支援 - エラーの解析。 - デバッグ手順の提案。 - ログ出力の改善提案。 - トラブルシューティングガイドの提供。 ### 3. プロジェクト管理 #### タスク管理 - タスクの分割提案。 - 実装手順の提案。 - 進捗の追跡。 - リスクの特定。 #### コードレビュー - コードの品質チェック。 - セキュリティ上の問題の特定。 - パフォーマンスの分析。 - ベストプラクティスの提案。 ## 制限事項 ### 1. 技術的制限 #### 知識の制限 - 知識カットオフ日以降の情報は持っていない。 - 特定の専門分野に関する深い知識は限定的。 - プロジェクト固有の文脈理解には限界がある。 #### 実行の制限 - 直接的なコード実行は不可。 - 外部システムとの直接的な通信は不可。 - 大規模なファイル操作には制限がある。 #### 理解の制限 - 複雑な文脈の完全な理解は困難。 - 暗黙的な要件の理解には限界がある。 - 自然言語の微妙なニュアンスの理解に制限。 ### 2. 運用上の制限 #### リソース制限 - 同時実行数の制限。 - 処理時間の制限。 - メモリ使用量の制限。 - トークン数の制限。 #### アクセス制限 - 特定のファイルやディレクトリへのアクセス制限。 - 外部リソースへのアクセス制限。 - セキュリティ上の制限。 ## 推奨される使用方法 ### 1. 効果的な機能活用 #### コード生成 - 明確な要件と制約の提供。 - 段階的な実装の依頼。 - フィードバックの積極的な提供。 - イテレーティブな改善。 #### コードレビュー - レビュー範囲の明確な指定。 - 具体的な確認項目の提示。 - 文脈情報の十分な提供。 - フィードバックの具体的な説明。 #### デバッグ支援 - 問題の詳細な説明。 - 再現手順の提供。 - エラーメッセージの共有。 - 試した解決策の説明。 ### 2. 制限事項への対応 #### 知識の補完 - 最新情報の明示的な提供。 - プロジェクト固有の文脈の説明。 - 参考資料やドキュメントの共有。 #### 実行制限の回避 - ローカルでの実行結果の共有。 - 段階的な変更の確認。 - 手動でのテスト実行。 ## ベストプラクティス ### 1. 効率的な利用 - 明確な目的と要件の提示。 - 必要な文脈情報の提供。 - 段階的な実装の依頼。 - フィードバックの積極的な提供。 ### 2. 品質の確保 - 生成されたコードの確認。 - テストの実施。 - セキュリティチェック。 - パフォーマンス検証。 ### 3. 継続的な改善 - フィードバックの記録。 - 成功事例の共有。 - 問題点の文書化。 - プロセスの改善。 ## 関連情報 - [API設計・ドキュメント作成ガイドライン](../development/api/guidelines-01jpcvxfxqe37ka9pn3xb4m9ys.md) - [AIエージェントとの対話プロトコル](interaction-01jpcvxfxs0zr4jqmx1jn4f9re.md) - [AIエージェント活用のベストプラクティス](best-practices-01jpcvxfxs0zr4jqmx1jn4f9rj.md) - [AIエージェントのトラブルシューティング](troubleshooting-01jpcvxfxra1qd2v1btrrz4s2z.md)