Trellis (mindfold-ai) - 技术发现报告

注意：本报告研究对象是 mindfold-ai/Trellis——一个面向 Claude Code、Cursor 等 AI 编码平台的框架和工具集。与微软的 microsoft/TRELLIS（3D 资产生成模型）是完全不同的项目。

基本信息

一句话定位

Trellis 是 Mindfold LLC 开发的面向 AI 编码平台的"一体化"框架与工具集，通过自动注入规范（Spec）、任务驱动工作流、并行 Agent 会话和团队共享标准，让 Claude Code、Cursor 等 AI 编码助手在项目中保持一致性、可追踪性和高质量输出。

核心特性

1. 自动注入规范（Auto-Injected Specs） - 通过 Hook 机制在会话启动时自动将 .trellis/spec/ 目录下的编码规范、架构决策和最佳实践注入到 AI 上下文中，而非依赖 AI 自行读取配置文件。核心区别：Trellis 使用 Hook 强制注入，而 Skills/Claude Code 原生机制是"AI 可选读取"。

2. 任务驱动工作流（Task-Centered Workflow） - 以 .trellis/tasks/ 目录为核心的任务管理系统，支持进度追踪、任务分配和状态管理。配合四种专用 Agent（Dispatch → Implement → Check → Research）实现从任务分发到质量检查的完整闭环。

3. 并行 Agent 会话（Parallel Sessions） - 基于 Git Worktree 的多 Agent 并行执行机制，通过 .trellis/worktree.yaml 配置，允许多个 AI Agent 同时处理不同任务，每个 Agent 在独立的 worktree 中工作，互不干扰。

4. 团队共享标准（Team Sync） - .trellis/ 目录可纳入版本控制，团队成员共享同一套规范、工作流定义和 Agent 配置，确保团队内 AI 辅助编码行为一致。

5. 会话持久化（Session Persistence） - 通过 .trellis/workspace/ 目录保存个人工作日志和上下文，支持跨会话的连续性，AI 可以回溯之前的工作状态和决策。

6. 多平台支持 - 支持 11 个 AI 编码平台：Claude Code、Cursor、OpenCode、iFlow、Codex、Kilo、Kiro、Gemini CLI、Antigravity、Qoder、CodeBuddy，一套规范多处生效。

社区生态

• GitHub Stars： 4,598（截至 2026-04-04）
• Forks： 242
• Open Issues： 1
• 最近更新日期： 2026-04-03（活跃维护）
• 社区讨论热度： 中等偏上。项目创建于 2026 年 1 月，3 个月内获得 4,598 Stars，增长速度较快。已入选 LobeHub、SkillsLLM、awesome-claude-code 等社区 awesome 列表。Discord 社区活跃。
• npm 下载量： npm 包 @mindfoldhq/trellis，具体下载量待验证。

技术栈定位

• 所属领域： AI 辅助编码（AI-Assisted Coding）工具链 / AI Agent 框架
• 解决的核心问题： AI 编码助手（如 Claude Code、Cursor）在团队项目中缺乏一致性规范、任务追踪和并行工作能力。Trellis 通过"Hook 注入 + 任务驱动 + 并行 Worktree"的架构解决这些问题。
• 替代/竞品技术：
• Claude Code Skills - Claude Code 原生的技能扩展机制，可选式加载，AI 可能跳过
• CLAUDE.md / AGENTS.md / .cursorrules - 传统的全量配置文件方式，AI 每次读取全部内容
• Claude Code Hooks - Claude Code 原生的 Hook 机制，Trellis 基于其构建
• Aider - 开源 AI 编码助手，无框架层
• Cline - VS Code AI 编码扩展，无团队规范管理
• 依赖的上游技术：
• Claude Code / Cursor 等 AI 编码平台（运行环境）
• Git Worktree（并行会话的底层机制）
• Python（Hook 脚本和工具链）
• npm（安装和分发）
• Claude Code Hooks API（上下文注入机制）
• 下游使用者/集成方：
• 使用 Claude Code / Cursor 进行日常开发的工程师团队
• 需要标准化 AI 辅助编码流程的企业
• 开源项目维护者（通过 Trellis 管理 AI 贡献者行为）

关键链接汇总

官方资源

• Trellis 官网 - 产品介绍和文档入口
• GitHub 仓库 - 源代码、README、Issues
• npm 包页面 - 安装和使用说明、版本历史

社区资源

• Discord 社区 - 用户讨论和支持
• LobeHub 收录 - 社区 awesome 列表收录
• awesome-claude-code - Claude Code 生态收录

衍生项目

• 待发现（项目较新，生态正在发展中）

安装与快速入门

安装

# 全局安装 Trellis CLI
npm install -g @mindfoldhq/trellis@latest

# 在项目中初始化（-u 指定用户名）
trellis init -u your-name

# 同时初始化多个平台支持
trellis init --cursor --opencode --codex -u your-name

项目结构

初始化后生成的目录结构：

.trellis/
├── workflow.md           # 工作流指南（启动时自动注入）
├── worktree.yaml         # 多 Agent 配置（用于并行模式）
├── spec/                 # 规范库
│   ├── frontend/         # 前端规范
│   ├── backend/          # 后端规范
│   └── guides/           # 决策与分析框架
├── workspace/{name}/     # 个人工作日志
├── tasks/                # 任务管理（进度追踪等）
└── scripts/              # 工具脚本

.claude/
├── settings.json         # Hook 配置
├── agents/               # Agent 定义
│   ├── dispatch.md       # 调度 Agent（纯路由，不读取 specs）
│   ├── implement.md      # 实现 Agent
│   ├── check.md          # 检查 Agent
│   └── research.md       # 研究 Agent
├── commands/             # 斜杠命令
└── hooks/                # Hook 脚本
    ├── session-start.py             # 启动时注入上下文
    ├── inject-subagent-context.py   # 向子 Agent 注入 specs
    └── ralph-loop.py                # 质量控制循环

硬件与系统要求

• 操作系统： 跨平台（macOS、Linux、Windows）
• 运行时： Node.js（npm 安装）、Python（Hook 脚本执行）
• 前置条件： 需已安装并配置 Claude Code、Cursor 或其他支持的 AI 编码平台
• Git： 需要 Git 支持（并行会话依赖 Git Worktree）

路线图

根据项目 README，以下功能正在规划中：

• 更好的代码审查（Better Code Review） - 增强代码审查流程
• 技能包（Skill Packs） - 预打包的技能集合
• 更广泛的工具支持（Broader Tool Support） - 支持更多 AI 编码平台
• 更强的会话连续性（Stronger Session Continuity） - 改进跨会话的上下文保持
• 可视化并行会话（Visual Parallel Sessions） - 图形化界面管理并行 Agent

信息来源

• GitHub - mindfold-ai/Trellis - 获取日期：2026-04-04
• npm - @mindfoldhq/trellis - 获取日期：2026-04-04
• Trellis 官网 - 获取日期：2026-04-04
• Discord 社区 - 获取日期：2026-04-04