AITM 中的每个 AI 会话 — 无论是编码者、审查者,还是当前正在进行的 Chat — 都使用同一个共享的、始终保持最新的知识库,而不是从一张白纸开始。

知识与文档共享

Contracts — 项目的事实说明

Contract 是一条保存下来的事实,描述项目中某个具体部分的行为 — 一份小型的结构化笔记,说明代码的某部分做什么、涉及哪些文件,以及需要注意什么。Contracts 在 Task 合并后根据实际发生的变化自动创建和更新。在编写任何代码之前,Agent 会读取与其任务相关的 Contracts,看到被标记的“危险区域”(即历史上小改动曾造成严重后果的地方),并能找到先前触及同一区域的 Task 作为先例。

知识图谱

Contracts 并不是孤立存在的。AITM 为每个项目维护一个知识图谱,将变量(如 UI.PANEL.CHAT 或 BL.PIPELINE 这样的点号表示法代码)、Contracts、DOM 元素、截图和文档相互关联起来。查找一个变量,就能找到与之相连的 Contracts、文件和截图;查找一个 Contract,就能找到它所管辖的变量和文件。

知识图谱 — 文件依赖
知识图谱 — 文件依赖。
知识图谱 — 跨文件关系
知识图谱 — 跨文件关系。

可以通过 Variable Explorer 自行浏览该图谱,它支持搜索变量、深入查看其详情,并查看与 UI 元素关联的任何截图预览。

Hints — 可复用的内部规则

Hints 是用户(或过去的某个 Task)教给 AITM 的简短独立规则,之后会自动应用 — 例如命名约定或响应结构。在 Agent 开始某个步骤之前,AITM 会自动找出与其即将执行的操作相关的 Hints,并将其纳入上下文,因此无需在创建的每个 Task 中重复同样的约定。

共享的 Agent 模板

每个 Pipeline 步骤的 AI 提示词都是分层组装的:Provider 前导部分、所有步骤通用的共享模板、该步骤自己的 Agent 指令、可选的项目级覆盖,最后是用户自己的自定义内容。这种分层保证每个 Pipeline 步骤和每个 AI Provider 都获得完全相同的项目约定和规则 — architect 所知道的与 coder 所遵循的之间不会产生偏差。

步骤之间的交接(Handoff)

每个 Pipeline 步骤结束时都会输出一个结构化的、机器可读的 handoff 块。该块成为下一步骤的起始上下文,弥合了两个原本全新的 AI 会话之间的鸿沟 — 并且由于 handoff 格式与 Provider 无关,无论下一步骤运行在 Claude、Gemini、DeepSeek 还是 Ollama 上,工作方式都完全相同。

共享会话组

Architect、Code、Review 和 Fix 可以在同一个连续的 AI 对话中运行,而不是四个相互割裂的对话。这意味着实现者仍然记得架构步骤中的设计决策,而审查者也仍然记得实现者是如何推理该变更的。

自动生成的文档

每次合并之后,AITM 都会重新生成按模块的知识文档、项目范围的知识摘要和可搜索的索引。文档、doc-contracts 和 doc-pointers 被索引到按项目的 SQLite 数据库中,并直接链接到变量和 Behavioral Contracts,因此跨 Task 的引用能让功能演进在原始 Task 归档很久之后仍可追溯。

Brainstorm、Chat 与外部 Agent

来自 @KEYWORD Brainstorm 会话的结论可在任何未来的 Task 提示词中复用。Chat 本身由缓存的知识摘要提供支持,因此无需每次重新读取整个仓库就能回答项目问题。并且由于整个知识库位于同一个 GraphQL 端点之后,MCP 服务器也可以将其开放给外部 AI Agent。

提示

  • 在 Brainstorm 会话中使用 @KEYWORD 将结论记录一次,即可在之后触及同一区域的每个 Task 中复用。
  • 如果要跨 Provider 评估某个变更,共享的 handoff 格式意味着在 Pipeline 中途切换 Provider 不会丢失上下文。
  • 自动生成的文档意味着,对于 AITM 已经维护的模块,几乎不需要手写 README。