Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.trytrellis.app/llms.txt

Use this file to discover all available pages before exploring further.

​
Slash Commands是干什么的

Slash Commands是快捷方式。不用解释你想做什么，打 /command，AI 就知道该怎么做。 Trellis 只保留少量会话边界命令。大部分工作流动作现在由 auto-trigger skill 或 sub-agent 完成。项目自己的显式入口仍然可以做成自定义命令。

​
内置命令

​
会话边界

命令做什么
/trellis:start给没有自动会话注入的平台手动加载上下文；有 hook / extension 的平台会自动加载。
/trellis:continue把当前会话任务推进到 workflow 的下一步。
/trellis:finish-work结束会话。做最终检查，更新 journal，归档完成任务。

​
开发工作流

Skill / sub-agent做什么
trellis-brainstorm交互式发现和澄清需求。
trellis-before-dev编码前加载相关规范。
trellis-implement在支持的平台上用隔离 sub-agent 实现任务。
trellis-check按规范审查代码并自修复问题。

​
维护

Skill做什么
trellis-update-spec把学到的东西写进规范。
trellis-break-loop卡在循环里时调试。
/trellis:before-backend-dev、/trellis:check-backend、/trellis:record-session、/trellis:parallel 这类阶段命令已经在 Trellis 0.5 移除。现在的流程是 task-based：创建/规划任务，用 continue 推进下一步，最后用 finish-work 收尾。

​
使用命令

在 Claude Code 里打命令： 
/trellis:continue
命令会展开成完整的 prompt 告诉 AI 该做什么。你看不到这个 prompt，但 AI 会照做。

​
创建自定义命令

命令是 .claude/commands/ 里的 markdown 文件。创建新命令： 
mkdir -p .claude/commands/my-project
创建 .claude/commands/my-project/deploy-check.md： 
部署前检查：

1. 所有测试通过：`npm test`
2. 没有 TypeScript 错误：`npm run typecheck`
3. Lint 通过：`npm run lint`
4. 构建成功：`npm run build`

跑每个检查，报告结果。如果有失败的，说明哪里错了。
现在 /my-project:deploy-check 就能用了。

​
命令结构

命令文件就是一个 prompt。调用命令时，文件内容变成给 AI 的指令。 好命令：
  • 有清晰的步骤
  • 包含实际要跑的命令
  • 说明期望什么输出
  • 告诉 AI 失败了怎么办
差命令：
  • 模糊（“检查代码”）
  • 不说怎么检查
  • 让 AI 猜

​
命名空间

命令用文件夹名作为命名空间： 
.claude/commands/
├── trellis/           # /trellis:* 命令
│   ├── finish-work.md
│   └── continue.md
└── my-project/        # /my-project:* 命令
    └── deploy-check.md
把你项目的命令放在跟 Trellis 命令不同的文件夹。这样 Trellis 更新时不会冲突。

​
参数

命令可以接受参数。在命令文件里用 $ARGUMENTS 引用： 
审查 $ARGUMENTS 这个文件。

检查：

- 类型安全
- 错误处理
- 测试覆盖
用法：/my-project:review src/api/users.ts AI 拿到的 prompt 里 $ARGUMENTS 会被替换成 src/api/users.ts。