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

# 工作流演示

> 看看 Trellis 完整工作流的实际效果: 从需求到交付

<div className="td-wrap">
  <div className="td-inner">
    <div className="td-glow" />

    <div className="td-window">
      <div className="td-titlebar">
        <div className="td-dots">
          <div className="td-dot td-dot-r" />

          <div className="td-dot td-dot-y" />

          <div className="td-dot td-dot-g" />
        </div>
      </div>

      <div className="td-body">
        <div className="td-line td-line-user td-d0">
          <span className="td-prompt">❯ </span>
          <span className="td-cmd">新 AI 会话</span>
        </div>

        <div className="td-line td-line-ai td-d1">
          <span className="td-bullet">● </span>
          已加载: workflow, 3 个活跃任务, 分支 <span className="td-link">feat/v0.5.0-rc</span>
        </div>

        <div className="td-line td-line-ai td-d2">
          <span className="td-bullet">● </span>
          你想做什么？
        </div>

        <div className="td-line td-line-user td-d3">
          <span className="td-prompt">❯ </span>
          给 Trellis 添加 Gemini CLI 支持，参考 Cursor 的集成方式
        </div>

        <div className="td-line td-line-ai td-d4">
          <span className="td-tool-name">● Bash</span>
          <span className="td-tool-args">(task.py create "Gemini CLI support" --slug gemini-cli)</span>
        </div>

        <div className="td-line td-line-agent td-d5">
          <span className="td-agent-icon">▶ </span>
          <span className="td-agent-name">research</span>
          <span className="td-agent-desc">(查找平台集成规范和代码模式)</span>
        </div>

        <div className="td-line td-line-loading" style={{animationDelay: '5.4s'}}>
          └ 初始化中...
        </div>

        <div className="td-line td-line-sub td-d6">
          └ 完成 <span className="td-dim">(36 次工具调用 · 86.5k tokens · 2m 25s)</span> <span className="td-success">✓</span>
        </div>

        <div className="td-line td-line-ai td-d7">
          <span className="td-tool-name">● Bash</span>
          <span className="td-tool-args">(task.py add-context ... platform-integration.md, cursor.ts, ai-tools.ts)</span>
        </div>

        <div className="td-line td-line-sub td-d8">
          └ 6 个规范文件已添加到 <span className="td-link">implement.jsonl</span>
        </div>

        <div className="td-line td-line-ai td-d9">
          <span className="td-tool-name">● Bash</span>
          <span className="td-tool-args">(task.py start ...)</span>
          <span>: hooks 将自动注入上下文到 Agent</span>
        </div>

        <div className="td-line td-line-agent td-d10">
          <span className="td-agent-icon">▶ </span>
          <span className="td-agent-name">implement</span>
          <span className="td-agent-desc">(实现 Gemini CLI 平台支持)</span>
        </div>

        <div className="td-line td-line-loading" style={{animationDelay: '12.8s'}}>
          └ 正在写入 src/configurators/gemini.ts...
        </div>

        <div className="td-line td-line-sub td-d11">
          └ 完成 <span className="td-dim">(99 次工具调用 · 162.5k tokens · 12m 3s)</span> <span className="td-success">✓</span>
        </div>

        <div className="td-line td-line-ai td-d12">
          <span className="td-bullet">● </span>
          TypeCheck <span className="td-success">✓</span> · Lint <span className="td-success">✓</span> · Tests: 337/337 <span className="td-success">✓</span>
        </div>

        <div className="td-line td-line-agent td-d13">
          <span className="td-agent-icon">▶ </span>
          <span className="td-agent-name">check</span>
          <span className="td-agent-desc">(对照代码规范审查实现)</span>
        </div>

        <div className="td-line td-line-loading" style={{animationDelay: '17.6s'}}>
          └ 正在读取 diff... 14 个文件变更
        </div>

        <div className="td-line td-line-sub td-d14">
          └ 发现 1 个问题：缺少 EXCLUDE\_PATTERNS 条目
        </div>

        <div className="td-line td-line-sub" style={{animationDelay: '19.8s'}}>
          └ 已自动修复 <span className="td-success">✓</span>
        </div>

        <div className="td-line td-line-user td-d15">
          <span className="td-prompt">❯ </span>
          <span className="td-cmd">把 Gemini CLI 约定沉淀进 spec</span>
        </div>

        <div className="td-line td-line-ai td-d16">
          <span className="td-tool-name">● Read</span>
          <span className="td-tool-args">(.trellis/spec/backend/platform-integration.md)</span>
        </div>

        <div className="td-line td-line-ai td-d17">
          <span className="td-tool-name">● Update</span>
          <span className="td-tool-args">(platform-integration.md)</span>
          <span>: 新增 Gemini CLI 规范</span>
        </div>

        <div className="td-line td-line-user td-d18">
          <span className="td-prompt">❯ </span>
          <span className="td-cmd">/trellis:finish-work</span>
        </div>

        <div className="td-line td-line-ai td-d19">
          <span className="td-tool-name">● Bash</span>
          <span className="td-tool-args">(task.py archive gemini-cli)</span>
        </div>

        <div className="td-line td-line-ai td-d20">
          <span className="td-tool-name">● Bash</span>
          <span className="td-tool-args">(add\_session.py --title "feat: Gemini CLI support" --commit "ec6114a")</span>
        </div>

        <div className="td-line td-line-sub td-d21">
          └ 任务已归档，会话已记录到 <span className="td-link">journal-4.md</span>
        </div>

        <div className="td-line td-line-ai td-d22">
          <span className="td-prompt">❯ </span>

          <span className="td-cursor" />
        </div>
      </div>
    </div>

    <div className="td-timeline">
      <div className="td-timeline-track" />

      <div className="td-timeline-fill" />

      <div className="td-step-dot" title="启动" />

      <div className="td-step-dot" title="描述" />

      <div className="td-step-dot" title="调研" />

      <div className="td-step-dot" title="实现" />

      <div className="td-step-dot" title="检查" />

      <div className="td-step-dot" title="更新规范" />

      <div className="td-step-dot" title="归档" />
    </div>

    <div className="td-descs">
      <div className="td-desc td-desc-0">
        <p className="td-desc-title">会话已加载</p>
        <p className="td-desc-text">AI 自动读取项目上下文: 工作流规则、活跃任务、Git 状态和最近的工作日志。</p>
      </div>

      <div className="td-desc td-desc-1">
        <p className="td-desc-title">自然语言输入</p>
        <p className="td-desc-text">用自然语言描述你想要的功能，Trellis 自动创建结构化的任务和 PRD。</p>
      </div>

      <div className="td-desc td-desc-2">
        <p className="td-desc-title">调研与配置</p>
        <p className="td-desc-text">trellis-research sub-agent 找到相关的规范和代码模式，通过 jsonl 配置上下文文件: hooks 自动注入给 Agent。</p>
      </div>

      <div className="td-desc td-desc-3">
        <p className="td-desc-title">实现</p>
        <p className="td-desc-text">Agent 按照项目规范跨 5 层编写代码。99 次工具调用，337 个测试全部通过。</p>
      </div>

      <div className="td-desc td-desc-4">
        <p className="td-desc-title">质量检查</p>
        <p className="td-desc-text">trellis-check sub-agent 对照代码规范审查每个改动文件，发现问题自动修复。</p>
      </div>

      <div className="td-desc td-desc-5">
        <p className="td-desc-title">更新规范</p>
        <p className="td-desc-text">将本次会话中学到的新模式沉淀到规范库: 让未来的会话更准确。</p>
      </div>

      <div className="td-desc td-desc-6">
        <p className="td-desc-title">会话已归档</p>
        <p className="td-desc-text">5 个原子提交，会话记录到工作日志。分支已准备好等待 Review。</p>
      </div>
    </div>
  </div>
