mathomhaus/guild

代理公会 (The Agent Guild) – 快速概览

它是什么 – Guild 是一个单一二进制 Go 程序，运行一个由嵌入式 SQLite 数据库支持的本地 MCP (Multi-Client Protocol) 服务器。它为 AI 编码代理（Claude Code, Codex, Cursor 等）存储共享上下文、内存和任务看板。代理可以领取任务、读写“知识”条目并留下简短笔记，以便每个新工作阶段都能从上一次中断的地方精确接续。

主要功能

• 混合检索 – 搜索结合了 BM25 关键词匹配与向量相似度（通过嵌入式 ONNX 嵌入器或可选的 Ollama 端点）。这让代理能在同一个查询中找到精确词汇和语义匹配。
• 原子任务领取 – 代理在处理任务前会先锁定该任务，防止多个代理互相干扰。
• 持久状态 – 所有数据（任务、知识、誓言、摘要）都存储在 ~/.guild/ 下的本地 SQLite 文件中（或 Docker 数据卷）。状态在编辑器重启、容器重启，甚至在不同支持 MCP 的编辑器之间切换时依然存在。
• 代理模式 CLI – 当从 AI 代理调用时，指令会发出单一 JSON 封装（通过 --agent 标志、GUILD_AGENT=1 或自动检测），以便代理无需屏幕抓取即可解析结果。
• 生命周期钩子 – guild hooks install 可以写入编辑器特定的钩子文件（Claude Code, Codex），以便在工作阶段开始时自动注入上下文，并在压缩前进行截取。

典型工作流程

1. 安装 – 通过提供的脚本、Homebrew 或 Docker 下载预先构建的二进制文件（包含语义检索）。
2. 初始化项目 – guild init 注册仓库、创建 AGENTS.md 区块，并向任何检测到的 MCP 客户端注册项目。
3. 开始工作阶段 – 代理调用 guild_session_start(project="myapp") 并接收项目誓言、最后的摘要以及最高优先级的任务。
4. 工作 – 代理领取任务 (guild quest accept …)、搜索知识 (guild lore appraise …)、记录新观察 (guild lore inscribe …) 并记录进度 (guild quest journal …)。
5. 完成 – 代理撰写摘要并完成任务；后续任务将对下一个代理开放。

为什么这很重要 – 大型语言模型编码助手具有极小的上下文窗口，且在工作阶段结束后会忘记之前的操作。Guild 为它们提供了持久、可搜索的内存和协调的任务看板，使多个代理（或同一个代理在不同工作阶段间）能够在不重复工作的情况下进行协作。

安装重点

• macOS/Linux: curl …/install.sh | sh（完整语义检索）或 brew install mathomhaus/tap/guild。
• Windows: PowerShell 安装程序（仅限关键词检索）。
• Docker 镜像包含嵌入器并将状态存储在命名数据卷中。

可扩展性 – 开发者可以通过常见的 GitHub 流程新增“活动”(campaigns)（任务分组）并做出贡献；仓库包含 CONTRIBUTING.md、AGENTS.md 以及关于模型嵌入的文档。

---

所有细节均直接取自仓库的 README；未做出任何额外声明。