模块总览
oagentkit 是 13 个独立发版的 Go 模块，依赖严格自底向上，每仓独立 SemVer + 独立 CI。
每个仓库根目录都有
AGENTS.md—— 面向 AI Agent 的权威规范与硬规则。
tier 0 · 基础层
零仓内依赖或仅依赖同仓包
| 模块 | 说明 | 仓内依赖 |
|---|---|---|
guardx | 脱敏/出口围栏/权限判定/沙箱档位/跨进程协议 | — |
runtime | agent 进程运行时——流式节控/泛型事件总线/子进程环境/热插拔/钩子 | — |
textx | 文本/差异/会话/报告纯函数集 | — |
tier 1 · 能力层
依赖 tier 0
| 模块 | 说明 | 仓内依赖 |
|---|---|---|
promptx | system prompt 分段组装/运行中转向/文件读后写一致性 | runtime、textx |
tier 2 · 集成层
依赖 tier 0/1 + 重第三方地板
| 模块 | 说明 | 仓内依赖 |
|---|---|---|
llm | 模型客户端/降级链/预算/成本/阶段路由/调用观测 | textx |
mcpkit | MCP 客户端/工具池/建连单飞 | runtime |
obs | 观测客户端 + 审计留痕 | guardx |
queue | DB 即队列 + Postgres 选主 Lease | — |
rag | 知识检索——向量化/混合召回/重排 | textx |
skillkit | SKILL.md 渐进披露 + 领域包契约 + 装配血缘 | textx、guardx |
toolgate | 工具优先级/并发调度/操作审计门/不可绕过的调用链 | guardx、mcpkit |
tools | CLI 编码 agent 统一调用/公开检索/git 沙箱/SAST 扫描/Shell 静态裁决 | textx、runtime、guardx |
tier 3 · 编排层
依赖 llm 等 tier 2 门面
| 模块 | 说明 | 仓内依赖 |
|---|---|---|
agent | ReAct 运行样板/反思循环/意图路由/多专家黑板/派发守卫/澄清 | llm、textx |
基建仓
| 仓 | 角色 |
|---|---|
agentkit | 门面仓——46 包 re-export 零逻辑，发 v1.0.0 后按 README 写死的期限退役 |
.github | org profile + 共享 reusable workflow（照抄 oekit/.github，改 org 与域名） |
matrix-tools | 版本矩阵生成/审计/巡检（照抄 oekit/matrix-tools：gen_versions.py、ekit2oekit.py 同源思路） |
oagentkit.github.io | llms.txt 模块索引 + 文档站点 |
已退役的包：breaker
breaker 已从本矩阵移出，迁往 github.com/oekit/concurrency/breaker。退役是分阶段完成的——消费方先改依赖上游、上游能力补齐，最后才删包，任何一步提前做都是构建断裂。
- 消费方：llm/breaker.go —— 只做按模型名分桶 + 转发，不再有任何本地语义兜底
- 上游需求链（全部已关闭）：
- 状态：已完成：llm v0.4.0 起全量使用上游 GenBreaker
退役完整时间线见 runtime 模块页 的「本仓硬规则」。
已移除的包
<root>—— 仓根 integration_test.go 依赖全部包，拆分后无处安放