Shared Knowledge MCP Server

--- description: AIコードエージェントとの効果的な対話方法とプロトコル ruleId: interaction-01jpcvxfxs0zr4jqmx1jn4f9re tags: - ai - interaction - communication aliases: - ai-interaction globs: - '**/*.ts' - '**/*.tsx' - '**/*.js' - '**/*.jsx' - '**/*.go' - '**/*.rs' - '**/*.scala' --- # AIエージェントとの対話プロトコル ## 概要 このドキュメントでは、AIコードエージェントとの効果的な対話方法とプロトコルを定義します。 明確なコミュニケーションを通じて、開発効率と成果物の品質を向上させることを目的とします。 ## 対話の基本構造 ### 1. タスクの定義 ```markdown 【タスク】。 - 目的：実装したい機能や解決したい問題を明確に説明。 - 要件：具体的な機能要件や制約条件を列挙。 - 期待する結果：完了の定義を明確に示す。 - 技術的制約：使用する技術スタックや制限事項。 【コンテキスト】。 - 既存のコードベースの関連部分。 - アーキテクチャの制約。 - 参考にすべき実装例。 ``` ### 2. 進捗の確認 ```markdown 【確認事項】。 - 現在の実装状況。 - 発生している問題。 - 次のステップ。 - 必要な追加情報。 ``` ### 3. フィードバック ```markdown 【フィードバック】。 - 具体的な改善点。 - 良かった点。 - 追加の要件や制約。 - 質問や確認事項。 ``` ## 効果的な指示の書き方 ### 1. 明確な目的 - 何を達成したいのかを具体的に説明。 - なぜそれが必要なのかの背景を提供。 - 期待する結果を明確に定義。 - 優先順位を示す。 ### 2. 具体的な制約 - 使用する技術スタック。 - パフォーマンス要件。 - セキュリティ要件。 - コーディング規約。 ### 3. 文脈の提供 - 関連するコードの場所。 - 既存の実装パターン。 - 依存関係。 - 注意すべき点。 ## コードレビューの依頼方法 ### 1. レビュー範囲の指定 ```markdown 【レビュー依頼】。 - 対象ファイル：。 - 重点的に確認して欲しい箇所：。 - 特に注意すべき点：。 - 確認観点：。 ``` ### 2. 具体的な確認項目 - コーディング規約との整合性。 - エラー処理の適切性。 - パフォーマンスへの影響。 - セキュリティ上の考慮。 ## トラブルシューティングの依頼 ### 1. 問題の説明 ```markdown 【問題報告】。 - 発生している現象：。 - 期待する動作：。 - エラーメッセージ：。 - 再現手順：。 ``` ### 2. 文脈の提供 - 関連するコード。 - 環境情報。 - 直近の変更内容。 - 試したこと。 ## ベストプラクティス ### 1. 効率的な対話 - 一度に1つの問題に焦点を当てる。 - 必要な情報を過不足なく提供する。 - 明確な質問を心がける。 - フィードバックは具体的に行う。 ### 2. イテレーティブな開発 - 小さな単位で進める。 - 各ステップで確認する。 - フィードバックを積極的に提供する。 - 方向性の調整を適時行う。 ### 3. 文書化 - 重要な決定事項を記録する。 - 解決した問題と方法を文書化する。 - 学んだ教訓を共有する。 - ベストプラクティスを更新する。 ## 関連情報 - [API設計・ドキュメント作成ガイドライン](../development/api/guidelines-01jpcvxfxqe37ka9pn3xb4m9ys.md) - [AIエージェントの機能と制限](capabilities-01jpcvxfxs0zr4jqmx1jn4f9rh.md) - [AIエージェント活用のベストプラクティス](best-practices-01jpcvxfxs0zr4jqmx1jn4f9rj.md) - [AIエージェントのトラブルシューティング](troubleshooting-01jpcvxfxra1qd2v1btrrz4s2z.md)