【学习笔记】Trellis-一个强大的AI脚手架

2026-04-11 08:291阅读0评论SEO教程
  • 内容介绍
  • 文章标签
  • 相关推荐
问题描述:

从关于trellis的一点问题,望解答~继续讨论:

Trellis

此处引用官方文档中的一句话:AI 的能力像藤蔓一样生长——充满活力但四处蔓延。Trellis 是 AI 的脚手架,引导它沿着规范的路径前进。

仅以此贴记录学习Trellis框架的过程~

我的理念一直是:没有最好的框架,框架只是工具,最重要的是其中蕴涵的设计思想。

首先,我贴上我与框架开发大佬的一次简单的Q&A:

image963×1003 72.3 KB

从我的问题可以了解到,我已经被网上各种技能包、框架等等强大的工具,信息轰炸到无从入手,也是从L站偶然发现Trellis这个框架,在帖子的下方收获了用户的一致好评,我便继续深入研究,发现确实是一个值得一用的框架,无论是企业团队还是个人,现将学习过程中整理的一些思路笔记分享与大家,不聊底层,只聊干货~

一、Trellis解决了什么,以及怎么解决的?

  • Lost in the middle(AI忽略规范):编写了Claude.md,5轮会话后就忘
    • Hook自动注入,每次对话都包含规范

  • 修A坏B:修一个bug引入另一个
    • Ralph Loop:先思考→行动→验证

  • 代码风格不一致:AI代码能跑但风格混乱
    • Spec系统:编码标准写一次,全员遵守

  • 需求膨胀:要一个按钮,AI写9000行
    • Plan Agent:拒绝并拆分过大的需求

  • 团队质量不均:每人AI写出不同风格
    • 共享Spec库:一人优化,全员受益

  • 跨会话失忆:新会话要重新解释上下文
    • 会话持久化:AI跨会话记住项目

二、Hook三驾马车

相信使用过Claude Code的小伙伴们应该对这个概念不陌生。hook-钩子,我不由得联想到前端的生命周期钩子函数,讲的是一个“触发时机“的概念,而在Trellis中就有着三个”触发时机“

  • session-start

    • 会话启动时注入上下文

      读取内容 来源 用途
      .trellis/.developer 开发者身份 知道"你是谁"
      .trellis/workflow.md 工作流指南 知道"怎么工作"
      workspace/{name}/index.md 会话历史 知道"上次做了什么"
      git log Git提交记录 知道"最近改了什么"
      .trellis/tasks/ 活跃任务列表 知道"当前任务是什么"
  • inject-subagent-context

    • Agent调用时注入精确Spec。

      Agent 注入内容 触发条件
      implement implement.jsonl + prd.md + info.md 实现功能时
      check check.jsonl + prd.md 代码检查时
      check [finish] finish-work.md + prd.md 完成检查时(轻量)
      debug debug.jsonl + codex-review-output.txt 调试bug时
      research 项目结构概览 + research.jsonl 信息搜索时
  • ralph-loop

    • Check完成后自动质量验证

      image729×505 11.8 KB

这三个”时机“触发保证了已经初始化好的spec文档能够真正的被使用上

三、实操清单

  1. 首次使用(AI自动扫描项目生成spec文档)
    1. npm install -g @mindfoldhq/trellis@latest

    2. cd your-project

    3. trellis init --claude -u your-name

    4. /start

  2. 日常使用
    1. /start

    2. /finish-work #检查完工清单

    3. /record-session #会话持久化存储

  3. Bug修复,以及SPEC规范沉淀
    1. # 修复bug后 /break-loop # 分析完成 → 手动编辑 .trellis/spec/ 文件 git add .trellis/spec/ git commit -m "docs: add prevention from break-loop" git push

网友解答:
--【壹】--:

反而会省 token

得益于我们 Spec 的渐进式披露,很多用户反馈把极长的 agents.md 变成 Trellis 的 Spec 后 Token 消耗和上下文占用少了很多


--【贰】--:

能看看佬的Agents.md吗


--【叁】--:

好东西,值得研究


--【肆】--:

感谢大佬呀


--【伍】--:

codex 适配吗


--【陆】--:

