Context

统一上下文 I/O (context)

文档生命周期的单一能力入口(cataforge context,其文件后端引擎为 cataforge docs),后端路由纪律见 COMMON-RULES §Agent 文档 I/O 契约。后端能力非对称:读取/生成/校验按方案路由且在后端不可达时降级;关系追溯(query 分支)是图原生能力,需图后端就绪(无对等文件回退)。

能力边界

• 能做: 按需加载章节/实体、依赖与追溯查询、文档生成与写入、单文档与跨文档门禁校验
• 不做: 内容决策(由调用 Agent 负责)、代码审查(由 code-review 负责)、框架元资产审查(由 framework-review 负责)

输入规范

• 操作分支: navigate | generate | review | consistency | query
• 引用: doc_id#§N[.item](格式见 COMMON-RULES §文档引用格式)
• 各分支的参数与命令见对应 reference 文件

输出规范

• 读取: 目标章节/实体内容(markdown 形式,后端无关)
• 查询: 依赖/追溯结果
• 生成/写入: authoring 落图 + 定稿导出路径
• 校验: 审查/一致性报告 + 三态结论

操作指令

按意图选分支,详见 reference:

1. navigate — 按需读取章节/实体、依赖展开、token 预算。见 references/navigate.md
2. generate — 取模板、authoring 落图、定稿导出、拆分。见 references/generate.md
3. review — 单文档门禁(脚本检查 + 语义审查)。见 references/review.md
4. consistency — 跨文档一致性(覆盖矩阵、契约对齐)。见 references/consistency.md
5. query — 自然语言追溯查询。见 references/query.md

Anti-Patterns

• 禁止: 一次性 Read 超过 200 行的整篇文档 — 按章节/条目加载是核心价值,全文 Read 吃掉数千 token 还引入无关噪声
• 禁止: 在调用面判断"该走哪个后端" — 后端选择由框架路由,prompt 里复述分发条件会随实现漂移
• 禁止: 跳过 generate 的定稿步骤直接退出 — 定稿负责持久化与事件写入,跳过会让后续读取/校验找不到新内容
• 避免: 同一会话重复加载同一章节 — 内容已在上下文,重复加载浪费 turn 和 token