Skip to content

About

Skill-driven agent roundtables with Markdown/Obsidian Kanban, durable messaging, and portable harness adapters.

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

Agent Roundtable

以 skill 驱动的 agent 圆桌会议。Markdown / Obsidian 看板,文件就是权威数据,无数据库、无第三方 Python 依赖。 以 MIT 许可 开源。

本地协议、文件事务、消息分发、参与者代次隔离、确认屏障、安装器、Claude hook 与 OpenCode 插件已实现。真实 agent 的创建和模型推理由宿主提供;不会用脚本假装多 agent 思考。

先看效果

打开 示例看板 或 示例会议摘要。也可以把 examples/file-meeting 作为 Obsidian vault 打开,安装 Kanban 社区插件后打开 BOARD.md。所有议题是可编辑的 Markdown 卡片。

在仓库目录运行新的离线演练:

python skills/agent-roundtable/scripts/roundtable.py --root ./my-demo demo

此演练不使用模型/API,展示协议流程并生成文件;my-demo 需是新的会议目录。

安装与开始

python skills/agent-roundtable/scripts/install.py --project "D:/YourProject" --harness codex

支持 codex、claude、opencode、generic。指定真实项目路径;安装器不会覆盖已有同名 skill。在相应 harness 中使用自然语言:

使用 agent-roundtable,组织一场关于“离线笔记工具存储方案”的圆桌,先独立分析再交叉质询,把记录保存到项目的 .roundtable/storage。若派 Codex 子 agent,使用 Luna。

需要 hook 的环境见 运行手册。通用协议不规定模型,尊重用户选择。

已有能力

  • Kanban 议题流转、WIP 与轮次限制、独立分析隔离、证据及保留意见。
  • 全体广播、议题组播、定向消息;每人独立的投递记录与确认。
  • 逻辑参与者 ID、原生地址绑定、重启代次隔离。
  • 重要约束的确认/重评估屏障,拒绝过期成果进入最终决议。
  • 文件锁、redo 日志、崩溃恢复、请求去重、人工编辑冲突检测。
  • Obsidian 拖动导入、Markdown 议题、JSON 协议记录。
  • 文件投递、通用命令桥、Claude hook、OpenCode 工具回调和 Codex 原生桥接流程。

实时性边界

skill 与文件本身不会唤醒 agent。原生消息工具、hook 或连接实际宿主的 command bridge 承担注入。hook 在宿主提供的接收点触发;空闲唤醒与执行中断取决于宿主。已发送、已注入、已处理分开记录。

当前验证覆盖本地协议与适配器回调;各产品的真实模型会话兼容性仍需在对应环境中验证。

开发与验证

python -m unittest discover -s tests -v

详见 验证记录、设计说明、运行手册。Python 3.10+;本次实测 Windows / Python 3.12。无需 npm build 或数据库服务。

About

Skill-driven agent roundtables with Markdown/Obsidian Kanban, durable messaging, and portable harness adapters.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages