Shared Knowledge MCP Server

--- description: AIエージェントとの効果的な協働のための基本原則とガイドライン ruleId: collaboration-01jpcvxfxs0zr4jqmx1jn4f9rg tags: - ai - guidelines - best-practices - index aliases: - ai-guidelines-index globs: - '**/*.ts' - '**/*.js' - '**/*.jsx' - '**/*.tsx' - '**/*.py' --- # AIエージェントの基本原則 ## 概要 このドキュメントは、AIエージェントとの効果的な協働のための基本原則とガイドラインを提供します。 チーム全体で一貫したAIエージェントの活用を実現し、開発効率と成果物の品質を向上させることを目的とします。 ## 基本原則 ### 1. 明確なコミュニケーション - 具体的で明確な指示を提供する。 - 目的と期待する結果を明確に説明する。 - 必要な文脈情報を適切に提供する。 - フィードバックは具体的に行う。 ### 2. 段階的な開発 - 大きなタスクは小さな単位に分割する。 - 各ステップでの成果物を確認する。 - イテレーティブな改善を心がける。 - 方向性は適宜調整する。 ### 3. 品質管理 - 生成されたコードを必ずレビューする。 - テストケースの作成と実行を確認する。 - セキュリティ考慮事項を遵守する。 - パフォーマンスと保守性を重視する。 ## 制限事項 ### 1. 技術的制限 - 知識のカットオフ日に注意。 - プロジェクト固有の文脈理解には限界がある。 - 複雑な要件の完全な理解は困難。 - 生成コードの品質にばらつきがある可能性。 ### 2. 運用上の制限 - 同時実行の制限に注意。 - レスポンス時間の変動を考慮。 - トークン制限を意識。 - 外部システムとの直接通信は不可。 ## 効果的な利用方法 ### 1. タスク定義 ```markdown 【タスク定義のテンプレート】。 1. 目的。 - 実装したい機能や解決したい問題。 - 達成したい成果。 2. 要件。 - 機能要件。 - 非機能要件。 - 制約条件。 3. 文脈情報。 - 既存のコードベース。 - 技術スタック。 - アーキテクチャ制約。 ``` ### 2. レビューとフィードバック ```markdown 【フィードバックのテンプレート】。 1. 改善点。 - コードの品質。 - 実装の妥当性。 - セキュリティ考慮事項。 2. 具体的な指摘。 - 問題のある箇所。 - 期待する修正内容。 - 参考情報。 3. 肯定的なフィードバック。 - 良い実装。 - 効果的なアプローチ。 ``` ## 詳細情報 AIエージェントの活用に関する詳細な情報は、以下のドキュメントを参照してください：。 - [API設計・ドキュメント作成ガイドライン](../development/api/guidelines-01jpcvxfxqe37ka9pn3xb4m9ys.md) - AIエージェントの利用に関する基本的な規約 - [AIエージェントの機能と制限](capabilities-01jpcvxfxs0zr4jqmx1jn4f9rh.md) - 利用可能な機能と制限事項の詳細 - [AIエージェントとの対話プロトコル](interaction-01jpcvxfxs0zr4jqmx1jn4f9re.md) - 効果的な対話方法とプロトコル - [AIエージェント活用のベストプラクティス](best-practices-01jpcvxfxs0zr4jqmx1jn4f9rj.md) - 効果的な活用のためのプラクティス集 - [AIエージェントのトラブルシューティング](troubleshooting-01jpcvxfxra1qd2v1btrrz4s2z.md) - 問題解決のガイドライン ## 関連情報 - [開発の掟](../development-01jpcvxfxa9zn7yzy0qtmgyq95.md) - [タスク管理の掟](../task-management-01jpcvxfxa9zn7yzy0qtmgyq94.md) - [ツールの掟](../development/tools-01jpcvxfxbfm6z9tc89zm9c37b.md)