Skip to content
Skills Library
Personal productivity · Tool integration

dida-task

/dida-task

滴答清单(Dida365)任务管理工具。通过官方 OpenAPI + 私有 API,让 agent 能读取(任务、清单、已完成任务、番茄/专注统计)和写入(创建、更新、完成、删除任务和清单)滴答清单的数据。当用户提到"滴答"、"dida"、"清单"、"todo"、"任务"、"提醒"、"番茄钟"、"专注"且明显是要操作清单 App 时使用。不支持 TickTick 国际版,只支持国内 dida365。

Repository
keji-skills ↗
Licence
MIT
Last repository change
19.07.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
9
Scripts
3
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 19.07.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What to check before installing
  • 3 scripts in this package. Review them before installing, as Claude may execute them.

Scripts: scripts/dida.py, scripts/lib.py, scripts/oauth.py

What it does and when to use it

滴答清单(Dida365)任务管理工具。通过官方 OpenAPI + 私有 API,让 agent 能读取(任务、清单、已完成任务、番茄/专注统计)和写入(创建、更新、完成、删除任务和清单)滴答清单的数据。当用户提到"滴答"、"dida"、"清单"、"todo"、"任务"、"提醒"、"番茄钟"、"专注"且明显是要操作清单 App 时使用。不支持 TickTick 国际版,只支持国内 dida365。

Triggers from the description

didatodo番茄钟
Original author description

滴答清单(Dida365)任务管理工具。通过官方 OpenAPI + 私有 API,让 agent 能读取(任务、清单、已完成任务、番茄/专注统计)和写入(创建、更新、完成、删除任务和清单)滴答清单的数据。当用户提到"滴答"、"dida"、"清单"、"todo"、"任务"、"提醒"、"番茄钟"、"专注"且明显是要操作清单 App 时使用。不支持 TickTick 国际版,只支持国内 dida365。

How it works

  1. 何时使用
  2. 首次使用
  3. 能力速查
  4. Agent 使用准则
  5. 详细文档
  6. 重要声明
Original SKILL.md headings · 117 lines, 482 words
SKILL.md preview
---
name: dida-task
description: 滴答清单(Dida365)任务管理工具。通过官方 OpenAPI + 私有 API,让 agent 能读取(任务、清单、已完成任务、番茄/专注统计)和写入(创建、更新、完成、删除任务和清单)滴答清单的数据。当用户提到"滴答"、"dida"、"清单"、"todo"、"任务"、"提醒"、"番茄钟"、"专注"且明显是要操作清单 App 时使用。不支持 TickTick 国际版,只支持国内 dida365。
---

# Dida-Task:滴答清单 Agent 工具

让 agent 完全打通滴答清单(Dida365):读、写、统计一应俱全。

## 何时使用

**触发场景:**
- 用户要写任务到滴答:"加个任务"、"提醒我..."、"加到 dida / 滴答"
- 用户要读滴答数据:"今天完成了哪些任务"、"我有哪些清单"、"专注了多久"
- 用户要统计/复盘:"这周完成了什么"、"花了几个番茄在 X 上"

**不要触发:**
- 用户的"任务"明显指当前对话工作项,不是 App 里的任务
- 用户在专门的 GTD 笔记系统里操作(除非明确说"同步到滴答")

## 首次使用

凭证未配置时,先引导用户走 setup:

```bash
python3 scripts/dida.py setup
```

详细引导见 [setup.md](setup.md)。

## 能力速查

所有命令统一入口:`python3 scripts/dida.py <子命令>`

### 读

| 命令 | 作用 |
|---|---|
| `read list-projects` | 列所有清单 |
| `read list-columns <project>` | 列 kanban 清单的分组(columns) |
| `read list-tasks <project>` | 列某清单下未完成任务 |
| `read get-task <task-id>` | 拿单个任务详情 |
| `read search <关键词>` | 全量任务模糊搜索(按标题/内容) |
| `read today` | **跨清单**:今日到期的未完成任务,按清单分组 |
| `read upcoming [--days N]` | **跨清单**:未来 N 天(默认 7)到期 |
| `read by-tag <tag> [--prefix]` | 按标签筛选;`--prefix` 含子标签(如 `12wy` 匹配 `12wy/a`) |
| `read list-tags` | 列出账号所有标签(含父子关系、颜色) |
| `read completed-today` | 今天已完成任务 |
| `read completed-range <from> <to>` | 按日期范围拉已完成任务 |

### 番茄/专注

| 命令 | 作用 |
|---|---|
| `pomo today` | 今天专注总时长 + 段数 |
| `pomo by-task <task-id-或关键词>` | 某任务花了几个番茄 / 多少分钟 |
| `pomo stats <from> <to>` | 按日期范围的专注统计(heatmap + 项目分布) |

### 写

| 命令 | 作用 |
|---|---|
| `write create-task --title <标题> [选项]` | 创建任务 |
| `write update-task <task-id> [选项]` | 更新任务 |
| `write complete-task <task-id>` | 标记完成 |
| `write delete-task <task-id>` | 删除任务(默认 dry-run) |
| `write add-subtask <task-id> --title <标题>` | 给任务追加一个子任务(checklist 项) |
| `write complete-subtask <task-id> <子任务-id-或关键词>` | 标记某子任务完成 |
| `write create-project --name <名字> [选项]` | 创建清单 |
| `write update-project <project-id> [选项]` | 更新清单 |
| `write delete-project <project-id>` | 删除清单(默认 dry-run) |

