Trellis 是什么

​

Trellis 是什么

​

1.1 一句话定位

Trellis 是 AI 编码助手的脚手架 — 通过自动化机制注入项目规范，让 AI 每次都按你的标准写代码，而不是随机发挥。

AI’s capabilities grow like vines — full of vitality but spreading everywhere. Trellis is scaffolding for AI, guiding it along the path of your conventions.

​

1.2 解决的痛点

痛点	现状	Trellis 方案
规范写了 AI 不读	写了 CLAUDE.md，AI 5 轮对话后就忘了	Hook 自动注入，每次对话都携带规范
修 A 破 B 循环	AI 修复一个 bug 又引入新 bug	Thinking Guides + Ralph Loop：先想再做，做完验证
代码不连贯	AI 写的代码能跑但互不衔接	Cross-Layer Guide：写代码前先梳理数据流
需求膨胀	要一个按钮，AI 写了 9000 行	Plan Agent：拒绝并拆分过大需求
团队水平不一	每个人的 AI 写出不同风格的代码	团队共享 Spec，一人优化全队受益
跨会话失忆	新会话要重新解释项目背景	Session 持久化，AI 跨会话记住上下文

​

1.3 vs 传统方法对比

维度	.cursorrules	CLAUDE.md	Skills	Trellis
规范注入方式	每次对话手动加载	自动加载但容易被截断	用户主动调用	Hook 自动注入，按任务精准加载
规范粒度	一个大文件	一个大文件	每个 Skill 独立	按模块分文件，按任务组合
跨会话记忆	无	无	无	workspace journal 持久化
并行开发	不支持	不支持	不支持	Multi-Agent worktree 并行
质量控制	无	无	无	Ralph Loop 自动验证循环
团队共享	单人	单人	可分享但无标准	Git 版本化 Spec 库
支持平台	Cursor 专属	Claude Code 专属	按平台	Claude Code + Cursor + Codex + OpenCode + Kilo + Kiro

​

1.4 核心概念速览

概念	说明	存放位置
Spec（规范）	你的编码标准，用 Markdown 写成。AI 写代码前先读规范	.trellis/spec/
Workspace（工作区）	每个开发者的会话日志，让 AI 记住上次做了什么	.trellis/workspace/
Task（任务）	工作单元，包含需求文档和上下文配置	.trellis/tasks/
Hook（钩子）	自动触发的脚本，在会话启动、Agent 调用等时机注入上下文 [Claude Code 专属]	.claude/hooks/
Agent（代理）	专门角色的 AI 子进程，如 Implement、Check、Debug 等 [Claude Code 专属]	.claude/agents/
Skill（技能）	可复用的 AI 能力模块，可跨项目共享	.claude/skills/
Journal（日志）	会话记录文件，记录每次开发做了什么	.trellis/workspace/{name}/journal-N.md

Hook 和 Agent 系统是 Claude Code 专属功能。Cursor、Codex 等平台通过 Slash 命令手动加载规范， 实现相同的效果。Spec、Workspace、Task、Journal 等核心概念在所有平台上通用。