secondbrain-task

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Create Task

创建任务

Create tracked tasks with priority, due dates, and status workflow.

创建带有优先级、截止日期和状态流转的可跟踪任务。

Prerequisites

前提条件

Verify Tasks entity is enabled:

Check for
```
.claude/data/tasks/records.yaml
```
If not found, suggest enabling tasks via
```
secondbrain-init
```
or
```
secondbrain-entity
```

确认Tasks实体已启用：

检查是否存在
```
.claude/data/tasks/records.yaml
```
若未找到，建议通过
```
secondbrain-init
```
或
```
secondbrain-entity
```
启用任务功能

Workflow

工作流

Step 1: Gather Information

步骤1：收集信息

Collect from user or conversation context:

Title — Brief task description
Description (optional) — Detailed description
Priority — low, medium, high, critical
Due Date (optional) — Target completion date
Assignee (optional) — Person responsible

从用户或对话上下文收集以下信息：

标题 — 任务简要描述
描述（可选）— 详细说明
优先级 — low、medium、high、critical
截止日期（可选）— 目标完成日期
负责人（可选）— 任务责任人

Step 2: Generate Task Number

步骤2：生成任务编号

Sequential ID format:

TASK-XXXX

(zero-padded)

Load
```
.claude/data/tasks/records.yaml
```
Get
```
last_number
```
, increment by 1
Format as
```
TASK-0042
```

序列ID格式：

TASK-XXXX

（补零填充）

加载
```
.claude/data/tasks/records.yaml
```
获取
```
last_number
```
，加1递增
格式化为
```
TASK-0042
```

Step 3: Create Task Record

步骤3：创建任务记录

Add to

.claude/data/tasks/records.yaml

yaml

- number: 42
  title: "Implement user authentication"
  description: "Add OAuth2 login flow"
  status: todo
  priority: high
  created: 2026-01-15
  due_date: 2026-01-31
  assignee: sergey
  tags: [auth, security]

Update

last_number: 42

添加至

.claude/data/tasks/records.yaml

：

yaml

- number: 42
  title: "Implement user authentication"
  description: "Add OAuth2 login flow"
  status: todo
  priority: high
  created: 2026-01-15
  due_date: 2026-01-31
  assignee: sergey
  tags: [auth, security]

更新

last_number: 42

Step 4: Create Task Document (Optional)

步骤4：创建任务文档（可选）

For complex tasks, create a document:

Filename:

docs/tasks/TASK-0042-implement-authentication.md

markdown

---
id: TASK-0042
title: Implement user authentication
status: todo
priority: high
created: 2026-01-15
due_date: 2026-01-31
assignee: sergey
tags: [auth, security]
---

对于复杂任务，创建文档：

文件名：

docs/tasks/TASK-0042-implement-authentication.md

markdown

---
id: TASK-0042
title: Implement user authentication
status: todo
priority: high
created: 2026-01-15
due_date: 2026-01-31
assignee: sergey
tags: [auth, security]
---

TASK-0042: Implement user authentication

Description

Add OAuth2 login flow for the application.

Acceptance Criteria

Notes

Implementation notes here...

undefined

Implementation notes here...

undefined

Step 5: Sidebar Note

步骤5：侧边栏说明

DO NOT manually add tasks to VitePress sidebar.

Tasks are automatically listed via the

EntityTable

component on

docs/tasks/index.md

, which reads from

.claude/data/tasks/records.yaml

. No sidebar modification needed.

请勿手动将任务添加至VitePress侧边栏。

任务会通过

docs/tasks/index.md

上的

EntityTable

组件自动列出，该组件读取

.claude/data/tasks/records.yaml

中的数据，无需修改侧边栏。

Step 6: Confirm Creation

步骤6：确认创建

undefined

undefined

Task Created

任务已创建

ID: TASK-0042 Title: Implement user authentication Priority: high Due: 2026-01-31 Status: todo

ID： TASK-0042 标题： Implement user authentication 优先级： high 截止日期： 2026-01-31 状态： todo

Next Steps

后续步骤

Update status as work progresses
Add notes to the task document
Mark complete when done

undefined

随着工作推进更新状态
向任务文档添加备注
完成后标记为已完成

undefined

Status Workflow

状态流转

todo → in_progress → done
            ↓
         blocked → in_progress
            ↓
        canceled

Status	Description
todo	Not started
in_progress	Work in progress
blocked	Waiting on dependency
done	Completed
canceled	Won't be done

todo → in_progress → done
            ↓
         blocked → in_progress
            ↓
        canceled

状态	描述
todo	未开始
in_progress	进行中
blocked	等待依赖项
done	已完成
canceled	不会执行

Priority Levels

优先级级别

Priority	Use When
critical	Urgent, blocks other work
high	Important, should be done soon
medium	Normal priority
low	Nice to have, no rush

优先级	使用场景
critical	紧急，阻碍其他工作
high	重要，应尽快完成
medium	常规优先级
low	锦上添花，无需着急

Additional Resources

额外资源

references/task-workflows.md
— Detailed task lifecycle, priority guidelines, and workflow patterns

references/task-workflows.md
— 详细的任务生命周期、优先级指南和工作流模式

Tips

提示

Keep titles actionable — Start with a verb (Implement, Fix, Add)
Set realistic due dates — Better to underpromise
Update status promptly — Keeps the backlog accurate
Use tags — Helps filter and group related tasks
Add acceptance criteria — Makes "done" unambiguous

标题要具可操作性 — 以动词开头（如Implement、Fix、Add）
设置实际的截止日期 — 宁肯少承诺多交付
及时更新状态 — 保持待办列表准确
使用标签 — 有助于筛选和分组相关任务
添加验收标准 — 明确“完成”的定义