# @axiomantic/garden 中文文档 规范地址：https://npmcn.com/package/%40axiomantic/garden/ 版本：0\.2\.27 npm 元数据更新时间：2026-10-29T21:36:21.708Z 中文译文更新时间：2026-11-07T17:16:26.527Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40axiomantic/garden 原文对照：https://npmcn.com/package/%40axiomantic/garden/?lang=original 项目主页：https://github.com/axiomantic/garden#readme 源码仓库：https://github.com/axiomantic/garden ## 关键信息（来自 npm 元数据） - 包体积（解压后）：4 MB，19 个文件 - 模块格式：CommonJS - TypeScript 类型：未声明 - 运行依赖：3 个 - 首次发布：2026-09-28T17:16:04.874Z - 最新版本发布：2026-10-29T21:36:21.326Z - 近 30 天下载量：3871（2026-10-08 至 2026-11-06，npm 官方下载统计） - 已发布版本数：35（近 12 个月 35 个） ## 中文简介 Rhizo & Vine上方的多代理斯瓦姆管弦乐、经验性导盲和典礼 ## 安装 ```sh npm install @axiomantic/garden ``` 也可以使用：`pnpm add @axiomantic/garden`、`yarn add @axiomantic/garden`、`bun add @axiomantic/garden` ## README # 花园 **Rhizo & Vine上方的多代理斯瓦姆管弦乐、经验性导盲和典礼** [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://npmcn.com/package/%40axiomantic/garden/LICENSE) [![Rhizo](https://img.shields.io/badge/Rhizo-0.2.14%2B-red.svg)](https://github.com/axiomantic/rhizo) [![Vine](https://img.shields.io/badge/Vine-0.2.4%2B-purple.svg)](https://github.com/axiomantic/vine) [![Swarm](https://img.shields.io/badge/Swarm-Prompt--Bootstrapped-brightgreen.svg)](https://npmcn.com/package/%40axiomantic/garden/README.md) [![Platform](https://img.shields.io/badge/Platform-macOS%20%7C%20Linux-blue.svg)](https://npmcn.com/package/%40axiomantic/garden/README.md) _何处 `rhizo` 提供代理运输 `vine` 提供工作空间虚拟化, `garden` 提供机构智慧、经验性考虑和同步执行._ * * * ## 什么是花园? **花园** 是一个代理工程框架和技能库,用于组织不同团队的AI编码助理(Claude Code, OpenCode, Antigravity, Cursor, Codex). > \[注\] > > ### 快速注意: 将花园作为您的高层次的 Swarm 包装器 > > **花园是您所有工程项目的主权高级多剂包装器.** > 安装后 `@axiomantic/garden`, (中文(简体) ), `@axiomantic/rhizo`,以及 `@axiomantic/vine`,您不需要复杂的 shell 脚本,背景守护进程管理器, 或 Brittle 终端多路器。 每当您在您最喜欢的编码带(Antigravity, Claude Code, OpenCode, Cursor)中开始一个会话,只需告诉助手: > > ```text > "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验证的 被隔离的裂缝复制到写字线 整合代码. ```mermaid 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`](https://npmcn.com/package/%40axiomantic/garden/skills/garden/SKILL.md)** | **主条目** | 主权仪式总监. 指导从初始任务到编织代码的各个阶段的管弦乐手和操作员步入. | | **[`choose-personas`](https://npmcn.com/package/%40axiomantic/garden/skills/choose-personas/SKILL.md)** | **团队校正** | 制定由专门人员(如建筑师、审计师、DevEx Lead)组成的均衡三人小组,明确建议 **编码带** 财务报告和审定财务报表 **模式级**,与操作员互动确认. | | **[`launch-workers`](https://npmcn.com/package/%40axiomantic/garden/skills/launch-workers/SKILL.md)** | **会话启动** | 生成自成一体,10backtick生入标记下快卡以粘贴到单独的终端会话(Claude Code,OpenCode,Antigravity,Pi). 配置环境变量,通过 `rhizo open`和单枪匹马的听众. | | **[`dialectical-pump`](https://npmcn.com/package/%40axiomantic/garden/skills/dialectical-pump/SKILL.md)** | **经验性审议** | 推动多视角论文/反相/合成辩论. 严格禁止戏剧角色扮演:每转需要工具执行(读取文件,运行测试,检查AST). 生产 `understanding.md`, (中文(简体) ), `design.md`,以及 `audit_report.md`。 。 。 . | | **[`plan-implementation`](https://npmcn.com/package/%40axiomantic/garden/skills/plan-implementation/SKILL.md)** | **主日程安排** | 作者数 `implementation_plan.md` 界定任务分配矩阵, `rhizo` 以栏杆为锁, `vine` 串行工作流程,动态标记下复选框,控制待办整合,以及即兴设计增编. | | **[`orchestrate-swarm`](https://npmcn.com/package/%40axiomantic/garden/skills/orchestrate-swarm/SKILL.md)** | **主谈总督** | 主聊天会话的州长执行:在 Redis 上发送任务,跟踪心跳,批准出现的设计增编,核实三键门口通过,以及触发 `vine weave`。 。 。 . | * * * ## 人类和AI代理文件 花园提供全面的仪式、明细表和协议规格: ### 仪式和方法 - **[生命周期规格](https://npmcn.com/package/%40axiomantic/garden/docs/ceremony_lifecycle.md)**: 6个相继的仪式阶段,质量门,以及主权会话的拖带. - **[沼泽地表示](https://npmcn.com/package/%40axiomantic/garden/docs/swarm_manifest_schema.md)**: JSON/TOML 规格 `garden-swarm.json` 财务报告和审定财务报表 `garden.toml`。 。 。 . - **[发光泵议定书](https://npmcn.com/package/%40axiomantic/garden/docs/dialectical_pump_protocol.md)**:基于多视角的辩论,第1-3阶段可交付成果,以及紧急设计增编议定书. - **[CLI 参考手册](https://npmcn.com/package/%40axiomantic/garden/docs/cli_reference.md)**: 园林命令的完整目录(`init`, (中文(简体) ), `prompts`, (中文(简体) ), `launch`, (中文(简体) ), `status`, (中文(简体) ), `teardown`) (中文(简体) ). - **[配置结构](https://npmcn.com/package/%40axiomantic/garden/docs/configuration.md)**: 项目级别配置、线程选项和测试跑道配置. - **[代理宪法和Invariants(AGENTS.md)](https://npmcn.com/package/%40axiomantic/garden/AGENTS.md)**:协调无常,主权会话规则和听众纪律. * * * ## 安装 ### 1\. AI编码助理(建议) 在全球安装技能(`-g`) 跨越所有编码助理(Claude Code, Antigravity, Cursor, Codex, OpenCode等) : ```bash # 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个园艺): ```bash npx skills add -g axiomantic/garden ``` ### 2\. 单独安装CLI 将编译的 CLI 工具直接安装到您的上 `$PATH`数字 : ```bash # 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`。 。 。 . > > 在无法全局安装的受限或被容器化的环境中,您可以直接运行任何命令而无需安装: > > ```bash > npx -y @axiomantic/garden > ``` ### 3\. 仓库协调指南 将 Garden 多剂群协调协议直接安装到任何工程中 `AGENTS.md`数字 : ```bash garden guide install ``` * * * ## 系统先决条件 1. **`rhizo`** (协调引擎): ```bash npm install -g @axiomantic/rhizo ``` 2. **`vine`** (工作空间虚拟化引擎): ```bash npm install -g @axiomantic/vine rift-snapshot ``` 3. **重写或 Valkey** (当地或远程): ```bash brew install redis && brew services start redis ``` * * * ## 30- 秒快速启动 ### 1\. 任何任务的启动花园 在您的主要AI编码助理( Antigravity, Claude Code, OpenCode) 中: ```text 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-/.md`)而不是用上千行原始文本淹没聊天窗口: - Orchestrator 显示可点击的文件链接和 OS 复制命令的简洁会话任务 : 1. 打开 **标签 1 / 窗口 1**: 粘贴提示 1 ()`pbcopy < /tmp/garden-/-auditor.md`(中文(简体) ) 2. 打开 **标签 2 / 窗口 2**: 粘贴提示 2 ()`pbcopy < /tmp/garden-/-architect.md`(中文(简体) ) 3. 打开 **标签 3/ 窗口 3**: 粘贴提示 3 ()`pbcopy < /tmp/garden-/-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: --fencing`) (中文(简体) ). - 指派任务和提供隔离的裂缝线`vine new `) (中文(简体) ). - 设置动态进度复选框并控制待办事宜跟踪. ### 6\. 活管和特龙克编织(`orchestrate-swarm`(中文(简体) ) 主要聊天管弦乐团的调度工作在雷迪斯上空. 隔离线中的工人代码,运行单元测试,并验证1和2键(`vine submit`) (中文(简体) ). 独立的对峙审计员审查和批准关键词3(`vine audit approve`) (中文(简体) ). 当批准时,管弦乐团执行 `vine weave` 以快速向前验证代码 `main` 零合并冲突 ! * * * ## CLI 参考 | 命令 | 参数 | 说明 | | :-- | :-- | :-- | | `garden plant` | `"" [--season ] [--sunlight ] [--tags ] [--list] [--json]` | 播下路线图种子 `.garden/seeds/.toml` 或列出播种. | | `garden germinate` | 发送 | 提示 | | `garden prompts` | `[--worker ] [--inline] [--write [file]] [--json] [--project-dir ] [--swarm-file ]` | 生成靴子陷阱快取卡( 默认写为/tmp/ garden- /; pass -- inline for stdout) . | | `garden launch` | `[--worker ] [--inline] [--write [file]] [--json] [--project-dir ] [--swarm-file ]` | Botstrap swarm switchers sessions (将快卡写入/tmp/garden-/). | | `garden status` | `[--json]` | 遥测查询横跨活跃的Rhizo代理,听众状态,和Vine线. | | `garden init` | `[] [--force]` | 初始化 `garden.toml`,并安装向导 `AGENTS.md`。 。 。 . | | `garden teardown` | `[--swarm-file ]` | 瑞地斯巴士上非常贴近注册的一群特工. | | `garden guide` | 安装 | 检查 | * * * ## 配置和 Swarm 演示文稿 > \[TIP\] 完整说明 `garden.toml`, (中文(简体) ), `garden-swarm.json` 计划,以及环境变量,见 [花园配置和 Swarm 演示文稿](https://npmcn.com/package/%40axiomantic/garden/docs/configuration.md)。 。 。 . ### 环境变量 | 变量 | 类型 | 默认 | 说明 | | :-- | :-- | :-- | :-- | | `GARDEN_SWARM_FILE` | 路径 | `garden-swarm.json` | JSON文件明确显示路径 . | | `GARDEN_CONFIG` | 路径 | `garden.toml` | 项目的明确路径 `garden.toml`。 。 。 . | | `GARDEN_PROJECT_DIR` | 路径 | _自动检测_ | 目标寄存器根目录. | ### 示例 `garden-swarm.json` ```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 是什么？ 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 和提交记录判断。