Trellis

一个统治级的多平台 AI 编码框架。 支持 Claude Code、Cursor、OpenCode、iFlow、Codex、Kilo、Kiro、Gemini CLI、Antigravity、Qoder 以及 CodeBuddy。

简体中文 • 文档 • 快速入门 • 支持的平台 • 使用场景

为什么选择 Trellis？

功能	变革之处
自动注入规范	在 .trellis/spec/ 中编写一次约定，Trellis 即可将相关上下文注入到每个会话中，无需重复输入。
以任务为中心的工作流	将 PRD（产品需求文档）、实现上下文、审查记录及任务状态保存在 .trellis/tasks/ 中，让 AI 工作保持结构化。
并行 AI 执行	利用 git worktrees 并行运行多个 AI 任务，避免单个分支因任务堆积造成阻塞。
项目记忆	.trellis/workspace/ 中的日志能保留上次的工作进度，确保每个新会话都能在真实的上下文环境中开始。
团队共享标准	规范存放于代码库中，个人总结出的优秀工作流或规则能让整个团队受益。
多平台统一设置	将相同的 Trellis 结构应用于 10 种不同的 AI 编码平台，无需为每个工具重新构建工作流。

快速入门

# 1. 安装 Trellis
npm install -g @mindfoldhq/trellis@latest

# 2. 在仓库中初始化
trellis init -u your-name

# 3. 或在初始化时指定你使用的平台
trellis init --cursor --opencode --codex -u your-name

• -u your-name 会创建 .trellis/workspace/your-name/ 目录，用于个人日志记录和会话连续性。
• 平台标志可以混合使用。当前支持的选项包括 --cursor、--opencode、--iflow、--codex、--kilo、--kiro、--gemini、--antigravity、--qoder 和 --codebuddy。
• 关于特定平台的设置、入口命令及升级路径，请参考文档： 快速入门 • 支持的平台 • 真实应用场景

使用场景

让 AI 一次性掌握你的项目

将编码标准、文件结构规则、审查习惯及工作流偏好写入 Markdown 规范中。Trellis 会自动加载相关片段，无需每次都重新解释代码库。

并行运行多个 AI 任务

使用 git worktrees 和 Trellis 任务结构，将工作清晰地分配给不同的 Agent。不同的任务可以同时推进，互不干扰分支或本地状态。

将项目历史转化为可用记忆

任务 PRD、检查清单和工作区日志，能让后续的会话随时调用之前的决策。AI 不需要从零开始，而是能够承接上一次的工作进度。

在不同工具间保持统一工作流

如果你的团队同时使用多个 AI 编码工具，Trellis 为你提供了一套关于规范、任务和流程的共享结构。虽然各平台的对接方式不同，但工作流始终保持一致。

工作原理

Trellis 将核心工作流保留在 .trellis/ 中，并为你生成所需的平台特定入口点。

.trellis/
├── spec/                    # 项目标准、模式和指南
├── tasks/                   # 任务 PRD、上下文文件和状态
├── workspace/               # 日志及针对开发者的连续性记录
├── workflow.md              # 共享工作流规则
└── scripts/                 # 驱动工作流的实用程序

根据你启用的平台，Trellis 还会创建特定工具的集成文件，例如 .claude/、.cursor/、AGENTS.md、.agents/、.codex/、.kilocode/ 和 .kiro/。对于 Codex，Trellis 现在会将项目技能安装在 .agents/skills/ 下，并将项目范围内的配置/自定义 Agent 安装在 .codex/ 下。

概括来说，工作流很简单：

1. 在规范（specs）中定义标准。
2. 从任务 PRD 开始或优化工作。
3. 让 Trellis 为当前任务注入正确的上下文。
4. 使用检查、日志和工作树来保持质量和连续性。

规范模板与市场

规范默认以空模板形式提供——旨在针对你项目的技术栈和约定进行自定义。你可以从零开始填充，也可以从社区模板开始：

# 从自定义注册表获取模板
trellis init --registry https://github.com/your-org/your-spec-templates

浏览可用模板，并了解如何在 规范模板页面 发布你自己的模板。

版本更新

• v0.3.6: 增加任务生命周期钩子、自定义模板注册表 (--registry)、父子子任务支持，修复 CC v2.1.63+ 的 PreToolUse 钩子。
• v0.3.5: 修复删除迁移清单字段名（Kilo 工作流）的紧急补丁。
• v0.3.4: 增加 Qoder 平台支持，Kilo 工作流迁移，任务会话记录感知。
• v0.3.1: trellis update 的后台监控模式，改进 .gitignore 处理，文档刷新。
• v0.3.0: 平台支持...