Pi上で開発チーム向け共有AIハーネスを構築した方法

著者は、開発チーム向けの共有AIハーネスを設計しました。これは、'agent'という専用のGitリポジトリを中心にしています。このリポジトリには、プロジェクトの説明、ドキュメント、Pi設定、および内部CLI統合用のスキルが含まれています。ワークスペースには、メインアプリケーション、インフラストラクチャ、Terraform、Telegramボット、分析、およびQA用の兄弟リポジトリが含まれています。AGENTS.mdファイルは、エージェント向けのプロジェクトマップとルールを提供し、必要に応じて関連する兄弟リポジトリやドキュメントを読むようにガイドします。スキルは、CLIを使用するタイミングを指定するSKILL.mdファイルで定義され、YouTrackでタスクを読んだり作成したりするなどの運用指示への参照も含まれます。資格情報は、Gitに含めないように環境変数を介して渡されます。ハーネスは、タスクの準備、問題の調査、変更の実施、データに関する質問への回答、本番環境の確認など、さまざまなシナリオをサポートしています。Telegram統合では、同じハーネスをチャットアシスタントを介して使用し、エージェントをGitサブモジュールとして固定して、一貫したコンテキストを確保します。セットアップには、チャットアクセスの制限、スコープ付き資格情報、読み取り専用の本番データベース、変更操作の承認などの安全対策が含まれています。