todo

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Todo Skill

Manage tasks using a Markdown file at

.alma/todos-<THREAD_ID>.md

in the current workspace directory. Use the thread ID from the system prompt to create the filename (e.g.,

.alma/todos-abc123.md

). This prevents conflicts when multiple threads share the same workspace.

使用当前工作区目录下的

.alma/todos-<THREAD_ID>.md

Markdown文件管理任务。使用系统提示中的线程ID创建文件名（例如：

.alma/todos-abc123.md

）。这样可以避免多个线程共享同一工作区时产生冲突。

File Format

文件格式

markdown

undefined

markdown

undefined

Todos

Fix authentication bug
~~Add unit tests~~ (in progress)
Update documentation
Write changelog

undefined

Fix authentication bug
~~Add unit tests~~ (in progress)
Update documentation
Write changelog

undefined

Status markers

状态标记

```
- [ ]
```
— pending
```
- [ ] ~Task name~ *(in progress)*
```
— currently working on
```
- [x]
```
— completed

```
- [ ]
```
— 待处理
```
- [ ] ~任务名称~ *(in progress)*
```
— 进行中
```
- [x]
```
— 已完成

How to Use

使用方法

Read the file to see current tasks:
```
Read .alma/todos.md
```
Write the file to update tasks:
```
Write .alma/todos.md
```
Create the
```
.alma/
```
directory if it doesn't exist

读取文件查看当前任务：
```
Read .alma/todos.md
```
写入文件更新任务：
```
Write .alma/todos.md
```
如果
```
.alma/
```
目录不存在则创建它

Rules

规则

Only ONE task should be in progress at a time
Mark tasks
```
[x]
```
IMMEDIATELY after finishing — don't batch
Keep the full list when updating (this is a replace, not append)
Add new tasks at the bottom

同一时间只能有一个任务处于in progress（进行中）状态
完成任务后立即标记为
```
[x]
```
——不要批量处理
更新时保留完整任务列表（这是替换操作，而非追加）
新任务添加到列表底部

When to Use

适用场景

Complex multi-step tasks (3+ steps)
User provides multiple related tasks
User explicitly asks for a task list
Non-trivial work requiring progress tracking

复杂多步骤任务（3步及以上）
用户提供多个相关任务
用户明确要求创建任务列表
需要跟踪进度的重要工作

When NOT to Use

不适用场景

Single, simple tasks
Quick conversational responses
Tasks completable in <3 steps

单一、简单的任务
快速对话式回复
可在3步内完成的任务

Example Session

示例会话

First, create the file:

Write .alma/todos.md

首先，创建文件：

Write .alma/todos.md

Todos

~~Refactor database layer~~ (in progress)
Add migration support
Update API endpoints
Write tests


After completing first task:

Write .alma/todos.md

~~Refactor database layer~~ (in progress)
Add migration support
Update API endpoints
Write tests


完成第一个任务后：

Write .alma/todos.md

Todos

Refactor database layer
~~Add migration support~~ (in progress)
Update API endpoints
Write tests

undefined

Refactor database layer
~~Add migration support~~ (in progress)
Update API endpoints
Write tests

undefined