Trellis是什么
AI 编程脚手架,把项目规范、任务进度、工作记忆、经验沉淀,从临时对话搬到项目下的文件中。它解决的核心问题不是“AI 会不会写代码”,而是“怎么让 AI 在复杂项目里,长期、稳定、按照项目规范完成开发任务”。
三大优势:
显著缓解会话失忆:它可以把任务当前的进展状况记录在日志里,新会话启动,自动从日志中恢复当前的任务记忆
跨平台共享核心:.cursorrules 只能在 cursor 用,CLAUDE.md 只能在 claude code 用,但.trellis/ 核心是跨平台的,支持各种编程工具
形成完整的项目级闭环:把 spec、task、workflow、journal 组织成完整闭环,比如:
- spec 管长期规范
- task 管当前任务
- workflow 管当前阶段
- journal 管工作记忆
- 任务收尾的时候,ai 会引导我们判断哪些经验值得长期复用,再把稳定规则写回 spec 里面


核心结构
Trellis 的核心结构在项目根目录的 .trellis/ 文件夹中。它取代了传统的单体规则文件,拆分为三个维度:
- trellis/spec/(规范层)
用于存放 Markdown 格式的编码标准、目录结构规则、评审习惯等。Trellis 的机制是按需加载,它只会向 AI 注入与当前任务相关的规范,而不是一次性塞入所有内容。
- trellis/tasks/(任务层)
存放结构化的 prd(需求文档)、design(设计文档)、implement(实现计划)以及当前任务信息。这能确保 AI 的产出始终紧扣业务目标,不偏离任务轨道。
- 列表项trellis/workspace/(记忆与工作区)
这是解决“会话失忆”的核心。这里存放工作日志(Journals)。它会记录上一次会话执行了什么、发现了什么 Bug、下一步要做什么。每次新会话开始时,AI 会先读取工作区日志,无缝接续上次的思考逻辑。建议上述三部分加入到git,这样整个团队都可以共享。
工作流程
- 新会话启动时,先恢复项目上下文
- 每轮 prompt 注入 workflow-state
- 判断当前对话是否需要创建 task
- planning 阶段把需求整理成 task artifact
- execute 阶段按 task artifact + spec 实现
- check 阶段按任务和规范复核
- update-spec 阶段筛选稳定经验
- work commit 先完成
- finish-work 归档 task,写 journal

团队使用建议
需要进入 git 的有这些:
- trellis/spec/:团队规范,和代码一样走 pr review
- trellis/tasks/:任务目录(prd、design、research),是项目资产
- trellis/workspace/{name}/:各开发者的 journal,/trellis:finish-work 会追加 journal
不需要进入 git 的有这些:
- trellis/.developer:记录当前开发者名,gitignored
- trellis/.runtime/:会话运行时状态,gitignored
重要 spec 改动应该在团队里讨论,spec 库要当成团队代码来维护。
这样规范演进是可控的、可追溯的。不会出现某个人私自改了规范,其他人不知道的情况。
和其他Harness的区别


基础使用
略
其他
如果感觉Trellis还是很重,可以尝试用 mattpocock/skills 系列的 skill 组合:
grill-me/grill-with-docs(需求聊透) → prototype(可选,快速输出demo,验证可行性) → to-prd(输出方案) → to-issues(任务拆分) → tdd(测试驱动开发)→ diagnose(可选,改bug)


正在连接评论服务,请稍候…