多平台 AI 编码工作流编排框架，通过规范自动注入、任务结构化管理和并行 Agent 执行，统一 14 种 AI 编码工具的协作基座。
Trellis 是由 Mindfold 开发的多平台 AI 编码框架，定位为"最佳 Agent 编排器"（The best agent harness）。其核心思路是在 AI 编码工具之上建立一层结构化的上下文管理层，解决团队在使用多种 AI 编码工具时面临的规范不一致、上下文断裂和并行冲突问题。
框架围绕 .trellis/ 目录约定展开：spec/ 存放项目规范并在每次会话中自动注入；tasks/ 管理 PRD 与任务生命周期；workspace/ 通过 journals 实现跨会话记忆；scripts/ 承载 Python 自动化脚本。内置 8 个斜杠命令覆盖从需求讨论（/brainstorm）、编码前规范检查（/before-dev）、规范合规校验（/check）到提交前清单（/finish-work）的完整工作流。
并行执行能力基于 git worktrees 实现，通过 /parallel 命令可在隔离分支中同时运行多个 AI Agent。多平台适配方面，Trellis 支持包括 Claude Code、Cursor、GitHub Copilot 在内的 14 个平台，初始化时根据所选平台自动生成对应配置文件，并维护一层 .agents/skills/ 共享技能目录。
项目采用 pnpm monorepo 架构，CLI 以 TypeScript 编写（Vitest 测试），自动化脚本使用 Python，通过 npm 分发（@mindfoldhq/trellis），当前最新版本 v0.4.0，采用 AGPL-3.0 许可证。前置依赖为 Node.js ≥ 18 和 Python ≥ 3.10，支持 Windows（v0.3.0 起）。
典型使用场景#
- 规范持久化：将数据库命名规则等写入
.trellis/spec/backend/database-guidelines.md，所有会话自动注入，避免 AI 忽略团队约定。 - 并行特性开发：使用
/parallel启动多个 agent，各自在独立 worktree 中实现、自检、开 draft PR。 - 跨会话上下文连续：
/record-session保存摘要，下次启动时 hook 自动加载上次的交付/故障/待办。 - 多工具团队统一：
trellis init --cursor --claude统一不同工具的 spec 和 task 读取逻辑。
版本演进要点#
| 版本 | 关键变更 |
|---|---|
| v0.4.0 | 命令合并（before-dev、check），新增 /update-spec，Python 脚本重构 |
| v0.3.6 | 任务生命周期 hooks、自定义模板 registry、父子子任务 |
| v0.3.4 | Qoder 平台支持 |
| v0.3.0 | 平台支持从 2 扩展到 10，Windows 兼容，远程 spec 模板 |