> ## Documentation Index
> Fetch the complete documentation index at: https://gnero.genetind.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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` |

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