可自托管的 TypeScript 智能体运行时,用于协调多个 LLM 智能体,支持人工审批和离线审计运行记录。
tiagovilasboas/grok-bot-architecture
一套 MIT 许可的参考架构,用可复用的角色技能、MCP 连接器和人工审批关口组织 AI 智能体团队。
- Star
- 49
- Fork
- 11
- 未关闭 Issue
- 0
- 最近提交
- 10天前
这是什么?
这是一个与模型和框架无关的参考架构,用于组织一组 AI 智能体协同工作。由主管型智能体(chief-of-staff)把目标拆分为有范围的任务,再分派给工程、发布、安全、收件箱整理、职业筛选等专项角色。每个角色由可复用的 SKILL.md 配方定义,并通过宿主强制执行的工具权限工作,而不是拥有无限制的环境权限。
核心思路是人在回路中的审批。涉及特权操作时,系统会生成一条等待记录,只有经过身份验证、且绑定到具体操作和版本的决定才能放行;超时默认是等待而非继续执行。角色之间通过类型化的交接记录和 Markdown 看板传递任务与证据,仓库还包含 JSON 校验器、看板工具,以及一个有边界的本地审批生命周期示例。
项目同时说明了如何把这套模式套用到 Grok Bot 上,包括配置步骤、审批策略建议和完整演示。仓库不包含 Grok Bot 产品的源代码,也与 xAI 没有关联。
核心功能
- 01主管型智能体负责为专项角色划定范围、分派并审核任务
- 02九个可复用的角色技能,以 SKILL.md 配方形式定义
- 03审批关口将每项决定绑定到具体操作版本,超时则保持等待
- 04类型化交接记录与 Markdown 看板,用于共享状态和证据
- 05提供 JSON 校验器和无需外部依赖的本地审批生命周期示例
适用场景
- 设计由多个持续运行的 AI 助手组成的团队,各自负责邮件、代码等独立领域
- 在智能体发送消息、合并代码或修改外部系统前加入人工审批
- 把基于角色的权限和任务交接映射到现有的智能体运行环境
- 在编写生产代码前学习智能体系统的信任边界设计模式
快速上手
- 1
克隆仓库
git clone https://github.com/tiagovilasboas/grok-bot-architecture.git - 2
进入项目目录
cd grok-bot-architecture - 3
运行本地验证和审批流程检查
bash scripts/check.sh
使用前须知
- 这是一个参考架构和文档模式,并非独立运行的智能体系统。
- Grok Bot 的配置路径依赖另一个独立的 Grok Bot 产品,其源代码未包含在内。
- 验证工具仅检查文件结构,不会认证人工审批者,也不会执行任何副作用操作。
收录于专题
标签
常见问题
- grok-bot-architecture 是什么?
- 一套 MIT 许可的参考架构,用可复用的角色技能、MCP 连接器和人工审批关口组织 AI 智能体团队。 这是一个与模型和框架无关的参考架构,用于组织一组 AI 智能体协同工作。由主管型智能体(chief-of-staff)把目标拆分为有范围的任务,再分派给工程、发布、安全、收件箱整理、职业筛选等专项角色。每个角色由可复用的 SKILL.md 配方定义,并通过宿主强制执行的工具权限工作,而不是拥有无限制的环境权限。
- grok-bot-architecture 可以免费使用吗?用的什么许可证?
- grok-bot-architecture 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
- grok-bot-architecture 还在维护吗?
- 活跃维护中。grok-bot-architecture 最近一次提交是在 2026年10月29日。
- grok-bot-architecture 适合用来做什么?
- 设计由多个持续运行的 AI 助手组成的团队,各自负责邮件、代码等独立领域 在智能体发送消息、合并代码或修改外部系统前加入人工审批 把基于角色的权限和任务交接映射到现有的智能体运行环境 在编写生产代码前学习智能体系统的信任边界设计模式
- grok-bot-architecture 怎么安装和运行?
- 克隆仓库: git clone https://github.com/tiagovilasboas/grok-bot-architecture.git 进入项目目录: cd grok-bot-architecture 运行本地验证和审批流程检查: bash scripts/check.sh
- 在哪里获取 grok-bot-architecture?
- 源代码和安装说明在 GitHub 上:https://github.com/tiagovilasboas/grok-bot-architecture
概要由 AI 根据项目 README 生成;GitHub 数据每日更新。
相关项目
面向 AI 智能体的开源自托管邮箱基础设施,提供 REST 与 MCP 接口、人工审批和签名 Webhook。
可自托管的运行时与可视化平台,用于构建、运行、观测和管控智能体系统与确定性工作流。
开源数据库与工作区,让 AI 智能体和人共享结构化数据、文档、技能与应用,并对关键写入进行审核。
开源多智能体运行时,由常驻的 queen 智能体规划任务、派生并行 worker,并将结果记入共享 SQLite 表。
可自托管的 Python 个人 AI 智能体框架,提供浏览器 WebUI、终端客户端、聊天应用接入、记忆与 MCP 支持。