745 字
4 分钟
Trellis Skill 分工:官方流程和项目规则怎么配合
这篇只解释一件事:Trellis 的官方流程和项目本地规则应该怎么分工。
核心结论很短:
官方 Trellis 管流程。项目本地 spec 管这个项目的工作习惯。不要再用旧的全局 overlay skill 抢 Trellis 流程,也不要保留一个中间入口去接管官方机制。项目习惯应该直接写进 .trellis/spec/。
官方 Trellis skill 负责什么
| Skill | 用途 |
|---|---|
trellis-meta | 理解和定制 Trellis 架构、workflow、hooks、平台文件 |
trellis-spec-bootstrap | 用真实项目刷新 .trellis/spec/ |
trellis-session-insight | 通过 trellis mem 回忆以前的 AI 对话 |
trellis-start | 开始会话时读取当前 task、workflow、spec |
trellis-brainstorm | 需求不清楚时先讨论 PRD |
trellis-before-dev | 写代码前读取相关规则 |
trellis-check | 完成后检查 |
trellis-update-spec | 把长期有效的经验写进 spec |
trellis-finish-work | 收尾、归档、写 journal |
普通使用者不需要背这些名字。你只要会对 AI 说“按 Trellis 流程来”“先 planning”“做完 check 和 finish-work”,AI 应该自己选择合适的 skill。
项目本地规则放在哪里
项目本地规则入口通常是:
.trellis/spec/guides/写代码、改文档或收尾任务前,AI 应该从这里的 index 开始,再按场景读取具体规则。
| 场景 | 该读什么 |
|---|---|
| 工具路由 | .trellis/spec/guides/tool-routing-thinking-guide.md |
| PRD 写法 | .trellis/spec/guides/prd-conventions-guide.md |
| 任务使用规则 | .trellis/spec/guides/trellis-usage-canon-guide.md |
| 归档纪律 | .trellis/spec/guides/archive-discipline-guide.md |
| 长期知识沉淀 | .trellis/spec/guides/software-knowledge-guide.md |
可以直接对 AI 说:
请读取 .trellis/spec/guides/index.md,并按当前任务读取相关项目本地规则。本地规则不负责什么
.trellis/spec/guides/ 不应该接管官方 Trellis 机制。下面这些事应该走官方 Trellis 或 trellis-meta,而不是项目本地规则:
初始化 Trellis更新 Trellis修改 .trellis/workflow.md恢复旧 workflow breadcrumb替代 trellis-meta安装 marketplace 旧 skill如果你想改 Trellis 自身机制,应该说:
请使用 trellis-meta 检查 Trellis 结构和平台文件。旧入口怎么处理
这些旧心智应该退役:
obsidian-vault-ai-rules旧的全局 bootstrap skill旧的 overlay 恢复脚本旧拼写的 spec bootstrap skill以后看到它们,先判断是不是历史记录。历史 task、journal、旧 worktree 里出现是正常的;live instructions 里不应该再把它们当成操作入口。
和 AI 沟通的推荐说法
如果你只是要它遵守当前项目习惯:
请先读取当前项目的 .trellis/spec/guides/index.md,再按任务类型读取相关规则。如果你要开始一个正式项目任务:
请按 Trellis 流程创建 task。先进入 planning 阶段,不要直接实现。如果你要沉淀经验:
这次有长期价值的经验,请按 trellis-update-spec 写进 .trellis/spec/,然后 finish-work 收尾。如果你要查以前怎么处理过:
请用 trellis-session-insight 或 trellis mem 查以前相关对话,不要只凭记忆回答。最终记忆卡
- 想做项目流程:走官方 Trellis。
- 想保留工作习惯:写进并读取
.trellis/spec/guides/。 - 想沉淀长期规则:写
.trellis/spec/。 - 想查过去对话:用
trellis mem。 - 不要再恢复旧规则层。
如果还没理解 Trellis 的基本用法,先看 Trellis 小白入门。
Trellis Skill 分工:官方流程和项目规则怎么配合
https://blog.konbakuyomu.us/posts/trellis-skill-roles/