跳转到主要内容

任务是干什么的

任务是带上下文的工作项。每个任务知道:
  • 你要做什么(PRD)
  • 哪些文件相关
  • 在哪个分支工作
  • 当前状态
切换任务时,AI 的上下文也切换。不会搞混你在做哪个功能。

任务结构

任务在 .trellis/tasks/。每个任务是一个目录:
目录名格式:MM-DD-简短描述-负责人

创建任务

用任务脚本:
这会创建任务目录和默认文件。然后编辑 prd.md 写需求。

prd.md

写你要做什么。需求和验收标准要具体。

上下文文件(JSONL)

告诉 agent 该读哪些文件:
不同 agent 可以有不同的上下文文件。按需编辑 implement.jsonlcheck.jsonl 等。

开始做任务

设置当前任务:
Hooks 用这个来注入正确的上下文。现在开 Claude Code 会话时,它知道:
  • 读这个任务的 PRD
  • 加载 JSONL 文件里列的规范
  • 在任务的分支工作

管理任务

列出所有任务:
完成后清除当前任务:
归档已完成的任务:

多个任务

可以同时有多个进行中的任务。但同一时间只有一个是「当前」的。切换:

任务工作流

典型流程:
  1. 创建任务:task.py create
  2. 编辑 prd.md 写需求
  3. 设置上下文文件(JSONL)
  4. 设为当前:task.py start
  5. 在 Claude Code 会话里工作
  6. 归档:task.py archive <id>
任务系统把上下文组织好,让 AI 知道该关注什么。