🛠️ 開発・MCP コミュニティ
ticktick-cli
使用 Python CLI 与 Dida365 Open API 交互以管理滴答清单任务/项目,适用于需要通过脚本或命令行调用滴答清单接口的场景(如项目/任务的查询、创建、更新、完成、删除)。
⚡ おすすめ: コマンド1行でインストール(60秒)
下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。 ダウンロード → 解凍 → 配置まで全自動。
🍎 Mac / 🐧 Linux
mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o ticktick-cli.zip https://jpskill.com/download/18604.zip && unzip -o ticktick-cli.zip && rm ticktick-cli.zip
🪟 Windows (PowerShell)
$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/18604.zip -OutFile "$d\ticktick-cli.zip"; Expand-Archive "$d\ticktick-cli.zip" -DestinationPath $d -Force; ri "$d\ticktick-cli.zip"
完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。
💾 手動でダウンロードしたい(コマンドが難しい人向け)
- 1. 下の青いボタンを押して
ticktick-cli.zipをダウンロード - 2. ZIPファイルをダブルクリックで解凍 →
ticktick-cliフォルダができる - 3. そのフォルダを
C:\Users\あなたの名前\.claude\skills\(Win)または~/.claude/skills/(Mac)へ移動 - 4. Claude Code を再起動
⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。
🎯 このSkillでできること
下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。
📦 インストール方法 (3ステップ)
- 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
- 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
- 3. 展開してできたフォルダを、ホームフォルダの
.claude/skills/に置く- · macOS / Linux:
~/.claude/skills/ - · Windows:
%USERPROFILE%\.claude\skills\
- · macOS / Linux:
Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。
詳しい使い方ガイドを見る →- 最終更新
- 2026-05-18
- 取得日時
- 2026-05-18
- 同梱ファイル
- 6
📖 Skill本文(日本語訳)
※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。
[Skill 名] ticktick-cli
説明:以下の呼び出し方式はすべて、現在の SKILL.md ファイルがあるフォルダを workdir とします。
- 常用子コマンド(日常の場面を網羅)
projectlistget --project-iddata --project-idcreate --name [--color --sort-order --view-mode --kind]update --project-id [--name --color --sort-order --view-mode --kind]delete --project-id(危険、削除前に慎重に確認してください)
taskget --project-id --task-idcreate --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-iddelete --project-id --task-id(危険、削除前に慎重に確認してください)
- 出力形式
- すべての呼び出しは、スクリプトの後、サブコマンドの前に
--jsonを追加します(例:./scripts/ticktick_cli.py --json task get --project-id ...)
- 冷門なパラメータ/フィールドの調べ方
./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:メインの CLI エントリポイント。設定を読み取り、API 呼び出しを開始します。
- dida365-openapi.md:公式の Open API ドキュメントのスナップショット。パラメータとフィールドをオフラインで検索するのに役立ちます。
📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開
说明:以下调用方式均以当前 SKILL.md 文件所在文件夹为 workdir。
- 常用子命令(覆盖日常场景)
projectlistget --project-iddata --project-idcreate --name [--color --sort-order --view-mode --kind]update --project-id [--name --color --sort-order --view-mode --kind]delete --project-id(危险,删除前需谨慎确认)
taskget --project-id --task-idcreate --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-iddelete --project-id --task-id(危险,删除前需谨慎确认)
- 输出格式
- 所有调用统一在脚本后、子命令前加
--json(示例:./scripts/ticktick_cli.py --json task get --project-id ...)
- 冷门参数/字段怎么查
- 运行
./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:主 CLI 入口,负责读取配置并发起 API 调用。
- dida365-openapi.md:官方 Open API 文档快照,便于离线检索参数与字段。
同梱ファイル
※ ZIPに含まれるファイル一覧。`SKILL.md` 本体に加え、参考資料・サンプル・スクリプトが入っている場合があります。
- 📄 SKILL.md (3,102 bytes)
- 📎 assets/ticktick-oauth-worker.js (5,362 bytes)
- 📎 README.md (1,480 bytes)
- 📎 references/dida365-openapi.md (23,329 bytes)
- 📎 scripts/ticktick_api_client.py (13,154 bytes)
- 📎 scripts/ticktick_cli.py (16,530 bytes)