← 返回藏书阁

AIGX — AI Genome Exchange

wiki/ai/sources/aigx-context-format.md
分类:ai / sources · 更新:2026-07-14 09:04

AIGX — AI Genome Exchange

AIGX 是一个面向 AI coding agents 的开放上下文格式。它把代码库的 agent rules、per-file boundary index、gotchas 和约束集中放在 .aigx/ 目录,而不是把大量注释或规则注入源码。项目声称其格式经过 controlled benchmark 验证,并支持多语言/多工具链。

为什么对用户重要

用户的知识库已经沉淀了 AGENTS.md-Context-FilesContext-EngineeringExternal-Agent-Skills-Design-Patterns 等方向。AIGX 的价值在于提供了一个更结构化的假设:仓库上下文不应只有一份线性 instruction file,而可以拆成 中央规则 + 文件边界索引 + 禁止依赖/导入 + gotchas,由 agent 在需要时定位相关上下文。

这对 Hermes/llm-wiki 有直接启发:当前 wiki 页面是人的知识组织方式,而 agent 执行任务还需要更“可路由”的 manifest 层。AIGX 可以作为观察对象,帮助判断 AGENTS.md、skills、wiki page、repo index 之间如何分工。

机制 / 一阶原理

AIGX 的核心机制不是“多写一份说明”,而是把 context 变成可寻址 genome:

  1. .aigx/ 作为独立 context 根目录,避免污染源码。
  2. per-file boundary index 把规则与文件/模块边界绑定,减少 agent 在全局规则中搜索。
  3. forbidden imports、gotchas、local conventions 等约束变成结构化条目,而不是散落在 README 或代码注释中。
  4. 工具链负责生成、校验和分发格式,让不同 coding agent 能消费同一套上下文。
它与 [[ratel-context-engineering-tool-selectionRatel]] 的思想相近:上下文和工具都不应全量注入,而应通过 catalog/index 按需暴露。AIGX 关注仓库内代码上下文,Ratel 关注工具/skill schema;二者都指向 capability/context routing。

与既有 wiki 概念的关系

  • Context-Engineering:AIGX 是“结构化、可路由、可测试的仓库上下文”案例,补足 AGENTS.md 的线性文本局限。
  • Agentic-Coding:如果 agent 找错文件边界或违反本地约束,生成能力再强也会失败;AIGX 试图降低这类探索/约束错误。
  • Harness-Engineering:上下文格式本身也属于 harness,因为它限制并引导 agent 的行动空间。

对 Hermes / llm-wiki 的可执行启发

  1. llm-wiki 可以增加轻量“page/skill manifest”思想:每个重要 skill/page 暴露触发条件、风险边界、验证方式、相关页面,而不是只依赖正文检索。
  2. 对代码仓库任务,优先识别是否存在 AGENTS.md、.aigx/.cursor/rules.claude/ 等上下文根;这些应进入 repository exploration checklist。
  3. 若未来为 Hermes 自身建立工程上下文,可避免把所有规则堆进一个长文件;改用 category/index + boundary/gotcha 结构。

失败模式 / 边界

  • AIGX 的 README 带有较强推广语气;其 benchmark claims 需要进一步读 BENCHMARK.md、标准文档和实验设置后才能提高置信度。
  • 结构化上下文会引入维护成本;如果索引过期,agent 可能比没有索引更糟。
  • 多格式生态可能碎片化:AGENTS.md、AIGX、Cursor rules、Claude skills、OpenCode config 都在争夺上下文标准位置。短期更稳的是抽取可迁移设计模式,而不是押注某一格式。

写入记录

  • 2026-07-14 09:00 CST:新增 AIGX 来源页,提炼结构化仓库上下文、boundary index 与 llm-wiki manifest 化启发。