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

# 附录 B：命令与 Skill 速查

## 附录 B：命令与 Skill 速查

Trellis 只保留很少的会话边界命令，其他都是 auto-trigger skill 或 sub-agent。这是有意的设计：命令负责用户显式边界，其他工作流自己跑。

### Slash 命令（按平台）

常规用户命令是 `finish-work` 和 `continue`。`start` 只在不会自动注入会话上下文的平台上作为用户入口出现。调用语法按平台不同：

| 平台 | Start | Finish | Continue | 交付形式 |
| - | - | - | - | - |
| Claude Code / OpenCode / Gemini CLI / CodeBuddy / Droid | SessionStart hook 自动注入 | `/trellis:finish-work` | `/trellis:continue` | Slash 命令 |
| Cursor / Pi Agent / Qoder | SessionStart hook 或 extension 自动注入 | `/trellis-finish-work` | `/trellis-continue` | 原生命令 / prompt |
| Kiro | `@trellis:start` | `@trellis:finish-work` | `@trellis:continue` | Skill，通过 `@` 选择器 |
| Kilo | `/start.md` | `/finish-work.md` | `/continue.md` | Workflow 文件（`.kilocode/workflows/`） |
| Antigravity / Devin | workflow 选择器 → `start` / `finish-work` / `continue` | | | Workflow 文件 |
| GitHub Copilot | Run Prompt → `trellis-start` / `trellis-finish-work` / `trellis-continue` | | | Prompt 文件（`.github/prompts/`） |
| Codex | 自动读取 `AGENTS.md` prelude；可选 UserPromptSubmit hook | skill / prompt 入口 | skill / prompt 入口 | Skills + hooks |

### Auto-trigger Skill

由平台根据用户意图自动匹配，不需要显式调用。需要时用各平台的 skill 调用语法手动触发。

| Skill | 触发时机 | 干什么 |
| - | - | - |
| `trellis-brainstorm` | 用户描述功能 / bug / 模糊需求 | 产出 task + `prd.md`，必要时 spawn research |
| `trellis-before-dev` | task 进入 in\_progress、AI 即将动手改代码 | 读该 package 相关的 spec |
| `trellis-check` | 实现阶段结束 | diff 审查 + lint / typecheck / test + 自修复循环 |
| `trellis-update-spec` | 学到 / 决策 / 踩到值得沉淀的东西 | 在对应 spec 文件添加条目 |
| `trellis-break-loop` | 刚修完棘手 bug | 5 维根因 + 预防机制分析 |

### Sub-agent

主会话通过平台的 sub-agent / Task 原语 spawn。

| Sub-agent | 角色 | 约束 |
| - | - | - |
| `trellis-research` | 代码/文档搜索 | 只读 |
| `trellis-implement` | 编码 | 不 `git commit` |
| `trellis-check` | 验证 + 自修复 | 自带重试循环 |

真 sub-agent：Claude Code、Cursor、OpenCode、Codex、Kiro、Gemini CLI、Qoder、CodeBuddy、Copilot、Droid、Pi Agent 可用。Kilo、Antigravity、Devin 在主会话内联运行同样流程。Claude Code、Cursor、OpenCode、CodeBuddy、Droid、Pi Agent 走 hook/extension 注入上下文；其他 sub-agent 平台走 pull-based prelude。

### 全局 CLI 命令

| 命令 | 用途 | 用法 |
| - | - | - |
| `trellis upgrade` | 升级全局安装的 Trellis CLI package | `trellis upgrade [--tag <tag>]` |
| `trellis update` | 把当前项目的 Trellis 文件同步到此 CLI | `trellis update [--dry-run] [--migrate] [...]` |

### `task.py` 子命令

| 子命令 | 用途 | 用法 |
| - | - | - |
| `create` | 创建任务（检测到 sub-agent 平台时 seed `implement.jsonl` / `check.jsonl`） | `task.py create "title" [--slug name] [-a assignee] [-p priority]` |
| `add-context` | 追加上下文条目（create 之后填 jsonl 的主要入口） | `task.py add-context "$DIR" <target> "<path>" "<reason>"` |
| `validate` | 校验 JSONL | `task.py validate "$DIR"` |
| `list-context` | 查看所有条目 | `task.py list-context "$DIR"` |
| `start` | 置为当前 AI 会话/窗口的任务 | `task.py start "$DIR"` |
| `finish` | 清除当前 AI 会话/窗口的任务 | `task.py finish` |
| `set-branch` | 设置分支名 | `task.py set-branch "$DIR" "feature/xxx"` |
| `set-base-branch` | 设置 PR 目标分支 | `task.py set-base-branch "$DIR" "main"` |
| `set-scope` | 设置范围 | `task.py set-scope "$DIR" "auth"` |
| `add-subtask` | 链接子任务到父任务 | `task.py add-subtask <父任务目录> <子任务目录>` |
| `remove-subtask` | 解除子任务关联 | `task.py remove-subtask <父任务目录> <子任务目录>` |
| `archive` | 归档任务 | `task.py archive <name>` |
| `list` | 列出活跃任务 | `task.py list [--mine] [--status <s>]` |
| `list-archive` | 列出归档任务 | `task.py list-archive [YYYY-MM]` |

### Python 脚本

```bash theme={null}
# 上下文
./.trellis/scripts/get_context.py                 # 完整上下文
./.trellis/scripts/get_context.py --json          # JSON
./.trellis/scripts/get_context.py --mode packages # 按 package 的 spec 层（monorepo）
./.trellis/scripts/get_context.py --mode record   # 给 /trellis:finish-work 用

# 会话
./.trellis/scripts/add_session.py --title "..." --commit "..." --summary "..."

# Spec bootstrap（首次）
./.trellis/scripts/create_bootstrap.py
```

***


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.