Repolode
tiagovilasboas

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. 1

    克隆仓库

    git clone https://github.com/tiagovilasboas/grok-bot-architecture.git
  2. 2

    进入项目目录

    cd grok-bot-architecture
  3. 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 数据每日更新。

相关项目