mcpField
T
ticktick-cli

ticktick-cli

github.com/flexoid生産性443 回インストール37 週間前に更新
リポジトリ

ticktick-cli について

ticktick-cli は、ターミナルコマンドで TickTick のワークフローを実行するためのスキルです。タスクや関連データを扱う際に、構造化出力、変更前の ID 特定、書き込み後の検証を促します。

主な機能

  1. 01CLI から TickTick を操作
  2. 02JSON 出力を優先
  3. 03変更前に名前から ID を特定
  4. 04書き込み後に結果を検証
  5. 05破壊的操作の前に確認

活用シーン

  1. 01ターミナルからタスクを検索・更新
  2. 02プロジェクト ID を指定してタスクを変更
  3. 03タスクの日付を設定して結果を確認
  4. 04プロジェクトやタグの削除前に確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/flexoid/ticktick-cli --skill ticktick-cli

インストール後、Claude Code で/ticktick-cliを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
columns.md
folders.md
habits.md
projects.md
setup-and-auth.md
tags.md
tasks.md
troubleshooting.md
user-focus-sync.md

詳細

TickTick CLI

このスキルを使用すると、ターミナルコマンドから TickTick のワークフローを直接実行し、出力を確定的に処理できます。

実行ポリシー

  1. 最初に、要求された ticktick ... コマンドを実行します。バージョンやツールの有無を事前に確認するコマンドは実行しないでください。
  2. CLI が見つからず実行に失敗した場合は、references/setup-and-auth.md を読み込み、インストールの復旧手順に従います。
  3. 認証または設定の問題で実行に失敗した場合は、references/setup-and-auth.md を読み込み、元のコマンドを再試行する前に、ガイドに沿って認証を行います。
  4. 認証の復旧は CLI のみで行います。独自の SDK/Python トークン交換スクリプトを作成しないでください。
  5. コマンドが不明なフラグや引数、または必須パラメーターの不足で失敗した場合に限り、復旧手段として --help を使用します。

デフォルト

  • すべてのデータコマンドで --json を優先し、構造化出力を解析します。
  • 変更を行う前に名前を ID に解決します。識別子を推測しないでください。
  • 書き込み操作では、「読み取り → 変更 → 検証」の手順を必ず実行します。
  • 決定的な動作が重要なタスク変更では、明示的な --project PROJECT_ID を優先します。
  • 明示的な日付形式を使用します(日付のみのフィールドには YYYY-MM-DD、時刻を含むフィールドには ISO 日時)。

安全性

  • インストールや環境の変更を行う前に、ユーザーの明示的な確認を求めます。
  • ユーザーがその方法を明示的に求めない限り、リスクの高いシステムインストール用フラグを使用しないでください。
  • ユーザーに表示される出力に、秘密情報やトークンを決して表示しないでください。
  • 次の破壊的な操作を行う前に、ユーザーの明示的な確認を求めます。
    • tasks delete
    • projects delete
    • folders delete
    • columns delete
    • tags delete
    • tags merge
    • habits delete

リファレンスマップ

現在の作業領域に必要なファイルだけを読み込みます。

コメント