SuperAPI AI 工具集

secondbrain-task

办公与效率

查看项目

更新于 10-16 02:43

技能介绍

用途

secondbrain-task 是一个用于在“第二大脑”知识库中创建与跟踪任务的技能。当用户表达“创建任务”“添加待办”“跟踪行动项”“创建工单”“新任务”“提醒我”“需要做”等意图时触发。

主要能力

  • 创建带优先级、截止日期和状态工作流的可跟踪任务。
  • 任务字段包括:标题、描述(可选)、优先级、截止日期(可选)、负责人(可选)。
  • 优先级分为 low、medium、high、critical 四级。
  • 状态工作流:todo → in_progress → done;blocked 可返回 in_progress;也可进入 canceled。
  • 自动生成顺序任务编号,格式为 TASK-XXXX(补零),例如 TASK-0042。
  • 可为复杂任务可选创建 Markdown 任务文档,包含元数据、描述、验收标准与备注。

前置条件

需确认 Tasks 实体已启用:检查是否存在 .claude/data/tasks/meta.yaml(分片模式)或 .claude/data/tasks/records.yaml(旧版)。若未找到,建议通过 secondbrain-init 或 secondbrain-entity 启用任务功能。

使用方式

  1. 收集信息:从用户或对话上下文中获取标题、描述、优先级、截止日期、负责人。
  2. 生成任务编号:读取 .claude/data/tasks/meta.yaml 中的 last_number,加 1 后格式化为 TASK-0042 形式。
  3. 创建任务记录:将记录写入当前月份分片文件 .claude/data/tasks/YYYY-MM.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]

同时更新 meta.yaml 中的 last_number 为 42,并确保当前月份在分片列表中。

  1. 创建任务文档(可选):针对复杂任务,创建 docs/tasks/TASK-0042-implement-authentication.md,包含前置元数据(id、title、status、priority、created、due_date、assignee、tags)以及描述、验收标准、备注等正文。

  2. 侧边栏说明:不要手动将任务添加到 VitePress 侧边栏。任务由 docs/tasks/index.md 中的 EntityTable 组件自动从 .claude/data/tasks/ 分片文件读取并列出,无需修改侧边栏。

  3. 确认创建:向用户反馈任务 ID、标题、优先级、截止日期和状态,并提示后续可更新状态、添加备注、标记完成。

适用场景

  • 在第二大脑知识库中管理个人或团队待办事项。
  • 跟踪带有负责人和截止日期的行动项或工单。
  • 为复杂任务建立结构化文档与验收标准。

限制

  • 使用前必须启用 Tasks 实体,否则无法创建任务。
  • 不得将任务手动加入 VitePress 左侧导航,任务列表由 EntityTable 组件自动读取分片文件生成。
  • 任务编号依赖 meta.yaml 中的 last_number 进行顺序递增。
  • 具体收费、价格、平台支持范围等信息暂未提供。

资源与建议

  • 参考 references/task-workflows.md,了解详细任务生命周期、优先级指南和工作流模式。
  • 标题保持可执行,以动词开头(Implement、Fix、Add)。
  • 设置现实的截止日期。
  • 及时更新状态以保持待办列表准确。
  • 使用标签帮助筛选和分组相关任务。
  • 添加验收标准,使“完成”定义明确。