跳转到主要内容

​
安装 Trellis

先全局安装 CLI： 
npm install -g @mindfoldhq/trellis@latest
然后在项目目录初始化： 
trellis init
这会创建一个 .trellis/ 目录，结构如下： 
.trellis/
├── workflow.md          # 工作流说明
├── spec/                # 你的编码规范
│   ├── frontend/
│   ├── backend/
│   └── guides/
├── workspace/           # 会话日志
└── tasks/               # 任务跟踪
如果是 Claude Code 项目，还会配置 .claude/ 目录，包含 hooks 和命令。

​
写第一个 Spec

打开 .trellis/spec/backend/index.md（如果主要写前端就打开 frontend/），填写模板。 一个真实的 spec 长这样： 
# 后端开发规范

## 错误处理

所有 API 接口返回错误时用这个格式：

{ "error": { "code": "VALIDATION_ERROR", "message": "邮箱不能为空" } }

使用 src/lib/errors.ts 里的 AppError 类。不要直接 throw Error 对象。

## 数据库

- 表名：snake_case，复数形式（user_sessions 而不是 UserSession）
- 必须包含 created_at 和 updated_at 时间戳
- 外键格式：{表名}\_id
写具体一点。带上文件路径。放项目里的真实代码。含糊的规范没用。

​
测试一下

开一个新的 Claude Code 会话，让它写点代码。检查它是不是遵循了你的规范。 如果没有，说明你的规范还不够具体。加更多例子进去。

​
接下来

核心概念

了解 Specs、Tasks 和 Workspace 是怎么配合工作的。

写好 Spec

让 AI 真正遵循规范的写作技巧。

命令参考

常用工作流的 Slash 命令。

多 Agent 协作

并行运行多个 AI Agent。