claude-threads
一个基于Bash的Claude多智能体并行编排框架
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:claude-threads。 它的用途是:一个基于Bash的Claude多智能体并行编排框架 完整的 Skill 内容见:https://321skill.com/skills/claude-threads/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“启动一个自动线程来审查当前PR的代码,同时创建一个交互式线程与我讨论新功能的架构设计。”,它会为你创建两个独立的Claude智能体线程,一个在后台自动运行代码审查并更新状态到黑板,另一个在前台与你进行对话,两个线程可以基于黑板共享的信息进行协作。
介绍
claude-threads 是一个专为Claude Code设计的智能体编排框架,它解决了在复杂项目中需要多个AI智能体协同工作的问题。传统上,让多个AI代理并行执行任务并共享状态非常困难,而该框架通过状态机和黑板模式,实现了智能体间的协调与通信。
使用该框架时,你可以创建多个运行在不同模式下的“线程”(智能体),例如让一个线程在后台自动处理代码审查,另一个线程在前台与你交互式地讨论架构设计。每个线程都拥有独立的Git工作树,确保开发环境隔离且并行不冲突。
它非常适合需要多智能体协作的开发者、项目经理和运维工程师。例如,全栈开发可以用它来并行处理前端和后端任务,项目经理可以用它来协调不同的自动化工作流,智能体开发者则可以用它来构建和测试复杂的多代理系统。
建议在有一定Bash和Git基础的项目中使用。由于它重度依赖Git工作树和SQLite,请确保你的项目已经初始化了Git仓库,并注意管理好不同线程产生的代码变更,避免合并冲突。
核心特点
与单一智能体工具不同,它提供了完整的多智能体状态管理和编排能力,支持自动、半自动、交互等多种线程模式,并通过Git工作树实现真正的并行开发环境隔离。
注意事项
不适合仅需单个AI代理完成简单、一次性任务的场景,且对用户的Bash和Git操作基础有一定要求。
常见问题
claude-threads 和直接开多个Claude窗口有什么区别?
它提供了有状态的管理、线程间通信、环境隔离和持久化存储,而不仅仅是多个独立会话。
需要安装哪些前置工具?
需要安装 sqlite3、jq、git 等命令行工具,具体请查看仓库的 Prerequisites 部分。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/claude-threads/raw/index.md 读取 claude-threads 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/claude-threads/raw/index.md(查看排版版本)