@axiomantic/garden

中文文档
0.2.27发布于 2026/10/30MITCommonJS构建来源已验证近 30 天下载 3871

Rhizo & Vine上方的多代理斯瓦姆管弦乐、经验性导盲和典礼

中文使用文档
文档目录23 节
  1. 什么是花园?
  2. 快速注意: 将花园作为您的高层次的 Swarm 包装器
  3. 5 个核心技能(+ 主切入点)
  4. 人类和AI代理文件
  5. 仪式和方法
  6. 安装
  7. 1. AI编码助理(建议)
  8. 2. 单独安装CLI
  9. 3. 仓库协调指南
  10. 系统先决条件
  11. 30- 秒快速启动
  12. 1. 任何任务的启动花园
  13. 2. 项目接收和校准(第0阶段)
  14. 3. 速成型冲锋枪 launch-workers (中文(简体) )
  15. 4. 糖尿病泵 dialectical-pump (中文(简体) )
  16. 5. 仪式规划 plan-implementation (中文(简体) )
  17. 6. 活管和特龙克编织( orchestrate-swarm (中文(简体) )
  18. CLI 参考
  19. 配置和 Swarm 演示文稿
  20. 环境变量
  21. 示例 garden-swarm.json
  22. 核心变量
  23. 许可证

花园

Rhizo & Vine上方的多代理斯瓦姆管弦乐、经验性导盲和典礼

License: MIT Rhizo Vine Swarm Platform

何处 rhizo 提供代理运输 vine 提供工作空间虚拟化, garden 提供机构智慧、经验性考虑和同步执行.


什么是花园?

花园 是一个代理工程框架和技能库,用于组织不同团队的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):协调无常,主权会话规则和听众纪律.

安装

在全球安装技能(-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

系统先决条件

  1. rhizo (协调引擎):
    npm install -g @axiomantic/rhizo
    
  2. vine (工作空间虚拟化引擎):
    npm install -g @axiomantic/vine rift-snapshot
    
  3. 重写或 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)和进行 单问题录取面谈数字 :
    1. 执行模式和 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: 粘贴提示 1 ()pbcopy < /tmp/garden-<project>/<project>-auditor.md(中文(简体) )
    2. 打开 标签 2 / 窗口 2: 粘贴提示 2 ()pbcopy < /tmp/garden-<project>/<project>-architect.md(中文(简体) )
    3. 打开 标签 3/ 窗口 3: 粘贴提示 3 ()pbcopy < /tmp/garden-<project>/<project>-implementer.md(中文(简体) )
  • 每个会话都输入项目目录, 导出 RHIZO_AGENT_NAME,在 Redis 公共汽车上注册(rhizo open并举起它的单发听众rhizo listen) (中文(简体) ).
  • Orchestrator确认所有工人都通过 rhizo who --json 在任务之前!

4. 糖尿病泵dialectical-pump(中文(简体) )

个人经过三个经验阶段深思熟虑:

  1. 研究: 工人读取代码和进行测试 understanding.md $\ to$ 自动校验 事实检查门。 。 。 .
  2. 建筑: 三边辩论权衡结果 design.md。 。 。 .
  3. 审计: 审计员生成 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.jsonJSON文件明确显示路径 .
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. 铅奥克斯特活体数字 : 主要聊天会话协调,审查,整合. 密集多文件编辑由工人车队在孤立的线条中执行.
  2. 实证定位协议(零戏剧对话)数字 : 对话审议必须引用真实工具调用(行引用,测试输出,编译器出错)的硬证据. 戏剧角色扮演被严格禁止.
  3. 三键门核查数字 : 不经过 1 键( 默默里 ) , 任何代码都无法合并到树干中 git merge-tree 第2项(活语义汇编器和测试套件运行)和第3项(独立对抗性审计批准程序) vine audit approve) (中文(简体) ). 工人与 vine submit 并且不能审计他们自己的工作.
  4. 零下层数字 : 所有代理身份文件、会话状态和临时锁文件都被严格忽略 .gitignore。 。 。 .

许可证

麻省理工学院

版本与发布记录

@axiomantic/garden 共发布 35 个版本,首次发布于 2026/09/29;过去 12 个月发布了 35 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.2.27latest2026/10/308 天前
0.2.262026/10/2910 天前
0.2.252026/10/2612 天前
0.2.242026/10/2414 天前
0.2.232026/10/2315 天前
0.2.222026/10/1919 天前

关于 @axiomantic/garden 的常见问题

@axiomantic/garden 是什么?

Rhizo & Vine上方的多代理斯瓦姆管弦乐、经验性导盲和典礼

如何安装 @axiomantic/garden?

在项目目录运行 npm install @axiomantic/garden,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 rift、vine、rhizo、garden,可以用 npx rift 直接运行。

@axiomantic/garden 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/axiomantic__garden 是否存在。

@axiomantic/garden 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@axiomantic/garden 可以商用吗?

@axiomantic/garden 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@axiomantic/garden 的下载量有多少?

根据 npm 官方下载统计,@axiomantic/garden 在 2026/10/08 – 2026/11/06 这 30 天内被下载 3,871 次,日均约 129 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@axiomantic/garden 还在维护吗?

最新版本 0.2.27 发布于 2026/10/30(8 天前);至今共发布 35 个版本,其中过去 12 个月发布了 35 个;首次发布于 2026/09/29。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。