什么是花园?
花园 是一个代理工程框架和技能库,用于组织不同团队的AI编码助理(Claude Code, OpenCode, Antigravity, Cursor, Codex).
[注]
快速注意: 将花园作为您的高层次的 Swarm 包装器
花园是您所有工程项目的主权高级多剂包装器.
安装后@axiomantic/garden, (中文(简体) ),@axiomantic/rhizo,以及@axiomantic/vine,您不需要复杂的 shell 脚本,背景守护进程管理器, 或 Brittle 终端多路器。 每当您在您最喜欢的编码带(Antigravity, Claude Code, OpenCode, Cursor)中开始一个会话,只需告诉助手:"garden: I want to build [feature/system/project]"会议自动发挥 铅骨整形仪它自动检测你的编码机 并进行一个单问题录入访谈 校正您想要的团队形状和会话默认模式。 然后它会配置您的工程( E)
garden.toml打开garden-swarm.json),并将快速卡写入文件,以便您手动为新的或已有的聊天会话指派. 园林在Rhizo(本地Redis消息总线)和Vine(同位相仿的裂缝复制-写作工作空间)上协调整群人!
而不是把AI代理当作孤立的单回合聊天人 快速启动的工人群 在您最喜欢的 AI 编码带( Claude Code, OpenCode, Antigravity, Pi, Cursor) 上, 平衡专业人物与指定的基础模型, 驱动器 以经验为依据的辩证法审议并且通过被Vine's Three-Key Gate验证的 被隔离的裂缝复制到写字线 整合代码.
flowchart TD
subgraph Layer3["Layer 3: Garden (Methodology, Ceremonies & Swarms)"]
direction TB
GardenSkill["garden (Master Entrypoint)"]
P1["choose-personas (Team & Models)"]
P2["launch-workers (Prompt-Based Session Bootstrapping)"]
P3["dialectical-pump (Research ➔ Design ➔ Audit)"]
P4["plan-implementation (Locks & Strands)"]
P5["orchestrate-swarm (Dispatch & Weave)"]
GardenSkill --> P1 --> P2 --> P3 --> P4 --> P5
end
subgraph Layer2["Layer 2: Vine (Workstream Integrator)"]
Strands["Rift Strands (Zero-cost copy-on-write workspaces)"]
TwoKey["Three-Key Gate (Mechanical + Semantic + Independent Audit)"]
Weave["Trunk Weaving (Fast-forward verified branches)"]
end
subgraph Layer1["Layer 1: Rhizo (Inter-Agent Transport)"]
Bus["Redis Message Bus (O2O, Multicast, RPC)"]
Locks["Distributed Mutexes & Monotonic Fencing Tokens"]
Queues["Worker Queues with Leases & Dead-Letter Escalation"]
end
Layer3 --> Layer2
Layer3 --> Layer1
Layer2 -.-> Layer1
5 个核心技能(+ 主切入点)
花园被组织成一个清洁的,包含电池的目录,其中包含不言自明的技能:
| 技能 | 作用 | 说明 |
|---|---|---|
garden | 主条目 | 主权仪式总监. 指导从初始任务到编织代码的各个阶段的管弦乐手和操作员步入. |
choose-personas | 团队校正 | 制定由专门人员(如建筑师、审计师、DevEx Lead)组成的均衡三人小组,明确建议 编码带 财务报告和审定财务报表 模式级,与操作员互动确认. |
launch-workers | 会话启动 | 生成自成一体,10backtick生入标记下快卡以粘贴到单独的终端会话(Claude Code,OpenCode,Antigravity,Pi). 配置环境变量,通过 rhizo open和单枪匹马的听众. |
dialectical-pump | 经验性审议 | 推动多视角论文/反相/合成辩论. 严格禁止戏剧角色扮演:每转需要工具执行(读取文件,运行测试,检查AST). 生产 understanding.md, (中文(简体) ), design.md,以及 audit_report.md。 。 。 . |
plan-implementation | 主日程安排 | 作者数 implementation_plan.md 界定任务分配矩阵, rhizo 以栏杆为锁, vine 串行工作流程,动态标记下复选框,控制待办整合,以及即兴设计增编. |
orchestrate-swarm | 主谈总督 | 主聊天会话的州长执行:在 Redis 上发送任务,跟踪心跳,批准出现的设计增编,核实三键门口通过,以及触发 vine weave。 。 。 . |
人类和AI代理文件
花园提供全面的仪式、明细表和协议规格:
仪式和方法
- 生命周期规格: 6个相继的仪式阶段,质量门,以及主权会话的拖带.
- 沼泽地表示: JSON/TOML 规格
garden-swarm.json财务报告和审定财务报表garden.toml。 。 。 . - 发光泵议定书:基于多视角的辩论,第1-3阶段可交付成果,以及紧急设计增编议定书.
- CLI 参考手册: 园林命令的完整目录(
init, (中文(简体) ),prompts, (中文(简体) ),launch, (中文(简体) ),status, (中文(简体) ),teardown) (中文(简体) ). - 配置结构: 项目级别配置、线程选项和测试跑道配置.
- 代理宪法和Invariants(AGENTS.md):协调无常,主权会话规则和听众纪律.
安装
1. AI编码助理(建议)
在全球安装技能(-g) 跨越所有编码助理(Claude Code, Antigravity, Cursor, Codex, OpenCode等) :
# Recommended: Install the complete multi-agent triad globally
npx skills add -g axiomantic/rhizo
npx skills add -g axiomantic/vine
npx skills add -g axiomantic/garden
(如果尚未安装在您的系统上, 每种技能都会自动设置本地的 CLI 二进制) .
只安装花园(包括6个园艺):
npx skills add -g axiomantic/garden
2. 单独安装CLI
将编译的 CLI 工具直接安装到您的上 $PATH数字 :
# Recommended: Install Garden (automatically carries rhizo, vine, and rift bin riders):
npm install -g @axiomantic/garden
# Or install individual components explicitly if desired:
npm install -g @axiomantic/rhizo @axiomantic/vine @axiomantic/garden rift-snapshot
[TIP] 全一工具链数字 :
@axiomantic/garden搭载头等舱的宾客garden, (中文(简体) ),rhizo, (中文(简体) ),vine,以及rift。安装@axiomantic/garden使所有四个命令在您的$PATH。 。 。 .在无法全局安装的受限或被容器化的环境中,您可以直接运行任何命令而无需安装:
npx -y @axiomantic/garden <command>
3. 仓库协调指南
将 Garden 多剂群协调协议直接安装到任何工程中 AGENTS.md数字 :
garden guide install
系统先决条件
rhizo(协调引擎):npm install -g @axiomantic/rhizovine(工作空间虚拟化引擎):npm install -g @axiomantic/vine rift-snapshot- 重写或 Valkey (当地或远程):
brew install redis && brew services start redis
30- 秒快速启动
1. 任何任务的启动花园
在您的主要AI编码助理( Antigravity, Claude Code, OpenCode) 中:
User: "garden: Implement high-throughput batch claim leases with Redis pipeline support"
2. 项目接收和校准(第0阶段)
花园利用 活性沼泽快板( 第一-目视invariant)数字 :
- 现有集群在线: 在询问录取问题之前, Garden 运行
rhizo who --json. 如果在集群中已经存在积极,健康的工人,花园跳过所有设置问题和即时卡,自动附着在活跃工人身上,直接进行任务规划或执行! - 冷起步(零积极工作者):如果没有工人在线, Orchestrator 自动检测主动编码带(
ANTIGRAVITY_APP_DIR, (中文(简体) ),CLAUDE_CODE, (中文(简体) ),OPENCODE_SESSION_ID, (中文(简体) ),CODEX_SESSION_ID, (中文(简体) ),PI_SESSION_ID)和进行 单问题录取面谈数字 :- 执行模式和 Swarm 形状 :多代理斯瓦姆(被检测到的被子被三合一或被聚焦于被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子被子.
[大 通用主权会话和模式继承数字 :
- 只有主权会话( 禁止通用子代理 & Tmux): Swarm工人是严格独立的会话(分离终端标签或IDE窗口),通过10backtick快卡被拖出. 强力-内部亚剂(例如抗重力)
invoke_subagent克劳德代码Task, OpenCode 子任务)和终端多路器(tmux已经 严格禁止。 。 。 .- 会话 - 自然模式继承: 沼泽工人继承任何活跃于该吊带窗口的地基模型(
Session Default (active in window/tab)) (中文(简体) ). 断开的型号配对测试被取消.
3. 速成型冲锋枪launch-workers(中文(简体) )
花园写作 garden-swarm.json 运行 garden prompts 直接将快取卡写入临时文件( s)/tmp/garden-<project>/<worker>.md)而不是用上千行原始文本淹没聊天窗口:
- Orchestrator 显示可点击的文件链接和 OS 复制命令的简洁会话任务 :
- 打开 标签 1 / 窗口 1: 粘贴提示 1 ()
pbcopy < /tmp/garden-<project>/<project>-auditor.md(中文(简体) ) - 打开 标签 2 / 窗口 2: 粘贴提示 2 ()
pbcopy < /tmp/garden-<project>/<project>-architect.md(中文(简体) ) - 打开 标签 3/ 窗口 3: 粘贴提示 3 ()
pbcopy < /tmp/garden-<project>/<project>-implementer.md(中文(简体) )
- 打开 标签 1 / 窗口 1: 粘贴提示 1 ()
- 每个会话都输入项目目录, 导出
RHIZO_AGENT_NAME,在 Redis 公共汽车上注册(rhizo open并举起它的单发听众rhizo listen) (中文(简体) ). - Orchestrator确认所有工人都通过
rhizo who --json在任务之前!
4. 糖尿病泵dialectical-pump(中文(简体) )
个人经过三个经验阶段深思熟虑:
- 研究: 工人读取代码和进行测试
understanding.md$\ to$ 自动校验 事实检查门。 。 。 . - 建筑: 三边辩论权衡结果
design.md。 。 。 . - 审计: 审计员生成
audit_report.md$\ to$ 三合会解析编码开始前的每个发现 .
5. 仪式规划plan-implementation(中文(简体) )
花园作者 implementation_plan.md数字 :
- 分布式栅栏锁(
rhizo lock file:<path> --fencing) (中文(简体) ). - 指派任务和提供隔离的裂缝线
vine new <task_id>) (中文(简体) ). - 设置动态进度复选框并控制待办事宜跟踪.
6. 活管和特龙克编织(orchestrate-swarm(中文(简体) )
主要聊天管弦乐团的调度工作在雷迪斯上空. 隔离线中的工人代码,运行单元测试,并验证1和2键(vine submit) (中文(简体) ). 独立的对峙审计员审查和批准关键词3(vine audit approve) (中文(简体) ). 当批准时,管弦乐团执行 vine weave 以快速向前验证代码 main 零合并冲突 !
CLI 参考
| 命令 | 参数 | 说明 |
|---|---|---|
garden plant | "<description>" [--season <name>] [--sunlight <level>] [--tags <csv>] [--list] [--json] | 播下路线图种子 .garden/seeds/<id>.toml 或列出播种. |
garden germinate | 发送 | 提示 |
garden prompts | [--worker <name>] [--inline] [--write [file]] [--json] [--project-dir <dir>] [--swarm-file <file>] | 生成靴子陷阱快取卡( 默认写为/tmp/ garden- /; pass -- inline for stdout) . |
garden launch | [--worker <name>] [--inline] [--write [file]] [--json] [--project-dir <dir>] [--swarm-file <file>] | Botstrap swarm switchers sessions (将快卡写入/tmp/garden-/). |
garden status | [--json] | 遥测查询横跨活跃的Rhizo代理,听众状态,和Vine线. |
garden init | [<target_dir>] [--force] | 初始化 garden.toml,并安装向导 AGENTS.md。 。 。 . |
garden teardown | [--swarm-file <file>] | 瑞地斯巴士上非常贴近注册的一群特工. |
garden guide | 安装 | 检查 |
配置和 Swarm 演示文稿
[TIP] 完整说明
garden.toml, (中文(简体) ),garden-swarm.json计划,以及环境变量,见 花园配置和 Swarm 演示文稿。 。 。 .
环境变量
| 变量 | 类型 | 默认 | 说明 |
|---|---|---|---|
GARDEN_SWARM_FILE | 路径 | garden-swarm.json | JSON文件明确显示路径 . |
GARDEN_CONFIG | 路径 | garden.toml | 项目的明确路径 garden.toml。 。 。 . |
GARDEN_PROJECT_DIR | 路径 | 自动检测 | 目标寄存器根目录. |
示例 garden-swarm.json
{
"project": "myproject",
"target_repo": "/Users/developer/Development/myproject",
"orchestrator": "orchestrator",
"workers": [
{
"name": "architect",
"persona": "Bramblestitch (Systems Architect)",
"role": "Systems Architect & Formal Invariant Specifier",
"harness": "Claude Code",
"model": "claude-3-5-sonnet",
"tags": ["design", "spec"],
"opposing_priority": "Formal mathematical correctness and zero architectural drift."
},
{
"name": "auditor",
"persona": "Prickle-Thistle (Adversarial Quality Auditor)",
"role": "Adversarial Code Reviewer & Security Auditor",
"harness": "OpenCode",
"model": "gemini-3.8-flash",
"tags": ["audit", "testing"],
"opposing_priority": "Aggressive edge-case fault injection and invariant verification."
},
{
"name": "implementer",
"persona": "Moss-Weaver (Lead Implementation Engineer)",
"role": "Polyglot Systems & Performance Engineer",
"harness": "Antigravity",
"model": "claude-3-5-sonnet",
"tags": ["implementation", "perf"],
"opposing_priority": "Rapid implementation velocity and minimal dependency footprint."
}
]
}
核心变量
- 铅奥克斯特活体数字 : 主要聊天会话协调,审查,整合. 密集多文件编辑由工人车队在孤立的线条中执行.
- 实证定位协议(零戏剧对话)数字 : 对话审议必须引用真实工具调用(行引用,测试输出,编译器出错)的硬证据. 戏剧角色扮演被严格禁止.
- 三键门核查数字 :
不经过 1 键( 默默里 ) , 任何代码都无法合并到树干中
git merge-tree第2项(活语义汇编器和测试套件运行)和第3项(独立对抗性审计批准程序)vine audit approve) (中文(简体) ). 工人与vine submit并且不能审计他们自己的工作. - 零下层数字 :
所有代理身份文件、会话状态和临时锁文件都被严格忽略
.gitignore。 。 。 .
许可证
麻省理工学院