个人站点

延伸自 项目记忆放进文件:Trellis、Aegis 与轻量澄清

· 约 6 分钟

给 Trellis 加的那一层:从改它的文件到单独放一份配置

到 2026 年 6 月初,我的规则是直接写在 Trellis 的流程文件里;7 月改成规则另放、流程里只留指针,升级后用脚本补回;9 月升级时撤回这些改写,换成一份锁定上游版本的完整配置。截至 10 月,两种放法并存。

本文目录 7 节
  1. 6 月:直接改它的流程文件
  2. 7 月:规则另放,流程里只留指针
  3. 9 月 8 日:撤回改写,锁定一份配置
  4. 9 月 9 日:另一个项目就地精简
  5. 9 月 15 日:协作规则并进配置
  6. 两种放法并存
  7. 参考资料

本文回答的问题

我往 Trellis 上加的规则放在哪,升级时怎么不被冲掉,后来为什么换了放法?

主线第 2 篇写了 Trellis 管什么:规范、任务和工作区都留在仓库里。这篇写我在它上面加的那一层:自己的规则放在哪,Trellis 升级时怎么处理。前后换过三种放法,每种里都有 CCG 的协作规则。

6 月:直接改它的流程文件

到 6 月初,CCG 的协作规则已经写成一份单独的说明,放在 Trellis 的规范目录 spec/guides。Trellis 自带的流程文件 workflow.md 也直接改了,当时的版本是 0.5.17,一共 14 处。改的内容是:哪类任务要用 CCG、协作的记录写进当前的 Trellis 任务、不另建 .ccg 任务、前端方向没批准不动手、方向错了退回重做。

7 月:规则另放,流程里只留指针

7 月 9 日升级到 0.6.5 时,这层重写了一遍。那次的说明里写,Trellis 的脚本和模板之间互相有约定,升级要整体换掉它管的文件,不能挑着换。流程文件归它管,直接写在里面的内容,每升级一次就要重新改一遍。

当时定的原则是:“实体规则住在 update 安全区,托管区只放指针,升级靠脚本回注”。规则正文还放在 spec/guides,Trellis 升级不动这个目录;流程文件里只插几句话,说明什么情况去读哪份说明。一开始插了 12 处,比如这一句:

Multi-model / frontend-visual / complex-review / external-handoff task: record a CCG Strategy section in prd.md (rules: `.trellis/spec/guides/ccg-collaboration.md`). Trellis stays the source of truth — do NOT create `.ccg/tasks`.

插句子用的是一个脚本:先在上游原文里找约好的那句话,正好找到一处才插,插过的不重复插,找不到就报错退出,等人看过新模板、改好脚本再跑。升级也定成了固定的几步:

看上游改动和留着的原版对比
整体升级换掉它管的文件
补回指针对不上就报错
空跑一遍用模糊的前端需求试
7 月定的升级步骤

后来同一个脚本又接入了 Architecture Bootstrap 的架构基线规则,以及从 Ponytail 吸收的实现简化规则。前者让任务读取和检查项目基线,后者要求先用已有能力、不要提前增加眼下用不到的机制。到 9 月一共 28 处:CCG 12 处,架构 12 处,简单 4 处,全在 workflow.md 这一个文件里。两项规则的采用边界,写在整理 Skill 那篇里。

9 月 8 日:撤回改写,锁定一份配置

9 月 8 日准备升级到 0.6.16,先在副本上演练,脚本退出了:新模板里找不到 CCG 第 3、4、11 处要找的原句。28 处这次全部撤回,没有去修那 3 处。原因第 4 篇写过,主要是嫌繁琐,又赶上大家在说模型变强了。

换上的是一份自己维护的完整配置:精简过的流程文件、九个常用入口的精简正文、一份本机规则说明,和它对应的上游版本一起锁住。升级时整份换上去,不再往上游文件里插句子。

项目7 月:插指针9 月:整份配置
流程文件上游原文加 12 处,后来 28 处自己维护的精简版,七个状态和 13 个步骤照旧
上游改了怎么办插的时候找不到原句,报错退出动手前核对上游版本和关键模板,变了就停
项目配置升级前先提交 .trellis/升级前存下两份配置,跑完恢复
CCG 说明放在 spec/guides还放在 spec/guides,项目里没有才装
7 月和 9 月两种放法的对照

初始化和升级都走一个固定的入口脚本。它先查装的是不是锁定的版本、关键模板有没有变、配置全不全、项目里有没有没看过的自定义 hook,有一项不对就停,不调用 Trellis。Trellis 强制更新时会把配置模板也换掉,所以脚本在跑之前存下 .trellis/config.yaml 和 .codex/config.toml,跑完放回去。

同一轮把入口和流程都压短了:九个入口从 1,092 行减到 133 行,流程文件从 722 行减到 111 行。行数只说明文字少了多少,不代表跑得更快或者模型做得更好。这份配置当天先装进一个项目试点。

9 月 9 日:另一个项目就地精简

另一个项目还是 0.5.17,流程文件还是 6 月那一份。9 月 9 日没有给它换配置,而是在项目里直接减了一轮。清单列了 9 项,做了前 8 项,比如:

  • 范围明确的小任务直接做,不用先说一句话跳过规划。
  • 保存进度、归档、Git 提交分开处理,关掉自动提交。
  • 已有的验证结果还覆盖改动时直接复用,不因为换了阶段再验一遍。

第 9 项是 CCG 改造,先挂着,CCG 说明和调用通道都没动。做完以后,38 个规则文件合计从 217,682 字节降到 105,813 字节,少了约 51.4%;流程文件从 705 行降到 503 行。字节数不等于 Token,不代表实际消耗少了一半。

这次只改了这个项目,没有同步回那份共用配置。为什么没换配置,记录里没写。

9 月 15 日:协作规则并进配置

9 月 10 日和 12 日定下的按职责派活(第 5 篇写过),9 月 15 日并进了这份配置,版本记作 0.6.16.2。多了一份协作规划说明和两个模板,一个给人看的总览,一个给执行者的任务包。

装的规矩是:项目里没有才装;装过的先核对还是不是原样,被改过就停下,不覆盖。已有的项目不自动迁移,已经派出去的任务按原来的范围做完。

两种放法并存

截至 10 月 9 日,试点项目用的还是 9 月 8 日那版配置,9 月 15 日加的规划说明没有装进去;就地精简的那个项目还是 0.5.17;我翻过的其他项目都没用这份配置。

三种放法里,CCG 说明一直是 spec/guides 下单独的一份。变的是流程文件里怎么写它:6 月直接改进 Trellis 的流程文件,7 月插一句指过去,9 月整份流程由我自己维护。

参考资料

本文涉及的知识点

9 个

名称打开知识图谱中的对应条目;「另见」只计已发布文章。