@SD10 感谢。是啊，最起码看看 意图。。我理解大家都越来越不能去看代码了

@justdoitzZ 感谢，希望对你有用啊。Solo 开发也能用上的，起码直观看到 ai 做了啥

@justdoitzZ 是的～，我们接下来会更新说明文档。现在做得太 geek 了，就觉得很有必要做这个工具自己用

review 时，点开一个 intent ，详情是这样子的： https://imgur.com/a/mImqF4R

会跟 git commit 绑定一起，agent 自动填写的

@Coverlove 人的好习惯👍

@justdoitzZ 你说的非常对，最好就是 AI 留痕，持续整理。问题是文档不跟代码走，所以我们做了意图绑定 commit ，从而也跟代码绑定了

之后就不会有文档孵化的问题了

@iugo 是的，现在 agent 都不太会这个，除非特意说明。 所以我们后来根据这些问题做了 mainline 。

我理解为 AI 时代的 git ， 让 agent 跟人使用的，关注意图，而不是关注代码

Ai 改代码之前永远先看意图，之后更新代码也更新意图（对人手动挡来说也一样）

@JZen 试试 mainline ，agent 自动记录到 git notes ，而且会同步到项目以及同事上。就不用再维护文档了

@loryyang AI 也不太行。。随时大小便留下文档，留下了就是一堆，相当于没有文档。。

@allanwell 开发懒啊。。有时 agent 自己有内存记忆了
现在都没规范，而且很多问题总不能全放 claude.md 里吧

@kneo 是啊，就应该让 Ai 去修，带上更多上下文

@DT37 那你是怎么处理的啊

@panghu960 不知道还以你是我们的软文😂 看看我这个帖子： https://www.v2ex.com/t/1210451?p=1#reply7

就是按照你这个思路做的

你们还 review AI 写的代码吗？

有意思，是给 agent 用的吗？

点进去 intent 会怎么样？

vibe coding 痛点是没法一览 Agent 都做了啥，所以我做了 https://mainline.sh

@foolishcrab 同意，这个问题本身不是 AI/Agent 才有的。人类工程师也一直会犯：没理解历史背景就改代码。Linus 那个骂法本质上也是在说这个。

我觉得 Agent 让它变得更突出，不是因为问题新，而是因为频率和规模变了：以前一个人没看懂乱改，是一个 PR ；现在多个 agent 可以很快在不同分支里重复同样的误解，而且它们不会像团队成员一样通过日常讨论、事故记忆、Slack 背景慢慢“渗透式”获得上下文。

`AGENTS.md` / rules 文件我觉得适合放稳定规则，比如代码风格、测试命令、架构偏好、不要用某个库之类。

但很多历史意图不是稳定规则，而是有生命周期的决策记录：

* 这个方案试过，但因为 X 被 abandoned ；
* 这个 decision 已经被 superseded ；
* 这个 legacy path 暂时不能删，但未来某个条件满足后可以删；
* 这个 migration 有未关闭风险；
* 这个约束只和某些文件/commit/PR 有关。

如果都塞进 `AGENTS.md`，它很快会变成一份越来越长、越来越难维护的“历史垃圾桶”。Agent 也很难知道哪条和当前 diff 真的相关。

所以我不是想替代 `AGENTS.md`，而是想把它分层：

`AGENTS.md`：长期行为规则。
Mainline：和具体工程改动相关的 intent record ，可以按当前文件、分支、commit 、in-flight work 检索。

也就是：不是“让 agent 自动更新一个大说明文档”，而是让它在做重要改动时留下结构化的 why ，未来相关改动前能被取出来。

@9684xtpa actor log 是结构化的，Agent 装了 skill 后自动记录，读取，而且持久化、渐进式记录到 git 上。
你写到 md 上，就需要结构化、渐进式记录。也不是不能做到，就像 text 也可以用 grep 做数据库一样，为什么还需要 mysql, nosql

😂 怎么都没人回复的