主线 · 第 2 / 5 篇
· 约 8 分钟
项目记忆放进文件:Trellis、Aegis 与轻量澄清
2026 年 5 月,小任务的步骤减了下来,三套框架也换掉了。留下的组合是:Trellis 把项目记忆写进仓库,Aegis 在高风险改动时把边界收紧,轻量澄清只问真正影响方案的问题。
本文回答的问题
先减掉了什么,项目记忆为什么要写进文件,流程的轻重又按什么来定?
上一篇停在连小改动也要走完整流程。这一篇写往回减:小任务的步骤减了下来,三套框架也换掉了,最后平时留下来用的是 Trellis、Aegis 和一个自己改过的轻量澄清 Skill,分别管项目记忆、改动风险和需求没说清这三件事。
减掉步骤,换掉框架
小任务这一头,处理办法很直接:关掉几套工具里功能重复的 Skill,再在规则里写明小任务怎么处理。到 5 月中旬,全局规则里写明了:小任务就算描述里出现 create、build、modify 这类词,也不升级成完整流程,直接改,只验证改到的部分。
框架也是 5 月换的。5 月 7 日,我清理了 GSD 留下的文件。Superpowers 和 GSD 从此不再使用,gstack 只保留在浏览器测试、设计复查等场景。
第一篇里参考的那篇指南,作者在补充说明里其实提醒过,小修改走整套流程太重。后来翻社区讨论,有类似感受的人不少:有人用过 GSD 和 Superpowers 之后回到了宿主自带的 Plan 模式;也有人连续几个月用 GSD 做完了一个带 CMS 的 SaaS,觉得复杂任务顺了很多。
回头看,麻烦出在我把同一套流程用在了所有任务上:跨模块的功能确实需要这些步骤,改一行文案就用不上。Superpowers 自己在 8 月的 v6.3.0 里也开始按任务大小区分流程,小任务不再固定生成设计和计划两份文档。
框架虽然换了,有几条做法延续了下来:动手前先定边界,复杂任务保留计划和检查记录,宣布完成之前要有验证。
聊天会断,记忆要留在仓库里
三套框架叠着用的时候,最麻烦的问题之一是换个会话,之前定好的约定就接不上了。项目一长,聊天记录会断,模型会换,工具也会换。没写下来的东西,只能靠我一遍遍重新讲。
Trellis 解决的就是这个。当时除了官方文档,我还读了 linux.do 上的一份 Trellis 技术分享。Trellis 把项目内容分成规范、任务和工作区三层,都是仓库里的文件,每次开始任务时重新读。模型其实没有记住什么,只是每次都从同一批文件读起,所以换了会话或者换了模型,也不用从头讲一遍项目。
用了一段时间,我给自己定了两条用法。一是什么项目值得用:要跨好几轮、跨模块、隔一阵还要回来接着做的项目,尽早建;一次性的小活不建。二是它只帮我记事,不替我想事。需求背景、关键决定、任务拆分和做到哪一步写进去,是为了下次能接上;文件写得多,不代表流程就完整。
后来别的工具产生的记录,也都写进当前的 Trellis 任务,不另建目录。一个任务的情况只记在一个地方,这一条后面还会反复出现。
我在 Trellis 上加的规则放在哪、升级时怎么处理,单独写了一篇延伸。
风险决定流程的轻重
小任务能直接做了,反过来也有风险:如果什么任务都走最短路径,删数据、迁移数据库这类改动就少了保护。
这一头我交给 Aegis。它是一套工程方法,要求动手之前先弄清楚:目标是什么、边界在哪、会影响到哪里、现在是什么状况、改完怎么验证。我只在几类情况下启用它,比如接手别人的项目、大规模重构、复杂 bug、动到共享的接口或数据结构、数据迁移和正式交付,平时不让它打扰。
先查,再问,一次只问一个
需求没说清时,模型应该先问,别装作听懂了。可每次都被问一长串,也挺累,而且很多答案本来就在文档和代码里。
我主要借的是 Matt Pocock 的 grill-me 和 grill-with-docs,在它们的基础上改出一个轻量版本 grill-with-me-lite。规则不多:能从对话、文档和代码里查到的,不问;一次只问一个关键问题;小任务一开始最多问一个;风险不大、信息也够的时候,把自己的假设写出来,接着做。我还在规则里写过一句,大意是别把我当成审批流程,细枝末节不用反复来确认。
这个 Skill 后来换过名字,触发条件也放宽过,但先查再问、一次一问这两条从 5 月到现在没有变过。
“查”具体用的是两个 MCP,各写了一篇延伸:往外查资料用 grok-search,往里查代码用 ACE。
三样各管一件事
这三样平时互不打扰:小任务直接做,任务拖长了靠 Trellis 接上,影响面大了 Aegis 收紧,需求说不清再去澄清。比起三套框架叠在一起,步骤少了很多。
参考资料
- Trellis 官方文档
- linux.do:Trellis 技术分享 的附件《从 Harness Engineering,再到 Trellis 落地》
- Aegis GitHub 仓库 与 社区讨论
- mattpocock/skills 里的 grill-me 与 grill-with-docs
- Superpowers RELEASE-NOTES(固定提交)
- Hacker News 评论 47418626、47418427
本文涉及的知识点
12 个
名称打开知识图谱中的对应条目;「另见」只计已发布文章。