はじめに
最近はコスト面からAIエージェントの利用を控えるよう指示が出ている、という話をよく聞くようになりました。
最近のAIモデルはたいへん優秀ですが、優秀が故やりすぎに見える動作が目につきます。例えば仕様書の一文を直しただけなのに、プロダクト全体を調べたり、修正から遠いところにあるコード評価を始めたりして、思うようにコストを抑えられない。そんな悩みも聞いています。
私も同じように悩んでおり、対策としてハーネスを試行錯誤しているところです。
今回はお久しぶりにお会いする皆さまと、この試作ハーネスを使いながら、品質とコストのバランスをどう取るか、検討できればと思っています。
こんなメンバーで学びます
主たる業務はPM業務。Codexの用途は、仕様書・設計書・手順書などの文書が7割、コーディングが3割くらい。AGENTS.mdに基本的な指示は書けるけれど、ハーネスはまだ構築していないPM仲間を想定しています。
サンプルを使って、導入から試します
今回の試作ハーネスは、AIに任せる作業の手順・役割・確認方法を整える仕組みです。今回はハーネステンプレートを教材に、AGENTS.md、Skills、役割設定、共有知見のつながりを見ていきます。
Codex公式の役割分担の考え方を参考に、このテンプレートでは調査・実装・レビュー・検証の4役割に分けています。メインが依頼を整理して必要な担当を呼び出し、各担当から受け取った要約をもとに判断・結果統合を行います。
各担当のSkillや役割設定には、図のような過剰作業を抑える指示を入れています。指示による抑制が実際の作業にどう働くかも、一緒に確認します。
ハンズオンは、既存リポジトリへの統合手順をもとに進めます。
- Git worktreeで導入用の作業場所を用意する
- 共有ファイルを選び、既存の指示・設定と統合する
-
uvでハーネス用のPython環境を準備する -
validate・checkと差分確認で導入結果を確認する
一緒に考えたいこと
文書の小さな修正とコード変更で、どこまで確認すれば十分か。重複した調査や検証をどう減らすか。
必要な品質を保ちながら、作業の大きさに合った確認で進めてもらうことを目指します。利用枠への効果も含め、サンプルを試しながら、自分たちの仕事に合うハーネスを一緒に探っていきましょう。