这个我一般用AI生成的,这个文件我没有细看以及调整,调整的大部分规范在spec文件夹下


--【柒】--:

大佬请教个问题omo装上后 opencode的build就没了对吗 有办法共存吗 感觉omo还一些小活浪费的时间有些多


--【捌】--:

支持的

image805×470 22.8 KB


--【玖】--:

我比较好奇这套方案对 Token 的消耗大吗?要是每次 Hook 都塞一堆 Spec 进去,长对话可能有点肉疼。


--【拾】--: Zimon:

从关于trellis的一点问题,望解答~继续讨论:

糟糕!该页面不存在或者是一个不公开页面。


--【拾壹】--:

build和plan可以理解为换成了更高级的赫菲斯托斯和普罗米修斯智能体,omo确实会有一些小活浪费时间和token,这就是让我感觉有点重的地方


--【拾贰】--:

VS codex 的 memories 怎么样?

有没有 memories 评测


--【拾叁】--: 经过 8 个月 Claude Code 高强度实战,我们决定开源内部的最佳实践 开发调优
前天我的 CTO 在站内发布了一篇技术贴,没想到竟然小爆了一下。我们当时正在准备开源,原本规划几周后再发,但这次的反响让我们意识到大家对 AI coding 的需求远超想象,于是决定提前开源。 昨天下午,我们正式发布了 Trellis,非常感谢论坛里各位佬友的支持,我们在纯自然流的情况下收获了 100+ star,也收到了很多有价值的反馈和建议。这里面大部分问题我们都会在接下来的几天内解决。 在…

--【拾肆】--: Zimon:

trellis

这能和其他例如superpowers一起使用吗


--【拾伍】--:

前排支持!

捉个虫,日常使用不需要 /check-backend(AI 被注入 /start 后会自动执行)


--【拾陆】--:

好的佬


--【拾柒】--: An:

memories

没研究过,目前主力opencode+omo 、claude+trellis


--【拾捌】--:

好问题,等我找到答案来告诉你


--【拾玖】--:

完全可以,不是竞争关系,是合作关系,但是框架作者推荐只用trellis,并且很多框架使用者已经转向了只使用trellis,如我帖子中与框架作者的Q&A所示

问题描述:

从关于trellis的一点问题,望解答~继续讨论:

Trellis

此处引用官方文档中的一句话:AI 的能力像藤蔓一样生长——充满活力但四处蔓延。Trellis 是 AI 的脚手架,引导它沿着规范的路径前进。

仅以此贴记录学习Trellis框架的过程~

我的理念一直是:没有最好的框架,框架只是工具,最重要的是其中蕴涵的设计思想。

首先,我贴上我与框架开发大佬的一次简单的Q&A:

image963×1003 72.3 KB

从我的问题可以了解到,我已经被网上各种技能包、框架等等强大的工具,信息轰炸到无从入手,也是从L站偶然发现Trellis这个框架,在帖子的下方收获了用户的一致好评,我便继续深入研究,发现确实是一个值得一用的框架,无论是企业团队还是个人,现将学习过程中整理的一些思路笔记分享与大家,不聊底层,只聊干货~

一、Trellis解决了什么,以及怎么解决的?

  • Lost in the middle(AI忽略规范):编写了Claude.md,5轮会话后就忘
    • Hook自动注入,每次对话都包含规范

  • 修A坏B:修一个bug引入另一个
    • Ralph Loop:先思考→行动→验证

  • 代码风格不一致:AI代码能跑但风格混乱
    • Spec系统:编码标准写一次,全员遵守

  • 需求膨胀:要一个按钮,AI写9000行
    • Plan Agent:拒绝并拆分过大的需求

  • 团队质量不均:每人AI写出不同风格
    • 共享Spec库:一人优化,全员受益

  • 跨会话失忆:新会话要重新解释上下文
    • 会话持久化:AI跨会话记住项目

二、Hook三驾马车

