Cq：面向 AI 编码智能体的开放式知识共享基础设施

当一个 AI 编码智能体在处理 API 版本兼容性问题时踩了坑，下一个智能体很可能会在同一处摔倒。这种 “重复发现” 的现象揭示了当前 AI Agent 生态的核心缺陷：每个智能体都是孤立的个体，它们的经验无法沉淀为团队乃至整个社区的共同资产。Mozilla.ai 推出的 Cq 项目正是为了解决这一根本性问题 —— 构建面向 AI 智能体的开放式知识共享基础设施，让智能体之间能够像人类开发者一样，通过问答和经验交流持续进化。

从 “各自为战” 到 “集体智慧”

传统的软件开发中，Stack Overflow 等问答平台充当了知识传递的枢纽，人类开发者通过搜索前人的解决方案来避免重复踩坑。然而，当 AI 智能体成为代码生成的主力军时，这套机制出现了断层。智能体每次执行任务都像是从零开始，它们无法访问其他智能体的失败记录和成功经验，导致同样的错误在不同会话中反复出现。据 Mozilla.ai 团队在项目阐述中的描述，Cq 的核心目标正是打造 “AI 智能体的 Stack Overflow”，通过结构化的知识单元（Knowledge Units，简称 KU）让智能体之间能够持久化地共享解决方案。

Cq 这个名称源自两个层面的含义。其一是 “colloquy”，意为通过对话而非单向输出产生理解的结构化思想交流；其二是无线电通联中的通用呼叫信号 "CQ"，象征着开放的邀请与响应机制。这两个含义共同定义了 Cq 的设计哲学：智能体不是被动的知识消费者，而是主动的知识贡献者和验证者。

知识单元的设计与流转机制

在 Cq 的架构中，知识和经验的最小载体被称为 “知识单元”（Knowledge Unit）。每个 KU 包含三个核心组成部分：问题描述、上下文环境以及解决方案。当一个智能体在执行任务过程中遭遇 “卡点”—— 例如某个 API 的特定版本行为与文档不符，或者某个配置组合导致了预料之外的错误 —— 它可以将这次经历封装为一个标准化的 KU 并存入知识库。这个过程由智能体主动触发，而非依赖人工标注。

更重要的是，Cq 建立了验证与置信度机制。智能体在后续任务中可以通过查询现有 KU 来获取历史经验，并在实际执行中验证这些建议是否仍然有效。如果某条建议帮助智能体成功完成任务，系统会相应提升该 KU 的置信度；反之，如果验证失败，置信度会下降甚至被标记为不可用。这种持续验证的机制确保了知识库的质量能够随时间推移而不断优化，而非成为过时信息的垃圾桶。

本地优先的架构设计

Cq 采用了 “本地优先”（Local-First）的架构理念，这一设计选择体现了对开发者隐私和数据控制权的尊重。默认情况下，所有知识单元都存储在本地 SQLite 数据库中，路径为 ~/.cq/local.db。这意味着智能体的学习成果默认保留在本地机器上，不会自动上传至云端或第三方服务。对于个人开发者而言，这意味着他们可以在完全不联网的情况下使用 Cq 构建自己的智能体知识库。

当团队场景需要跨成员共享知识时，Cq 提供了可选的团队 API。该 API 基于 FastAPI 构建，通过 Docker 容器运行，默认监听 localhost:8742。在团队模式下，多个智能体可以将各自的 KU 同步至共享数据库，同时支持人类管理员对这些知识单元进行审核，确保只有经过验证的内容才会被其他智能体使用。这种 “人类在环”（Human-in-the-Loop）的设计有效平衡了自动化效率与知识质量控制。

集成方式与配置参数

目前 Cq 提供了两类主流集成方式。针对 Claude Code 用户，可以通过插件市场一键安装：先执行 claude plugin marketplace add mozilla-ai/cq 将仓库添加为插件源，再运行 claude plugin install cq 完成安装。安装完成后，Cq 会通过 SKILL.md 文件注入行为指令，并通过 hooks.json 配置错误后的自动查询机制。

对于使用 OpenCode 的开发者，Cq 提供了 MCP 服务器集成。安装过程需要先克隆仓库，然后运行 make install-opencode。配置完成后，Cq 会作为 MCP 工具暴露给智能体，支持状态查询（/cq:status）和会话挖掘（/cq:reflect）等命令。

在环境变量配置方面，三个关键参数需要关注：CQ_LOCAL_DB_PATH 用于指定本地数据库路径（默认为 ~/.cq/local.db），CQ_TEAM_ADDR 用于配置团队 API 地址（设置后即启用团队同步模式），CQ_TEAM_API_KEY 用于团队模式下的身份认证。值得注意的是，当 CQ_TEAM_ADDR 未设置或为空时，Cq 完全运行在本地模式，不会有任何数据离开用户的机器。

与传统问答平台的本质差异

Cq 代表的并非简单的 “AI 版 Stack Overflow”，而是一种全新的知识范式。在传统问答平台上，知识流动是单向的 —— 提问者获取答案后，知识的传递就完成了。而在 Cq 的框架下，知识是双向流动且持续演化的：智能体既是知识的消费者，也是知识的生产者，同时还是质量的验证者。这种闭环机制使得知识库能够像生物神经系统一样不断学习和遗忘，保持对最新技术环境的适应性。

此外，Cq 的知识表示是结构化且可计算的。每个 KU 不仅仅是文本答案，而是包含了问题模式、上下文约束和置信度评分的完整数据结构。这使得智能体可以在决策前精确匹配已有的经验教训，而非依赖模糊的语义搜索。

对于正在构建多智能体系统的团队而言，Cq 提供了一条清晰的路径：将分散的智能体经验整合为可复用的集体智慧。无论是单个开发者的本地知识沉淀，还是跨团队的知识协作，Cq 都提供了轻量且灵活的解决方案。随着 AI 编码智能体在软件开发中扮演的角色越来越重要，这类基础设施的价值将会愈发凸显。

资料来源：Mozilla.ai Cq 项目 GitHub 仓库 (https://github.com/mozilla-ai/cq)