跳转到主要内容

​
附录 B：命令与 Skill 速查

Trellis 每个平台只原生带有 3 个 slash 命令，其他都是 auto-trigger skill 或 sub-agent。这是有意的设计：命令负责会话边界，其他工作流自己跑。

​
Slash 命令（按平台）

Trellis 每个平台原生带 3 个用户调用的命令（start、finish-work、continue）。调用语法按平台不同：
平台StartFinishContinue交付形式
Claude Code / OpenCode / Cursor / CodeBuddy / Codex / Gemini CLI / Droid/trellis:start/trellis:finish-work/trellis:continueSlash 命令
Kiro@trellis:start@trellis:finish-work@trellis:continueSkill，通过 @ 选择器
Kilo/start.md/finish-work.md/continue.mdWorkflow 文件（.kilocode/workflows/）
Antigravity / Windsurfworkflow 选择器 → start / finish-work / continueWorkflow 文件
GitHub CopilotRun Prompt → trellis-start / trellis-finish-work / trellis-continuePrompt 文件（.github/prompts/）
Qoder（skill 选择器）start / finish-work / continueSkill——Qoder 原生 Custom Commands 留给用户自己用

​
Auto-trigger Skill

由平台根据用户意图自动匹配，不需要显式调用。需要时用各平台的 skill 调用语法手动触发。
Skill触发时机干什么
trellis-brainstorm用户描述功能 / bug / 模糊需求产出 task + prd.md，必要时 spawn research
trellis-before-devtask 进入 in_progress、AI 即将动手改代码读该 package 相关的 spec
trellis-check实现阶段结束diff 审查 + lint / typecheck / test + 自修复循环
trellis-update-spec学到 / 决策 / 踩到值得沉淀的东西在对应 spec 文件添加条目
trellis-break-loop刚修完棘手 bug5 维根因 + 预防机制分析

​
Sub-agent

主会话通过平台的 sub-agent / Task 原语 spawn。
Sub-agent角色约束
trellis-research代码/文档搜索只读
trellis-implement编码不 git commit
trellis-check验证 + 自修复自带重试循环
真 sub-agent：Claude Code、OpenCode、Codex、Droid 可用。其他平台在主会话内联运行。

​
task.py 子命令

子命令用途用法
create创建任务task.py create "title" [--slug name] [-a assignee] [-p priority]
init-context初始化 JSONLtask.py init-context "$DIR" <dev_type> [--platform]
add-context追加上下文条目task.py add-context "$DIR" <target> "<path>" "<reason>"
validate校验 JSONLtask.py validate "$DIR"
list-context查看所有条目task.py list-context "$DIR"
start置为当前任务task.py start "$DIR"
finish清除当前任务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 脚本

# 上下文
./.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