使用指南
任务与看板
任务显示在项目页面的 任务 标签页中,以看板形式呈现。Claude 通过 API 领取的是同一批任务——看板和 Claude 使用同一个列表。
列与状态
每个任务处于六种状态之一。看板上的列不是独立字段,而是由状态推导而来:
| 状态 | API 中的值 | 看板上的列 |
|---|---|---|
| 搁置 | hold | 待办 |
| 未开始 | todo | 待办 |
| 进行中 | in_progress | 进行中 |
| 待答复 | question | 进行中 |
| 待审核 | review | 审核 |
| 已完成 | done | 已完成 |
“搁置”和“未开始”都在待办列中,但含义不同:搁置的任务在等待某个条件(字段“等待”),Claude 不会领取;未开始的任务则会被领取。“待答复”只能由 Claude 设置,不能手动选择。
通过拖放可将卡片移到另一列,状态随之改变。
负责人与领域
每个任务都有负责人:所有者、员工、Claude 或 外部。卡片上的“移交给 Claude”会将任务转交给 Claude。领域(前端、后端、设计、基础设施、支持)以标签形式显示在卡片上。看板上方的筛选栏可按负责人、状态和领域筛选;“重置筛选 ×”清除所有筛选。
创建任务
“+ 新建” › 任务(快捷键 a)或直接在看板上创建:标题(至少三个字符)、Markdown 格式的 描述 以及 图片。默认状态为“未开始”;如选择“搁置”,请在 等待 中填写条件。通过 API 创建的任务需要至少 25 个字符的有意义标题;VentionDesk 会将非常相似的未完成任务识别为重复。
详情视图
点击卡片会打开“任务 #N”,显示状态、领域、负责人、到期、预估、标题、描述和图片、所有反馈的历史记录,以及(如有)“打开 pull request”。附件为图片(PNG、JPEG、WebP)。“删除任务”会再次确认。
Claude 的反馈
Claude 用六种反馈之一报告任务的进展。每条反馈都会出现在任务的历史记录中,其中一些会改变状态:
| 反馈 | 显示为 | 效果 |
|---|---|---|
arbeitet | 仍在处理 | 进度更新。任务保持“进行中”。 |
kontrolle | 需要审核 | 已实现并交付。状态为“待审核”(审核列);需要证据。 |
frage | 待您答复 | 提问。状态为“待答复”;在有人回答之前,任务不会再被领取。 |
master | 需所有者处理 | 交给所有者,不改变状态——例如 Claude 无权执行的步骤。 |
blockiert | 受阻 | 无法继续。任务保持“进行中”,由人来处理。 |
erledigt | 已完成 | 完成。状态为“已完成”;需要证据。 |
“需要审核”和“已完成”需要提供 证据——例如提交记录或测量结果。没有证据的“已完成”不是完成,而只是一种说法。
批准或驳回
对于“待答复”“需要审核”“需所有者处理”和“受阻”,可在详情视图中以 批准 或 驳回 作答。按钮名称因情形而异:
| 情形 | 批准 | 驳回 |
|---|---|---|
| Claude 提问 | “批准——就这样做” | “驳回” |
| Claude 请求审核 | “批准——完成” | “驳回——返工” |
| Claude 转交给您 | “完成——交回 Claude” | “驳回” |
| Claude 无法继续 | “已解决——交回 Claude” | “驳回” |
审核中的批准会将任务设为“已完成”,审核中的驳回会将任务退回 Claude 并设为“未开始”;其他任何答复都会将任务以“进行中”交回 Claude。驳回必须附带评论,批准则不需要。图片可直接附在答复中。
Claude 如何领取任务并反馈,请参阅 Claude 与 MCP。