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 查以前相关对话,不要只凭记忆回答。

最终记忆卡#

  1. 想做项目流程:走官方 Trellis。
  2. 想保留工作习惯:写进并读取 .trellis/spec/guides/
  3. 想沉淀长期规则:写 .trellis/spec/
  4. 想查过去对话:用 trellis mem
  5. 不要再恢复旧规则层。

如果还没理解 Trellis 的基本用法,先看 Trellis 小白入门

Trellis Skill 分工:官方流程和项目规则怎么配合
https://blog.konbakuyomu.us/posts/trellis-skill-roles/
作者
konbakuyomu
发布于
2026-06-30
许可协议
CC BY-NC-SA 4.0