藤类
0- Cost 裂口复制- write 工作空间 & 0- Mirage Git Weading for Automic AI 代理
Vine提供"零干"工作空间虚拟化,多格洛特构建-cache常态化,以及用于平行AI编码剂的机械+语义验证门.
核心概念
- 绳子: 即时 工作空间克隆(
vine new <task_id>) (中文(简体) ). 用途rift零成本快照克隆(0个额外磁盘块的~9s)和git worktree用于单层倒置(以~280ms计). - 通用煤矿销售: 克隆依赖缓存
deps, (中文(简体) ),node_modules, (中文(简体) ),vendor)在 <80ms中,没有物理磁盘重复. - Polyglot 构建缓存层: 自动激活无损
.envrc常态化ccache, (中文(简体) ),sccache, (中文(简体) ),uv克隆模式,以及nimcache。 。 。 . - 三基门:确保零“绿色幻影”通过要求键 1(模拟机械)
git merge-tree退出 0),关键 2 (活编译器和测试套件退出 0),关键 3 (独立对抗性审计批准通过vine audit) (中文(简体) ). - 编织: 快速前行经核实的线回入克恩克干线(
vine weave) (中文(简体) ).
人类和AI代理文件
Vine 提供了全面的工作空间,大门,并构建缓存规格:
核心协议和架构
- 字符串寿命周期规格:零成本裂口 Copy-on-Write 线条,目录隔离,
.vine.json运行时间显示 和碰撞探测. - 三键门规格:零"绿色幻影"哲学,关键 1 机械合并-树 + 关键 2活测试发现级联 + 关键 3 独立对抗码审核批准和密码门标志.
- Polyglot 构建缓存正常化: 无损
.envrc连锁,缓存,货物目标, uv克隆链接,和尼姆卡切的统一. - CLI 参考手册: 完整所有 Vine 命令的目录 (
new, (中文(简体) ),status, (中文(简体) ),collisions, (中文(简体) ),gate, (中文(简体) ),submit, (中文(简体) ),audit, (中文(简体) ),weave, (中文(简体) ),list, (中文(简体) ),sync, (中文(简体) ),prune) (中文(简体) ). - 配置结构:分层配置等级,工作空间路径,和出闸选项.
- 代理宪法和Invariants(AGENTS.md):工作空间隔离规则,主权工人分配,三关键纪律.
独立然而为轴心三体设计
葡萄完全独立,可以单独用于零成本的"裂口"复制-写作工作空间克隆, .envrc 任何git存储器上三键门的校验.
[注]
快速注意: 将花园作为您的高层次的 Swarm 包装器
寻找高级多代理指挥? 使用 花园。 。 。 .
虽然vine提供孤立的分支工作空间和三基门, 花园 是高层次的伞式框架。 只需在您最喜欢的编码工具( Antigravity, Claude Code, OpenCode) 中启动一个会话, 并输入"garden: I want to build [feature]"花园进行录入采访,为您的终端标签生成干净的10个回转快卡,协调Rhizo和Vine上的所有工人!
然而,葡萄酒的设计从地上到上,无缝地与 瑞佐 财务报告和审定财务报表 花园数字 :
- 瑞佐 (运输和货币): 代理通讯总线,单音节栅栏锁,以及任务排到Redis上空.
- 藤类 (工作空间与核查):零成本的裂口复制-并写线条,多块块的构建-缓存正常化,和三键集成门(C
git merge-tree机械+编译器/测试套装语义检查+独立的对抗性审计批准. - 花园 (Swarm Methods & High-Level Crapper):对话式的项目收录访谈,即时启动的工人车队(10个后卫卡),3个阶段的经验性辩证泵(研究,建筑,审计),以及主仪式性实施规划.
安装
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 二进制) .
只安装 Vine :
npx skills add -g axiomantic/vine
2. 单独安装CLI
将编译的 CLI 工具直接安装到您的上 $PATH数字 :
# Install all three tools:
npm install -g @axiomantic/rhizo @axiomantic/vine @axiomantic/garden rift-snapshot
# Or install Vine alone:
npm install -g @axiomantic/vine rift-snapshot
[TIP] 零安装通过 NPX 运行:在无法全局安装的受限或集装箱环境中,可以直接运行任何指令而无需安装:
npx -y @axiomantic/vine <command>
3. 仓库协调指南
将 Vine 链条协调协议直接安装到任何工程中 AGENTS.md数字 :
vine guide install
快速启动
# Spin up an isolated strand for a task
vine new task-1049 --repo ~/Development/PebbleOS --branch feat/display-driver
# Inspect dynamic strand lifecycle and commit delta
vine status --json
# Forecast cross-strand file footprint overlap before conflicts happen
vine collisions
# Reconcile upstream canonical trunk changes into strand
vine sync
# Verify mechanical and semantic correctness inside the strand
vine gate
# Weave clean strand into canonical trunk
vine weave
# Prune completed or merged strands
vine prune --apply
CLI 参考
| 命令 | 参数 | 说明 |
|---|---|---|
vine new <task_id> | [--repo <dir>] [--branch <name>] [--parent <branch>] [--worktree] | 提供一条与世隔绝的裂缝绳索或干树. |
vine list | [--repo <dir>] [--all] [--json] | 列出各项目的活跃线条、分支和状态. |
vine status | [<strand>] [--dir <path>] [--json] | 被检查的深生命周期状态( C)PROVISIONED, (中文(简体) ), IN_PROGRESS, (中文(简体) ), GATE_PASSED),并承担前/后. |
vine collisions | [--repo <dir>] [--json] | 预测文件脚印重叠于同时期工人. |
vine sync | [--dir <path>] [--base <branch>] | 快速前进或合并上游干线 干净地改变成支线. |
vine gate | [--dir <path>] [--base <branch>] [--submit] [--author <name>] [--skip-tests] [-- <command...>] | 跑出三键门:键 1 机械预检和键 2 语义测试套件(-- <cmd...> 或者说 --test-command <cmd>) (中文(简体) ). |
vine submit | [--dir <path>] [--author <name>] [--commit <msg>] [--listen] [--allow-no-tests] | 运行 Keys 1 & 2, 自动承诺下脏更改, 提交 Key 3 审计的线索, 并选择输入前景倾听器 . |
vine audit | <approve|reject|status> [--auditor <name>] [--reason <text>] [--notes <text>] | 关键词3 横向审计:拒绝缺陷,检查状态,或批准带有加密审计标志的核准(工人自我审计被严格封锁). |
vine weave | [--dir <path>] [--base <branch>] [--force] [--allow-unaudited] | 检查三基门 快速前进 将批准的线条合并到峡谷干道和干道. |
vine prune | [--repo <dir>] [--apply] | 删除不活动或已完成的线程( 默认干线运行) . |
vine config <init|show> | [--json] | 脚手架或显示项目 vine.toml 配置 . |
vine guide <install|check|uninstall> | [path] | 在 AGENTS.md。 。 。 . |
配置环境变量( E)
[TIP] 完整说明
vine.toml, (中文(简体) ),.vine.json运行时状态计划,以及环境变量,参见 Vine 配置并显示引用。 。 。 .
Vine 提供了零配置默认,可以通过 vine.toml 或环境变量:
| 变量 | 默认 | 说明 |
|---|---|---|
VINE_WORKSPACES_DIR | ~/Development/workspaces | 提供孤立线条的基准目录 . |
VINE_PROJECTS_DIR | ~/Development | 库克库所在的基目录. |
VINE_CONFIG | 自动发现 | 项目的明确路径 vine.toml。 。 。 . |
VINE_PRIMARY_BRANCH | main | 门检查和合并的默认目标分支 . |
VINE_TEST_COMMAND | 自动检测 | 自定义测试/编译器运行键 2 语义门检查 . |
VINE_VENV_POLICY | prompt | 虚拟环境复制政策prompt, (中文(简体) ), auto_yes, (中文(简体) ), auto_no) (中文(简体) ). |
示例 vine.toml
[project]
primary_branch = "main"
[strand]
venv_policy = "prompt"
vendor_dirs = ["deps", "node_modules", "vendor", ".zig-cache"]
[verification]
test_command = "pytest -v tests/"
多代理三合一工作流程
当由多个AI助手组成的团队同时跨行时,配对Vine与 瑞佐 财务报告和审定财务报表 花园数字 :
- 分布的变种( F): 使用
rhizo lock file:<path> --fencing防止在不可合并的图案或迁移中同时发生相撞. - 同步任务队列代理人通过
rhizo claim queue:<project>:tasks --lease 1800并在雷地斯巴士上报告情况. - 完全仪式行为: 使用
garden指导个人审议,生成10个背部工人快速卡,并推动实施计划. - 零下层: Rhizo, Vine, and Garden 强制将代理身份与目录路径完全脱钩.
仓库指南集成
将 Vine 向导安装到任何仓库 AGENTS.md数字 :
# Defaults to AGENTS.md in the current working directory:
vine guide install
# Or specify a custom target path:
vine guide install /path/to/AGENTS.md