Trellis 是什么?

Trellis(mindfold-ai/Trellis)是一个面向 AI 编码代理的「工程框架(harness)」,目标是让 AI 写代码时不会每个会话都从零开始——把项目规范(spec)、任务(task)与项目记忆持久化到你的仓库里,让 Claude Code、Codex 等代理在每次会话都按你的工程标准工作。spec 存 `.trellis/spec/` 并按需注入会话;任务/PRD/实现上下文/Review 上下文/状态存 `.trellis/tasks/`;项目记忆/会话日志存 `.trellis/workspace/`。AGPL-3.0 许可,约 9,379 stars,主语言 TypeScript,npm 包名 @mindfoldhq/trellis,文档 docs.trytrellis.app,由公司 mindfold-ai 维护。

⭐ 12,275 Stars 🍴 689 Forks TypeScript AGPL-3.0 作者: mindfold-ai 商业引流:中
来源:README.md(标题、Why Trellis 表、徽章);GitHub 仓库元数据(stars=9379、language=TypeScript、license=AGPL-3.0、topics agentic-coding/harness) 查看 GitHub 仓库 →

为什么值得关注

AI 写代码快但每次会话都「健忘」——记不住项目约定、风格、上下文。Trellis 把规范、任务、记忆三件事结构化进仓库目录,按需把上下文注入到不同代理(多平台支持),让 AI 工作可重复、可审查、可沉淀团队约定,对长期使用代理的团队很对口,因而 star 涨得快。需说明:项目以 AGPL-3.0 开源(强 copyleft),背后是商业实体 mindfold-ai 与自家域名 docs.trytrellis.app;AGPL-3.0 + 商业实体常对应「开源 + 商业授权/SaaS」策略,存在中等强度商业引流。截至数据采集约 9,379 stars。

来源:README.md(Why Trellis、Docs/Discord、徽章);GitHub 仓库元数据(stars=9379、pushed_at 2026-06、license=AGPL-3.0)

核心功能

Spec 自动注入

团队规范一次写入 `.trellis/spec/`,按相关性注入每次会话,避免重复解释。

来源:README.md(Why Trellis 表 1)
任务中心工作流

PRD、实现/Review 上下文、状态都放在 `.trellis/tasks/`,让 AI 工作结构化。

来源:README.md(Why Trellis 表 2)
项目记忆(journals)

`.trellis/workspace/` 的 journal 保留上次发生的内容,新会话以真实上下文起步。

来源:README.md(Why Trellis 表 3)
多平台代理支持

可对接 Claude Code、Codex 等编码代理,团队可共享约定。

来源:README.md(Supported Platforms、Why Trellis 4)

技术架构

Trellis 是 TypeScript/Node CLI(npm `@mindfoldhq/trellis`),在你的 Git 仓库里建一个 `.trellis/` 目录把工程上下文持久化:① `spec/` 放团队规范与约定,按相关性自动注入;② `tasks/` 把 PRD、实现上下文、Review 上下文、状态做任务中心化管理;③ `workspace/` 用 journal 记录上次发生了什么,让新会话从真实上下文起步。同时支持多平台代理(Claude Code、Codex 等编码代理);具体接入方式与示例见 trytrellis.app 文档。

