概览
了解 CodeIQ 解决什么问题，以及它适合怎样的团队与工作流。
CodeIQ 是什么？
CodeIQ 是一个面向第三方库、Terraform Module 与 OpenAPI 规格的声明级索引与变更治理工具。它的目标不是替代源码本身，而是把仓库中的公开接口、契约与可追溯证据整理成更适合开发者和 AI 使用的标准化产物。
相较于只依赖文档或纯文本检索的方案，CodeIQ 更强调 声明级事实 与 可追溯的查询入口：函数、类型、模块、接口、配置契约、API schema 等公开结构会被整理成 CIQ Bundle、CIQ Diff、CIQ Result 等标准化对象，再通过 CLI 或 MCP 提供给开发流程使用。
它适合哪些场景？
- SDK 发版前的兼容性检查：确认这次改动是否删除了公开 API，是否会破坏升级路径。
- 平台能力统一交付：把代码、Terraform Module、OpenAPI 和策略规则一起沉淀为可复用资产。
- AI 辅助开发：让 AI 先基于 bundle 大纲理解公开接口，再对具体 symbol 做精确查询。
- 高风险变更审查：把差异和 policy 结果输出为
SARIF，接入现有 CI 与代码审查流程。
CodeIQ 提供什么？
| 能力 | 对最终用户的价值 | 当前定位 |
|---|---|---|
CIQ Bundle | 把仓库变成可复用上下文资产 | 当前核心 |
CIQ Diff + SARIF | 支持发版前差异检查与策略门禁 | 当前核心 |
CodeIQ Registry | 缓存、分发和版本化 bundle | 当前核心 |
| MCP 查询工具 | 让 AI 按 outlines → symbol 的顺序理解依赖 | 当前核心 |
| 更大规模的治理与分析 | 面向更复杂的团队与平台场景 | 路线图 |
它与纯文档检索有什么不同？
CodeIQ 的起点是代码和规格文件，而不是 README 或外部文档。
- 如果文档过时、缺失或与实现不一致，单纯依赖文档索引会降低 AI 输出的可靠性。
- 如果你需要把结果接入代码审查或自动化流程，那么可追溯、可比较的声明事实会更重要。
- 如果你需要让 AI 理解一个第三方库，先看 outlines 再查 symbol，比直接在大仓库里盲目搜索更稳定。
使用 CodeIQ 时需要了解的边界
- 它优先解决“公开接口与契约如何被稳定提取、比较和查询”这个问题，而不是试图一次性替代完整静态分析平台。
- MCP 只负责本地常驻查询；
build、diff、check、publish仍然属于 CLI。 - 在高风险门禁场景中，CodeIQ 关注的是公开接口变化，不负责实现级控制流、数据流或漏洞分析。