---
name: ticktick-cli
description: 使用 Python CLI 与 Dida365 Open API 交互以管理滴答清单任务/项目，适用于需要通过脚本或命令行调用滴答清单接口的场景（如项目/任务的查询、创建、更新、完成、删除）。
---

说明：以下调用方式均以当前 `SKILL.md` 文件所在文件夹为 workdir。

1) 常用子命令（覆盖日常场景）
- `project`
  - `list`
  - `get --project-id`
  - `data --project-id`
  - `create --name [--color --sort-order --view-mode --kind]`
  - `update --project-id [--name --color --sort-order --view-mode --kind]`
  - `delete --project-id`（危险，删除前需谨慎确认）
- `task`
  - `get --project-id --task-id`
  - `create --project-id --title [--content --desc --all-day --start-date --due-date --time-zone --reminder --repeat --priority --sort-order --item]`
  - `update --task-id --project-id [--title --content --desc --all-day --start-date --due-date --time-zone --reminder --repeat --priority --sort-order --item]`
  - `complete --project-id --task-id`
  - `delete --project-id --task-id`（危险，删除前需谨慎确认）

2) 输出格式
- 所有调用统一在脚本后、子命令前加 `--json`（示例：`./scripts/ticktick_cli.py --json task get --project-id ...`）

3) 冷门参数/字段怎么查
- 运行 `./scripts/ticktick_cli.py <command> --help` 查看该命令的参数
- 查看 `references/dida365-openapi.md` 了解完整参数、字段与响应结构

## Dida365 概念模型

- Project：项目，任务的容器，支持不同视图模式（list/kanban/timeline）。
  - 常用字段：
    - `name`（名称）
    - `color`（颜色）
    - `viewMode`（视图模式）
    - `kind`（类型）
    - `groupId`（分组）
    - `closed`（是否关闭）
    - `permission`（权限）
    - `sortOrder`（排序）
- Task：任务，隶属于某个 Project，可包含提醒、优先级、重复规则等。
  - 常用字段：
    - `title`（标题）
    - `content`（内容）
    - `desc`（描述/清单说明）
    - `tags`（标签）
    - `priority`（优先级）
    - `status`（状态）
    - `startDate`（开始时间）
    - `dueDate`（截止时间）
    - `timeZone`（时区）
    - `reminders`（提醒）
    - `repeatFlag`（重复规则）
    - `items`（子任务列表）
- ChecklistItem：任务下的子任务（清单项），用于拆分步骤。
  - 常用字段：
    - `title`（标题）
    - `status`（状态）
    - `startDate`（开始时间）
    - `completedTime`（完成时间）
    - `timeZone`（时区）
    - `sortOrder`（排序）
- Column：项目看板列，用于 kanban 视图的列信息。
  - 常用字段：
    - `name`（列名）
    - `sortOrder`（排序）
- ProjectData：项目详情聚合，包含项目本身、未完成任务与列信息。

## 资源

- [ticktick_cli.py](scripts/ticktick_cli.py)：主 CLI 入口，负责读取配置并发起 API 调用。
- [dida365-openapi.md](references/dida365-openapi.md)：官方 Open API 文档快照，便于离线检索参数与字段。