tasks

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Tasks Skill

Track complex, multi-step tasks globally. Unlike todos (per-thread), tasks are shared across ALL threads and persist across restarts.

全局追踪复杂多步骤任务。与待办事项（线程专属）不同，任务可在所有线程间共享，且重启后仍会保留。

When to Use

使用场景

Starting a complex task with 3+ steps
User asks you to do something that will take multiple turns
You need to track progress on ongoing work
You want to remember what you were doing after a restart

启动包含3个及以上步骤的复杂任务时
用户要求你执行需要多轮交互才能完成的操作时
需要追踪正在进行的工作进度时
希望重启后仍能记住之前的工作内容时

Commands

命令

List active tasks

列出活跃任务

bash

alma tasks list          # active tasks (default)
alma tasks list all      # all tasks
alma tasks list done     # completed tasks

bash

alma tasks list          # 活跃任务（默认）
alma tasks list all      # 所有任务
alma tasks list done     # 已完成任务

Create a task

创建任务

bash

alma tasks add "Build People settings page"

bash

alma tasks add "Build People settings page"

Update a task (set steps, progress, status)

更新任务（设置步骤、进度、状态）

bash

undefined

bash

undefined

Set steps for a task

为任务设置步骤

alma tasks update <id> --steps "Design API,Build backend,Build frontend,Test,Deploy"

Mark progress (0-indexed step number)

标记进度（步骤编号从0开始）

alma tasks update <id> --step 2 --status in_progress

Link to current thread

关联至当前线程

alma tasks update <id> --thread <threadId>

Change title

修改标题

alma tasks update <id> --title "New title"

undefined

alma tasks update <id> --title "New title"

undefined

Mark done

标记为完成

bash

alma tasks done <id>

bash

alma tasks done <id>

Show details

查看详情

bash

alma tasks show <id>

bash

alma tasks show <id>

Delete

删除任务

bash

alma tasks delete <id>

bash

alma tasks delete <id>

Status Values

状态值

```
pending
```
— Created but not started
```
in_progress
```
— Currently being worked on
```
done
```
— Completed
```
blocked
```
— Waiting on something

```
pending
```
— 已创建但未开始
```
in_progress
```
— 正在进行中
```
done
```
— 已完成
```
blocked
```
— 等待中

Workflow Example

工作流示例

bash

undefined

bash

undefined

1. Create task when starting complex work

1. 启动复杂工作时创建任务

alma tasks add "Add Discord chat logging"

2. Define steps

2. 定义步骤

alma tasks update t1abc --steps "Add log method to bridge,Log user messages,Log bot replies,Test,Release"

3. Start working

3. 开始工作

alma tasks update t1abc --status in_progress --step 0

4. Progress through steps

4. 逐步推进进度

alma tasks update t1abc --step 1 alma tasks update t1abc --step 2

5. Complete

5. 完成任务

alma tasks done t1abc

undefined

alma tasks done t1abc

undefined

Rules

规则

ALWAYS create a task when starting multi-step work (3+ steps)
Update progress as you complete each step
Mark done immediately when finished — don't leave stale tasks
Keep task titles concise but descriptive
Steps should be actionable and specific
Clean up completed tasks periodically (or let them stay for history)

启动多步骤工作（3个及以上步骤）时务必创建任务
完成每个步骤后更新进度
完成后立即标记为已完成 — 不要留下无效任务
任务标题应简洁且具有描述性
步骤需可执行且具体
定期清理已完成任务（或保留作为历史记录）

Storage

存储

Tasks are stored at

~/.config/alma/tasks.json

and injected into your context automatically. You can always see your active tasks.

任务存储在

~/.config/alma/tasks.json

中，并会自动注入到上下文环境中。你可以随时查看活跃任务。