**`create-task` / `update-task` 选项:**

| 参数 | 说明 |
|---|---|
| `--content <文本>` | 备注内容 |
| `--project <id\|名字>` | create-task:目标清单(默认收件箱);update-task:**移动到该清单** |
| `--priority {0,1,3,5}` | 0 无 / 1 低 / 3 中 / 5 高 |
| `--due <YYYY-MM-DD[THH:MM]>` | 截止时间 |
| `--all-day` | 全天任务(忽略时分) |
| `--repeat "RRULE:..."` | 重复规则,如 `RRULE:FREQ=WEEKLY;BYDAY=MO` |
| `--column <id\|名字>` | kanban 分组(需配合 `--project`) |
| `--tags "a,b,c"` | 标签数组,逗号分隔 |
| `--items "step1\|step2\|step3"` | 子任务(仅 create-task;竖线分隔,自动设 `kind=CHECKLIST`) |

### 元

| 命令 | 作用 |
|---|---|
| `setup` | 首次配置(OAuth + cookie) |
| `refresh-token` | OAuth token 过期时重走授权 |
| `refresh-cookie` | Cookie 失效时引导更新 |
| `health` | 检查 token / cookie 状态 |

所有命令支持 `--json` 输出结构化数据,方便 agent 解析。

## Agent 使用准则

1. **写操作默认确认**:`delete-task` / `delete-project` 默认 dry-run,加 `--confirm` 才真删
2. **批量写入要分步**:一次创建多个任务时,先列计划→等用户确认→再调 API
3. **批量必须限速**:官方 API 限流 **100 req/min per token**(滚动 60s 窗口,超限返回 HTTP 500 `exceed_query_limit`,**不是 429**)。批量写入每条 sleep 1s,超过 50 条每 20 条歇 30s。注意 `update-task`/`delete-task`/`complete-task` 内部会调 `_find_project_id_of_task`,最坏遍历所有清单(N+1 次调用),是隐藏的限流杀手 —— 大批量操作前先 `read list-projects` 拿到 project id 直接传,能少一半请求
4. **凭证失败要给指引**:API 401/500 access_forbidden 时,**不要重试**,告诉用户跑哪个 refresh 命令
5. **限流触发等满 60 秒**:触发 `exceed_query_limit` 后等满 60s,不是 30s(滚动窗口)
6. **输出尊重用户语境**:用户问中文就用中文回,时间用北京时间

## 详细文档

- [setup.md](setup.md) — 首次配置完整流程(如何申请 client_id、拿 cookie)
- [api-reference.md](api-reference.md) — 官方 + 私有 API 端点速查
- [examples/usage.md](examples/usage.md) — 常见用法示例

## 重要声明

**已完成任务读取、番茄统计走的是滴答的私有 API**(非官方公开),用 cookie 鉴权:
- 优点:功能完整(官方 OpenAPI 没有这些能力)
- 风险:滴答随时可能改、cookie 会过期(几周到几个月)
- 失败时 skill 会给出明确的 refresh 指引,不会卡死

所有**写操作**(建任务/改任务/删任务)走官方 OpenAPI,稳定可靠。
Files in this package (9)
  • README.md 8 KB
  • SKILL.md 6 KB
  • api-reference.md 7 KB
  • credentials.example.json 1 KB
  • setup.md 3 KB
  • examples/usage.md 2 KB
  • scripts/dida.py 30 KB
  • scripts/lib.py 5 KB
  • scripts/oauth.py 3 KB

Versions

The database has no other skills named dida-task.

Database snapshot: 13.11.2026 · package version 1aec0879b55b (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 95dida-cli
    Use DidaCLI to operate Dida365/TickTick from agents. Trigger whenever the user asks to read, create, update, complete, delete, move, organize, or audit Dida365 tasks, projects, folders, tags, completed history, trash, or kanban columns. Prefer this skill over browser automation…
  • 100dida-cli
    Use DidaCLI to operate Dida365/TickTick from agents. Trigger whenever the user asks to read, create, update, complete, delete, move, organize, or audit Dida365 tasks, projects, folders, tags, completed history, trash, or kanban columns. Prefer this skill over browser automation…
  • 100article2ticktick
    将技术周报中的文章整理为滴答清单(TickTick)待办事项,同时支持单篇文章直接添加。当用户提供周报 markdown 文档、要求将周报文章添加到滴答清单,或提及"技术周报"、"文章汇总"、"添加到滴答"等关键词时,使用此技能;当用户分享单篇文章链接并希望添加到滴答清单时,同样使用此技能。
  • 100task-and-schedule-manager
    统一任务与日程管理入口。当用户说"提醒我"、"待办"、"创建任务"时,先判断谁干活,再路由到对应机制: ① 自己的活 → 滴答清单(dida-task,DIDA_ENABLED=true 时优先); ② 别人的活 → 飞书任务(lark-task); ③ Agent 的活 → schedule_create(定时任务); ④ 多阶段周期 → 时间线引擎(timelines.yaml)。 本技能同时承载定时任务管理和时间线引擎两大核心能力。
  • 100feishu-task
    Feishu task management operations. Activate when user mentions tasks, todos, task lists.
  • 100tasks
    Work with markdown-based task lists in .llm/todo.md files. Use when managing tasks, working with todo lists, extracting incomplete tasks, marking tasks complete, or implementing tasks from a task list.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.