个人站点

主线 · 第 2 / 5 篇

· 约 8 分钟

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

2026 年 5 月,小任务的步骤减了下来,三套框架也换掉了。留下的组合是:Trellis 把项目记忆写进仓库,Aegis 在高风险改动时把边界收紧,轻量澄清只问真正影响方案的问题。

本文目录 6 节
  1. 减掉步骤,换掉框架
  2. 聊天会断,记忆要留在仓库里
  3. 风险决定流程的轻重
  4. 先查,再问,一次只问一个
  5. 三样各管一件事
  6. 参考资料

本文回答的问题

先减掉了什么,项目记忆为什么要写进文件,流程的轻重又按什么来定?

上一篇停在连小改动也要走完整流程。这一篇写往回减:小任务的步骤减了下来,三套框架也换掉了,最后平时留下来用的是 Trellis、Aegis 和一个自己改过的轻量澄清 Skill,分别管项目记忆、改动风险和需求没说清这三件事。

减掉步骤,换掉框架

小任务这一头,处理办法很直接:关掉几套工具里功能重复的 Skill,再在规则里写明小任务怎么处理。到 5 月中旬,全局规则里写明了:小任务就算描述里出现 create、build、modify 这类词,也不升级成完整流程,直接改,只验证改到的部分。

改动的影响范围
轻量任务:直接实现单文件或小范围、明确的 bug、配置和文案、小测试、局部文档;只验证改动部分
影响扩大:流程加重公共接口、数据库结构、持久化、依赖、CI、迁移;只剩一处修复时降回
全局规则里的任务分流

框架也是 5 月换的。5 月 7 日,我清理了 GSD 留下的文件。Superpowers 和 GSD 从此不再使用,gstack 只保留在浏览器测试、设计复查等场景。

第一篇里参考的那篇指南,作者在补充说明里其实提醒过,小修改走整套流程太重。后来翻社区讨论,有类似感受的人不少:有人用过 GSD 和 Superpowers 之后回到了宿主自带的 Plan 模式;也有人连续几个月用 GSD 做完了一个带 CMS 的 SaaS,觉得复杂任务顺了很多。

回头看,麻烦出在我把同一套流程用在了所有任务上:跨模块的功能确实需要这些步骤,改一行文案就用不上。Superpowers 自己在 8 月的 v6.3.0 里也开始按任务大小区分流程,小任务不再固定生成设计和计划两份文档。

框架虽然换了,有几条做法延续了下来:动手前先定边界,复杂任务保留计划和检查记录,宣布完成之前要有验证。

聊天会断,记忆要留在仓库里

三套框架叠着用的时候,最麻烦的问题之一是换个会话,之前定好的约定就接不上了。项目一长,聊天记录会断,模型会换,工具也会换。没写下来的东西,只能靠我一遍遍重新讲。

Trellis 解决的就是这个。当时除了官方文档,我还读了 linux.do 上的一份 Trellis 技术分享。Trellis 把项目内容分成规范、任务和工作区三层,都是仓库里的文件,每次开始任务时重新读。模型其实没有记住什么,只是每次都从同一批文件读起,所以换了会话或者换了模型,也不用从头讲一遍项目。

规范 spec:项目约定
任务 tasks:每次工作的背景和进度
工作区 workspace:会话记录
项目记忆分层留在仓库里

用了一段时间,我给自己定了两条用法。一是什么项目值得用:要跨好几轮、跨模块、隔一阵还要回来接着做的项目,尽早建;一次性的小活不建。二是它只帮我记事,不替我想事。需求背景、关键决定、任务拆分和做到哪一步写进去,是为了下次能接上;文件写得多,不代表流程就完整。

后来别的工具产生的记录,也都写进当前的 Trellis 任务,不另建目录。一个任务的情况只记在一个地方,这一条后面还会反复出现。

我在 Trellis 上加的规则放在哪、升级时怎么处理,单独写了一篇延伸。

风险决定流程的轻重

小任务能直接做了,反过来也有风险:如果什么任务都走最短路径,删数据、迁移数据库这类改动就少了保护。

这一头我交给 Aegis。它是一套工程方法,要求动手之前先弄清楚:目标是什么、边界在哪、会影响到哪里、现在是什么状况、改完怎么验证。我只在几类情况下启用它,比如接手别人的项目、大规模重构、复杂 bug、动到共享的接口或数据结构、数据迁移和正式交付,平时不让它打扰。

先查,再问,一次只问一个

需求没说清时,模型应该先问,别装作听懂了。可每次都被问一长串,也挺累,而且很多答案本来就在文档和代码里。

我主要借的是 Matt Pocock 的 grill-me 和 grill-with-docs,在它们的基础上改出一个轻量版本 grill-with-me-lite。规则不多:能从对话、文档和代码里查到的,不问;一次只问一个关键问题;小任务一开始最多问一个;风险不大、信息也够的时候,把自己的假设写出来,接着做。我还在规则里写过一句,大意是别把我当成审批流程,细枝末节不用反复来确认。

这个 Skill 后来换过名字,触发条件也放宽过,但先查再问、一次一问这两条从 5 月到现在没有变过。

“查”具体用的是两个 MCP,各写了一篇延伸:往外查资料用 grok-search,往里查代码用 ACE。

三样各管一件事

日常任务
小任务直接做
任务变长Trellis 接住上下文
影响面变大Aegis 收紧边界
需求不清轻量澄清
几种情况可以同时出现,并不是依次执行的步骤

这三样平时互不打扰:小任务直接做,任务拖长了靠 Trellis 接上,影响面大了 Aegis 收紧,需求说不清再去澄清。比起三套框架叠在一起,步骤少了很多。

参考资料

本文涉及的知识点

12 个

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