</div>

***

## 刚才发生了什么？

这个演示回放了一次真实的 Trellis 会话: 我们为 Trellis CLI 添加了 **Gemini CLI 平台支持**，涉及类型定义、模板、配置器、CLI 参数、Python 适配器和文档。

### 工作流程

<Steps>
  <Step title="启动会话">
    SessionStart hook 或 extension 加载项目上下文: 工作流规则、活跃任务、Git
    状态和最近的工作日志。AI 立即进入状态。
  </Step>

  <Step title="描述需求">
    用自然语言描述你想要的功能。Trellis 创建一个带结构化 PRD 的跟踪任务。
  </Step>

  <Step title="调研与配置">
    trellis-research sub-agent 读取 36 个文件，找到相关的规范和代码模式。上下文文件配置到 jsonl
    中，Agent 通过 hooks 自动接收正确的规范。
  </Step>

  <Step title="实现">
    trellis-implement sub-agent 跨 5 层编写代码（类型 → 模板 → 配置器 → CLI → Python）。99
    次工具调用，337 个测试一次通过。
  </Step>

  <Step title="质量检查">
    trellis-check sub-agent 对照代码规范审查每个改动文件。发现 1 个缺失的 `EXCLUDE_PATTERNS`
    条目并自动修复。
  </Step>

  <Step title="更新规范">
    `trellis-update-spec` skill 将本次会话中学到的新模式沉淀到规范库: 让未来的会话更准确。
  </Step>

  <Step title="记录与交付">
    `/trellis:finish-work` 将会话归档到工作日志。5 个原子提交已在功能分支上，准备好等待 Review。
  </Step>
</Steps>

### 关键数据

| 指标       | 数值                                            |
| -------- | --------------------------------------------- |
| **总耗时**  | \~20 分钟                                       |
| **工具调用** | 169 次（explore + research + implement + check） |
| **改动文件** | 14 个 TOML 模板 + 5 个源文件                         |
| **测试**   | 337/337 通过                                    |
| **提交**   | 5 个原子提交                                       |
| **人工输入** | 3 条消息（需求描述 + update-spec + finish-work）       |

<Card title="立即体验" icon="rocket" href="/zh/start/install-and-first-task">
  安装 Trellis，打开新的 AI 会话，然后描述你的第一个任务。
</Card>