742 字

4 分钟

Trellis 命令速查：版本、任务和历史怎么查

2026-06-30

AI 工具

Trellis

/

CLI

/

AI 协作

这篇只是 Trellis 命令速查。想先理解怎么和 AI 一起做项目，先看 Trellis 小白入门。

日常使用时，优先用自然语言让 AI 走 Trellis 流程，不要一开始背命令。命令主要用于检查版本、更新项目、查 task、查上下文和查历史。

先看版本和项目状态#

1
trellis --version
2
Get-Content .trellis\.version
3
trellis update --dry-run --migrate

几个常见输出可以这样理解：

看到什么	意思
`✓ Already up to date!`	当前项目 Trellis 已经和 CLI 对齐
`Modified by you`	文件被改过，Trellis 不敢直接覆盖
`Template updated`	官方模板有更新，正式 update 会写入

不确定会改什么时，先用 --dry-run。不要一上来就强制覆盖。

新项目初始化#

Codex 项目：

1
cd <project-path>
2
trellis init --codex -u <user> --skip-existing -y

Claude 项目：

1
cd <project-path>
2
trellis init --claude -u <user> --skip-existing -y

<user> 换成你的 Trellis 用户名。--skip-existing 的意思是遇到已有文件时先保守跳过，适合已有项目接入 Trellis。

旧项目升级#

先预览：

1
trellis update --dry-run --migrate

确认后更新：

1
trellis update --migrate

不确定时不要直接 -f。-f 是强制覆盖，只有你明确知道要覆盖哪些文件时才用。

查当前 task#

1
python .\.trellis\scripts\task.py current --source
2
python .\.trellis\scripts\task.py list

创建 task 通常交给 AI 做。你只需要说：

1
请按 Trellis 流程创建 task，先澄清 PRD，再实现。

如果 current --source 显示没有当前 task，就不要假装自己还在某个任务里。先让 AI 判断这次是否需要新建 task。

查项目上下文#

1
python .\.trellis\scripts\get_context.py
2
python .\.trellis\scripts\get_context.py --mode phase
3
python .\.trellis\scripts\get_context.py --mode packages

这三条分别适合：

命令	用途
`get_context.py`	看开发者、git 状态、当前 task、活跃 task
`--mode phase`	看 Trellis workflow 阶段和下一步
`--mode packages`	看项目有哪些 spec 层，决定该读哪些规则

查以前 AI 对话#

1
trellis mem list
2
trellis mem search "<关键词>"
3
trellis mem projects

当你问“上次怎么解的”“之前讨论过吗”“那个决定是什么”时，应该让 AI 用 trellis mem 查，而不是只凭聊天窗口里的短期上下文回答。

项目本地检查#

项目里如果有 .trellis/spec/guides/，可以做一些轻量检查：

1
python .\.trellis\scripts\get_context.py --mode packages
2
python .\.trellis\scripts\task.py current --source
3
python .\.trellis\spec\guides\check-archive-invariants.py

如果项目有 Codex hook，还可以做一个 smoke：

1
'{"hookEventName":"UserPromptSubmit","prompt":"smoke"}' | python .\.codex\hooks\inject-workflow-state.py

这些命令只能说明对应检查通过，不等于项目整体完成。完成结论仍然要回到任务验收标准。

不要再用的旧入口#

不要再把下面这些当成日常 Trellis 用法：

1
恢复旧规则层
2
运行旧的 overlay 恢复脚本
3
用旧的全局 bootstrap skill 接管官方流程
4
安装旧拼写的 spec bootstrap skill

现在的规则是：

1
官方 Trellis 管流程。
2
当前项目的本地习惯直接写进 .trellis/spec/guides/。

Skill 和规则分工可以看 Trellis Skill 分工。

最小命令卡#

只想保留最短列表，可以记这几条：

1
trellis --version
2
trellis update --dry-run --migrate
3
python .\.trellis\scripts\get_context.py --mode packages
4
python .\.trellis\scripts\task.py current --source
5
python .\.trellis\scripts\task.py list
6
trellis mem search "<关键词>"