公开知识库

Trellis 使用教程

6分钟阅读

Trellis 使用教程：让 Claude Code 和 Codex 更像工程团队成员

学完你应该获得什么

  • 知道 Trellis 解决的是 AI 编码的流程、规范和记忆问题，不是替换模型。
  • 能完成安装、初始化、平台选择和 spec 模板选择。
  • 理解 task、brainstorm、spec、check、finish-work 在开发链路里的作用。
  • 知道如何减少新会话忘上下文、需求漂移和代码缺少质量收口的问题。

一句话总论

Trellis 把 AI 编码从“临时对话”变成“项目内工作流”：先初始化规范，再让 Agent 按阶段确认需求、执行开发、检查质量、记录日志并归档任务。它让 Claude Code、Codex、Cursor 等工具拥有可追踪、可恢复的项目上下文。15

适用场景

适合已在用 Coding Agent 的开发者，尤其适合长任务、多轮需求、上下文容易丢失的项目。安装命令结合官方文档校正为 npm install -g @mindfoldhq/trellis@latest。

知识地图

  • 安装初始化：在项目目录安装并运行初始化，填写开发者名，选择 Claude Code、Codex、Cursor 等平台。1
  • 模板选择：可用默认模板，也可选 custom、Electron、Next.js、Cloudflare Workers 等 spec 模板。2
  • 需求阶段：复杂任务会创建 task，进入 brainstorm，生成并完善 spec。3
  • 执行阶段：确认 spec 后进入开发，Trellis 会在开发前注入项目上下文与规范。4
  • 检查阶段：开发后运行 trellis check，检查规范、质量；跨层任务还看读写链路和错误传递是否一致。4
  • 收尾恢复：用 trellis finish-work 记录日志、归档任务。5

核心概念

Trellis：面向 AI 编码的 workflow harness，把任务、规范、日志和记忆放进项目，让不同 Agent 按同一套约束工作。

Spec：复杂任务的需求文档。它把“我想要个功能”变成可审核、可执行的范围和验收标准。3

阶段推进：忘记当前阶段或想继续时，可以用继续命令让 AI 判断状态并推进。5

质量检查：trellis check 是开发后的收口动作，别让 AI 写完代码就拍拍屁股走人。4

跨会话记忆：finish-work 把当前任务状态写成日志并归档，缓解上下文压缩带来的遗忘。6

实践流程

  1. 在目标项目安装并初始化 Trellis。
  2. 选择接入平台和 spec 模板；第一次可先用默认模板。
  3. 描述需求，让复杂任务先生成 task、brainstorm 和 spec。
  4. 审核 spec，补充范围、约束和验收标准。
  5. 确认后进入执行阶段。
  6. 开发后运行检查，重点看规范、跨层链路和错误处理。
  7. 任务完成或上下文快满时运行收尾命令，留下日志和归档。

关键洞察

Trellis 的价值不在“让 AI 多写”，而在“让 AI 少乱写”。复杂任务先写 spec，再执行、检查、归档，前期会慢一点，但能少返工。

更关键的是连续性。Trellis 把状态留在项目里，让新会话不必重新猜项目脉络。6

坑点

  • 不审 spec 就执行，后面检查再严格也救不了方向错。
  • 只把 Trellis 当提示词工具用，会浪费它的项目级记忆和规范沉淀。
  • AI 字幕把 Trellis、Claude、Codex、trellis init、trellis continue 等词识别得较乱，本文已结合标题和官方文档校正。
  • 视频未覆盖评论区和 custom 模板维护，团队落地还要单独补规范设计。

自测题

  1. Trellis 主要解决什么？答：任务、规范、检查和记忆沉淀。
  2. 为什么复杂任务要先写 spec？答：先定范围和验收标准，减少返工。
  3. trellis check 什么时候用？答：开发后做质量与规范检查。
  4. finish-work 的作用是什么？答：记录日志、归档任务，方便新会话继续。
  5. 它最适合什么场景？答：长任务、多轮协作、上下文容易丢失的 AI 编码项目。

证据与原文位置

安装与平台选择见 1；task、brainstorm、spec 见 3；上下文注入、trellis check 和跨层检查见 4；阶段继续、finish-work 与跨会话记忆见 5。

证据脚注

  1. P01@00:00:01-00:00:46
  2. P01@00:00:46-00:01:21
  3. P01@00:01:21-00:02:28
  4. P01@00:02:28-00:03:23
  5. P01@00:03:23-00:04:07
  6. P01@00:04:08-00:04:41

来源、覆盖与局限

此文件夹下有0条笔记。