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 等核心概念在所有平台上通用。
