从生成的脚手架开始
创建一个本地 workflow:.trellis/workflows/review-first.md。与空白文件相比,从 native 开始更安全,
因为所有 parser 依赖的结构都已经存在。
创建后,命令会依次询问是否把它设为项目默认值和个人默认值。只想生成文件时使用
--skip-defaults。
这个命令不会替换或删除
.trellis/workflow.md。该文件始终是零配置的全局 回退。理解文件布局
- 当前任务:
task.json的workflow - 当前开发者:
.developer的workflow= - 项目:
config.yaml的default_workflow - 全局回退:
.trellis/workflow.md
保留运行时契约
生成的脚手架是最完整的参考。你可以把 workflow 改得更短,但要保留下面这些 结构:
标准 workflow-state id 包括
no_task、planning、planning-inline、
in_progress、in_progress-inline 和 completed。自定义 id 可以使用字母、
数字、下划线和短横线,但只有某个任务生命周期路径把同样的值写入
task.json.status 后,它才会实际生效。
按平台路由指引
平台 block 是可选的。当同一个 step 在不同 harness 中需要不同操作时使用:理解 hook 的读取边界
Hook 由trellis init 和 trellis update 安装。不要在 workflow 文件里声明
hook 事件名或脚本命令。
Sub-agent hook 是另一条独立通道。它依次注入
implement.jsonl 或
check.jsonl,然后注入 prd.md、存在时的 design.md 和存在时的
implement.md,不会解析 workflow Markdown。选中的 workflow 决定父会话何时、
如何派发;sub-agent hook 提供具体任务材料。
修改后验证
运行真实的 phase parser:python,其他平台使用 python3。
trellis workflow --save 会在 marketplace 模板缺少标准 phase、step 或
workflow-state marker 时发出警告。警告不会阻止保存,因此上面的 parser 命令仍然
是自定义内容的最终检查。
安全修改范围
你可以自由修改正文、增加 phase、修改路由指引以及增加自定义 status。除非同时 更新所有运行时消费方,否则不要改变 parser 语法。 Workflow-state 文本会在下一轮用户消息生效;SessionStart 概览会在新会话生效; step 内容会在下一次get_context.py --mode phase 查询时生效。