关于在团队项目中个人使用Trellis的讨论

Trellis 版本：0.6.3

问题背景

Trellis 的工作机制天然要求 .trellis/ 目录位于项目根目录下。它的 CLI（task.py、get_context.py 等）通过向上查找 .trellis/ 来确定项目根路径，spec 指南、session 日志、task 上下文都依赖这个路径约定。所以我现在在项目里用 Trellis，为了防止额外的约束和后续升级的稳定，得把.trellis/ 放在项目目录里。

个人痛点

因为我用 Trellis 是个人使用、不走团队 git，所以我必须把 .trellis/ 从团队仓库排除。于是出现一个死结：

• 留在项目目录 → Trellis 正常运作，但文件完全失去 git 版本管理


• 移到项目外 → Trellis CLI 可能全部失效，spec/context 机制报废（说不定也支持，我没有太研究文档 ^-^）

实际我用了一段时间，每次 task 记录、session 日志、spec 指南的修改，没有任何历史保护，有时候心里也挺慌的 ^-^。误删、回滚、对比变更都做不到。只能说是万一发生了啥看看能不能通过ide找回来。

之前的做法

我直接在 .git/info/exclude 里排除 .trellis/，这样不会污染暂存区，也不会修改项目的.gitignore。因为如果暂存区有东西，Trellis的 finish work 会卡住 ^-^。

现在的方案

我直接在 .trellis/ 内部创建独立的 git 仓库：

项目根/

├── .git/               ← 团队仓库（.trellis/ 被 exclude）

├── .trellis/

│   ├── .git/           ← 个人 Trellis 仓库（独立版本管理，互不干扰）

│   ├── .gitignore      ← 排除 .runtime/、backup 等运行时文件

│   ├── tasks/

│   ├── workspace/

│   └── config.yaml     ← session_auto_commit: false

└── src/

因为我常年Agent的目录都是外层的仓库目录，所以要让他提交到我创建的这个内部仓库就得额外做一些操作 ^-^。

• 关闭 Trellis 自带的 session_auto_commit（避免在外层仓库做无用操作）


• 所有提交通过 git -C .trellis 显式指定目标

为了让 AI 感知内层仓库，我选择在项目的 AGENTS.md（或者其他能加载到上下文的位置）中加一段声明：

## Trellis 内层 Git 仓库



`.trellis/` 内存在一个独立的 git 仓库，不在外层项目仓库管理范围内。



每次 Trellis task 操作（create / start / finish / archive）或 session 结束时，

必须将变更提交到内层仓库：



git -C .trellis add -A

git -C .trellis commit -m "task({slug}): {action} - {title}"



提交信息从 task.json 的 id 和 title 字段读取，格式固定可追溯。

这样 AI 在每次 task 操作后，我可以让他在外层提交到内部仓库里。

不知道有没有佬用Trellis也遇到过类似的问题，有没有别的处理方案，欢迎讨论。