用途
Trellis 是一个面向 AI 编程的开箱即用工程框架。它针对的痛点是:AI 写代码虽快,但每个会话都从零开始,不记得你的项目、约定或团队要求。Trellis 将规格、任务与记忆持久化到你的代码仓库中,从而使任何编码智能体都按照你的工程标准来工作。
主要能力
Trellis 运行一个四阶段循环,并配有自动调用的技能(skills)与子智能体(sub-agents):
- 规划(Plan):trellis-brainstorm 一次一个问题地梳理需求并写出 prd.md。研究密集型的条目交给 trellis-research 子智能体。结果是从 implement.jsonl / check.jsonl 引用的、经过整理的规格与研究文件。
- 实现(Implement):trellis-implement 子智能体根据 PRD 编写代码,经过整理的上文上下文会自动注入,不进行 git 提交。
- 验证(Verify):trellis-check 子智能体对照规格审查 diff,并运行 lint、类型检查与测试,能自行修复的地方自行修复。
- 收尾(Finish):运行最终检查,随后 trellis-update-spec 把新的经验提升回 .trellis/spec/,让下一个会话起步时更聪明。
围绕这些文件,Trellis 增加了作用域化规格(scoped specs)、任务 PRD、工作流门禁(workflow gates)、工作区记忆(workspace memory)以及平台感知的生成文件。官方说明这些文件是有用的入口点,但它们往往会变得庞大(monolithic)。
使用方式
工作流很简单:
- 用自然语言描述你想要什么。
- 与 AI 一次一个问题地头脑风暴,直到 PRD 清晰,然后开始实现。
- 让它运行——AI 会调用 Trellis Implement,并自动对照规格、lint、类型检查和测试来核对结果。
- 当工作完成或会话上下文填满时,输入 /trellis:finish-work。Trellis 会归档任务并更新日志(journals)。
官方提供简体中文、文档、快速开始、支持平台与用例等入口,设置细节可参见快速开始与支持平台指南。
适用场景
- 个人开发者:使用它获得记忆与可重复的工作流。
- 团队:获得更大的收益,包括共享标准、任务边界、可审查的上下文以及平台可移植性。
- 个人工作区日志按开发者分别保存,而共享规格与任务留在仓库中,可像其他项目产物一样被审查和改进。
- 许多团队开始时让 AI 从现有代码起草规格,再手动收紧重要的部分。Trellis 在保持高信号规则显式且纳入版本管理时效果最佳。
限制与边界
- Trellis 不是某个单一编码智能体专属工具:它是一个跨多种编码智能体和 IDE 工作的项目层。
- 规格不必全手写:Trellis 在保持高信号规则显式且版本化时效果最好。
- 关于消融(ablation)功能:trellis ablate 会在项目之外创建经过验证的恢复事务后,临时移除所有受支持、项目自有的 Trellis 界面。之后启动全新的智能体会话进行对比,再运行 trellis restore 恢复此前确切状态。可用 --dry-run 预览任一操作。私有恢复事务包含确切的 .trellis 任务、规格和工作区字节,其中可能含有用户撰写的敏感文本,该事务会保留到 restore 成功验证为止。
- 消融不同于 trellis uninstall(永久移除)和 TRELLIS_HOOKS=0(仅钩子)。消融不会启动智能体、管理工作树(worktrees)、隐藏 Git 变更,也不会移除全局 CLI、通道日志或宿主记录(host transcripts)。如果受管理的路径在消融期间发生变化,restore 将拒绝所有写入,直到冲突得到解决。
- 以上为当前资料中的明确说明;关于定价、具体支持平台清单、版本号等事实,资料中暂未提供。
许可与来源
Trellis 由 Mindfold 构建,采用 AGPL-3.0 许可,代码托管于 GitHub 仓库 mindfold-ai/Trellis。官方还提供社区与资源入口。