lovekeji-ai/keji-skills/dida-task

Dida-Task：滴答清单 Agent 工具

让 agent 完全打通滴答清单（Dida365）：读、写、统计一应俱全。

何时使用

触发场景：

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

不要触发：

• 用户的"任务"明显指当前对话工作项，不是 App 里的任务
• 用户在专门的 GTD 笔记系统里操作（除非明确说"同步到滴答"）

首次使用

凭证未配置时，先引导用户走 setup：

python3 scripts/dida.py setup

详细引导见 setup.md。

能力速查

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

读

番茄/专注

写

`create-task` / `update-task` 选项：

元

所有命令支持 --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 — 首次配置完整流程（如何申请 client_id、拿 cookie）
• api-reference.md — 官方 + 私有 API 端点速查
• examples/usage.md — 常见用法示例

重要声明

已完成任务读取、番茄统计走的是滴答的私有 API（非官方公开），用 cookie 鉴权：

• 优点：功能完整（官方 OpenAPI 没有这些能力）
• 风险：滴答随时可能改、cookie 会过期（几周到几个月）
• 失败时 skill 会给出明确的 refresh 指引，不会卡死

所有写操作（建任务/改任务/删任务）走官方 OpenAPI，稳定可靠。