来源:README.md(Why Trellis 表、Supported Platforms 链接)

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) 编码代理 CLI(Claude Code/Codex 等)编码代理 CLI(C… Git 仓库目录约定(.trellis/*)Git 仓库目录约… Spec 自动注入 任务中心工作流 项目记忆(journals) 多平台代理支持 Trellis 项目本体 核心功能 关键依赖

中心为项目本体,内环 = 核心功能模块,外环 = 关键技术依赖;按 deep.json 中的 core_features 与 tech_stack.key_deps 自动生成

技术栈

语言TypeScript(Node.js CLI)框架AI 编码代理 harness(spec + tasks + memory)
编码代理 CLI(Claude Code/Codex 等)Git 仓库目录约定(.trellis/*)
npm @mindfoldhq/trellis;文档 docs.trytrellis.app;Discord 社区;AGPL-3.0;由 mindfold-ai 公司维护
来源:README.md(徽章、Why Trellis、Docs);GitHub 仓库元数据(language=TypeScript、license=AGPL-3.0)

快速上手

按 trytrellis.app/start/install-and-first-task 安装 npm 包 `@mindfoldhq/trellis` 并在仓库初始化;定义 spec(约定/风格)写入 `.trellis/spec/`,再用 task 工作流创建 PRD 与实现/Review 上下文(存 `.trellis/tasks/`),journal 自动写入 `.trellis/workspace/`。每个新会话由代理读取自动注入相关上下文,结合 Claude Code/Codex 等代理执行。AGPL-3.0 对集成/分发有较强 copyleft 约束,企业内集成需评估许可或与 mindfold-ai 沟通商业授权。
来源:README.md(徽章 Docs/Quick Start、Why Trellis)

使用场景

适合长期用 AI 编码代理且关心一致性的团队/个人:把团队规范、任务、记忆沉淀到仓库,让 AI 在多人/多代理/多会话中按统一约定工作;适合做 PRD→实现→Review 全流程的代理化辅助。AGPL-3.0 与商业实体维护,二次开发或集成进闭源产品需评估许可与商业授权。

来源:README.md(Why Trellis、Use Cases 链接)

优势与局限

优势

  • 把代理工作的 spec/task/memory 结构化持久化到仓库
  • spec 自动注入,避免每次重复解释
  • 任务工作流覆盖 PRD/实现/Review/状态
  • 多平台代理支持、文档与社区齐全

局限

  • AGPL-3.0 copyleft 较强,商用集成需评估许可
  • 对团队工作流的契合需要前期约定与维护
  • 依赖代理对 spec 的遵循程度,效果随代理而异
  • 由商业实体维护,存在向自家 SaaS 引导的倾向
来源:README.md(Why Trellis、徽章、AGPL)

最新版本

本页未列固定版本号;通过 npm(@mindfoldhq/trellis)持续发布。仓库最后更新约在 2026 年 6 月初。

来源:README.md(徽章 npm);GitHub pushed_at

总结评价

Trellis 是一个面向 AI 编码代理的工程 harness:把 spec、task、project memory 结构化持久化到仓库的 `.trellis/` 目录,自动按相关性注入每次会话,让 Claude Code/Codex 等代理按团队约定一致工作,思路实用、文档齐全、多平台支持。要清楚 AGPL-3.0 copyleft 较强、商用集成需评估许可、由商业实体 mindfold-ai 维护与自家域名运营,属中等强度商业引流;对团队工作流契合需要前期约定与维护,效果随代理对 spec 的遵循而变。作为代理 harness 方向的代表性开源项目,工程化程度高。

来源:综合 README.md 的定位、能力矩阵、许可与商业化路径

常见问题

Trellis 是什么?

Trellis(mindfold-ai/Trellis)是一个面向 AI 编码代理的「工程框架(harness)」,目标是让 AI 写代码时不会每个会话都从零开始——把项目规范(spec)、任务(task)与项目记忆持久化到你的仓库里,让 Claude Code、Codex 等代理在每次会话都按你的工程标准工作。

Trellis 有哪些核心功能?

Trellis 的核心功能包括:Spec 自动注入、任务中心工作流、项目记忆(journals)、多平台代理支持。

Trellis 为什么最近很受关注?

AI 写代码快但每次会话都「健忘」——记不住项目约定、风格、上下文。Trellis 把规范、任务、记忆三件事结构化进仓库目录,按需把上下文注入到不同代理(多平台支持),让 AI 工作可重复、可审查、可沉淀团队约定,对长期使用代理的团队很对口,因而 star 涨得快。

Trellis 适合哪些使用场景?

适合长期用 AI 编码代理且关心一致性的团队/个人:把团队规范、任务、记忆沉淀到仓库,让 AI 在多人/多代理/多会话中按统一约定工作;适合做 PRD→实现→Review 全流程的代理化辅助。AGPL-3.0 与商业实体维护,二次开发或集成进闭源产品需评估许可与商业授权。

透明度声明
本页内容由 AI(大语言模型)基于以下公开材料自动生成:GitHub README、代码目录结构、依赖文件、Release 信息。 分析时间: 2026-06-04 11:27. 质量评分: 100/100.

数据来源:README、GitHub API、依赖文件