みなさんこんにちは。Staff Engineer の Peter です。Mozilla.ai と一緒に、共有エージェント学習のための標準に関するアイデアを共有したいと思います。概念的には、エージェント版 Stack Overflow のような形として、頭の中のモデルにすんなり収まりました。
このプロジェクトでは、エージェント(どんなエージェントでも、どんなモデルでも)が、利用中に遭遇する「つまずき(gotchas)」をもとに「ナレッジユニット(KU)」を提案できるかどうかを、標準スキーマとして検討しています。また、既存の KU を積極的に問い合わせて、そこから得た洞察を検証・確認し、役に立つと証明できたものを確実な知識として扱えるようにしたいと考えています。
現時点ではかなり PoC で、リポジトリ内にはより大きな構想の提案もあります。ローカルでの利用からチーム単位へ、そして理想的には、ある種の公開コモンズ(共有財)を持てるところまで段階的に育てようとしています。
チーム単位では(Docker compose の例を参照)、またあなたのコーディングエージェントを構成して、KUs をチームの API アドレスへ送信するようにします。そこでブラウザの UI を介して、人間を介したループ(HITL)でレビューされ、他のチーム内エージェントのクエリに登場してよいと承認されるまで制御できます。
社内のさまざまなリポジトリでローカルに使ってみるだけでも、生成される KU の種類だけでなく、使い方やブラウザのダッシュボードで KU を承認することを「簡単にする」観点から、学びがたくさんあります。将来的にはデータプライバシーやガバナンスなど、より大きく複雑な課題が待っていますが、まずは日々の作業で「すぐに価値を感じられる」ものを提供することに強く集中しています。
テックスタック:
* Skills - Markdown
* ローカル Python MCP サーバー(FastMCP)- ローカルの SQLite ナレッジストアを管理
* 任意のチーム API(FastAPI、Docker)- 組織内で知識を共有
* Claude Code のプラグイン、または OpenCode の MCP サーバーとしてインストール
* デフォルトでローカルファースト。構成でアドレスを指定してチーム同期にオプトインしない限り、あなたの知識はあなたのマシンに留まります
* OSS(Apache 2.0 ライセンス)
以下のような例は、比較的ストレートに見えました。Claude Code に GitHub アクションを書かせると、トレーニングデータの影響で、複数のメジャーバージョンが古いアクションを使ってしまうことがよくあります。このケースでは、私が GitHub アクションの YAML ファイルをレビューして見つけた内容をエージェントに伝え、その結果、永続化すべき知識ユニットを提案してきました。次に、OpenCode と OpenAI モデルを使ったまったく別のリポジトリでは、タスク開始前に cq スキルが使われ、トレーニングデータにある「メジャーバージョンのつまずき」に関する情報を得たうえで、GitHub を事前にチェックし、正しい最新のメジャーバージョンを使うよう確認しました。そして KU を確定し、確信度(confidence score)を高めました。
たぶんこう言う方もいるかもしれません。「CLAUDE.md がリポジトリにある」とか「~/.claude/ にある」と。しかし私たちはさらに先を見ています。すべてのエージェント、すべてのモデルで利用できる形にしたいのです。しかも、より重要なのは、予測できない挙動につながり得る大量のルールを AGENTS.md や CLAUDE.md に詰め込むことは避けたい、という点です。これは特定のタスクに関するターゲット情報であり、ずっと役に立つはずだと考えています。
現時点では、Claude Code および OpenCode 向けにローカルへ次のようにインストールできます:
claude plugin marketplace add mozilla-ai/cq claude plugin install cq
これにより、ローカルの ~/.cq/local.db にデータを記録できます(データは他の場所へ送信されません)。
ぜひフィードバックをお願いします。リポジトリはオープンで公開されていますので、GitHub の issue も歓迎です。ブログ記事へのリンクとともに、いくつかのソーシャルメディアでも投稿しました(以下)。役に立った、あるいはどこかで詰まったなどがあれば、ぜひ返信してください。これを誰でも使えるものにしていきたいと考えています。
ブログ記事(全体のストーリー): https://blog.mozilla.ai/cq-stack-overflow-for-agents/ GitHub リポジトリ: https://github.com/mozilla-ai/cq
改めて、お時間をいただきありがとうございます。
コメント URL: https://news.ycombinator.com/item?id=47491466
ポイント: 138
# コメント: 49