相信使用过Claude Code的小伙伴们应该对这个概念不陌生。hook-钩子,我不由得联想到前端的生命周期钩子函数,讲的是一个“触发时机“的概念,而在Trellis中就有着三个”触发时机“

  • session-start

    • 会话启动时注入上下文

      读取内容 来源 用途
      .trellis/.developer 开发者身份 知道"你是谁"
      .trellis/workflow.md 工作流指南 知道"怎么工作"
      workspace/{name}/index.md 会话历史 知道"上次做了什么"
      git log Git提交记录 知道"最近改了什么"
      .trellis/tasks/ 活跃任务列表 知道"当前任务是什么"
  • inject-subagent-context

    • Agent调用时注入精确Spec。

      Agent 注入内容 触发条件
      implement implement.jsonl + prd.md + info.md 实现功能时
      check check.jsonl + prd.md 代码检查时
      check [finish] finish-work.md + prd.md 完成检查时(轻量)
      debug debug.jsonl + codex-review-output.txt 调试bug时
      research 项目结构概览 + research.jsonl 信息搜索时
  • ralph-loop

    • Check完成后自动质量验证

      image729×505 11.8 KB

这三个”时机“触发保证了已经初始化好的spec文档能够真正的被使用上

三、实操清单

  1. 首次使用(AI自动扫描项目生成spec文档)
    1. npm install -g @mindfoldhq/trellis@latest

    2. cd your-project

    3. trellis init --claude -u your-name

    4. /start

  2. 日常使用
    1. /start

    2. /finish-work #检查完工清单

    3. /record-session #会话持久化存储

  3. Bug修复,以及SPEC规范沉淀
    1. # 修复bug后 /break-loop # 分析完成 → 手动编辑 .trellis/spec/ 文件 git add .trellis/spec/ git commit -m "docs: add prevention from break-loop" git push

网友解答:
--【壹】--:

反而会省 token

得益于我们 Spec 的渐进式披露,很多用户反馈把极长的 agents.md 变成 Trellis 的 Spec 后 Token 消耗和上下文占用少了很多


--【贰】--:

能看看佬的Agents.md吗


--【叁】--:

好东西,值得研究


--【肆】--:

感谢大佬呀


--【伍】--:

codex 适配吗


--【陆】--:

这个我一般用AI生成的,这个文件我没有细看以及调整,调整的大部分规范在spec文件夹下


--【柒】--:

大佬请教个问题omo装上后 opencode的build就没了对吗 有办法共存吗 感觉omo还一些小活浪费的时间有些多


--【捌】--:

支持的

image805×470 22.8 KB


--【玖】--:

我比较好奇这套方案对 Token 的消耗大吗?要是每次 Hook 都塞一堆 Spec 进去,长对话可能有点肉疼。


--【拾】--: Zimon:

从关于trellis的一点问题,望解答~继续讨论:

糟糕!该页面不存在或者是一个不公开页面。


--【拾壹】--:

build和plan可以理解为换成了更高级的赫菲斯托斯和普罗米修斯智能体,omo确实会有一些小活浪费时间和token,这就是让我感觉有点重的地方


--【拾贰】--:

VS codex 的 memories 怎么样?

有没有 memories 评测


--【拾叁】--: 经过 8 个月 Claude Code 高强度实战,我们决定开源内部的最佳实践 开发调优
前天我的 CTO 在站内发布了一篇技术贴,没想到竟然小爆了一下。我们当时正在准备开源,原本规划几周后再发,但这次的反响让我们意识到大家对 AI coding 的需求远超想象,于是决定提前开源。 昨天下午,我们正式发布了 Trellis,非常感谢论坛里各位佬友的支持,我们在纯自然流的情况下收获了 100+ star,也收到了很多有价值的反馈和建议。这里面大部分问题我们都会在接下来的几天内解决。 在…

--【拾肆】--: Zimon:

trellis

这能和其他例如superpowers一起使用吗


--【拾伍】--:

前排支持!

捉个虫,日常使用不需要 /check-backend(AI 被注入 /start 后会自动执行)


--【拾陆】--:

好的佬


--【拾柒】--: An:

memories

没研究过,目前主力opencode+omo 、claude+trellis


--【拾捌】--:

好问题,等我找到答案来告诉你


--【拾玖】--:

完全可以,不是竞争关系,是合作关系,但是框架作者推荐只用trellis,并且很多框架使用者已经转向了只使用trellis,如我帖子中与框架作者的Q&A所示