ticktick-cli について
ticktick-cli は、ターミナルコマンドで TickTick のワークフローを実行するためのスキルです。タスクや関連データを扱う際に、構造化出力、変更前の ID 特定、書き込み後の検証を促します。
主な機能
- 01CLI から TickTick を操作
- 02JSON 出力を優先
- 03変更前に名前から ID を特定
- 04書き込み後に結果を検証
- 05破壊的操作の前に確認
活用シーン
- 01ターミナルからタスクを検索・更新
- 02プロジェクト ID を指定してタスクを変更
- 03タスクの日付を設定して結果を確認
- 04プロジェクトやタグの削除前に確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ flexoid/ ticktick-cli --skill ticktick-cliインストール後、Claude Code で/ticktick-cliを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/columns.mdfolders.mdhabits.mdprojects.mdsetup-and-auth.mdtags.mdtasks.mdtroubleshooting.mduser-focus-sync.md詳細
TickTick CLI
このスキルを使用すると、ターミナルコマンドから TickTick のワークフローを直接実行し、出力を確定的に処理できます。
実行ポリシー
- 最初に、要求された
ticktick ...コマンドを実行します。バージョンやツールの有無を事前に確認するコマンドは実行しないでください。 - CLI が見つからず実行に失敗した場合は、
references/setup-and-auth.mdを読み込み、インストールの復旧手順に従います。 - 認証または設定の問題で実行に失敗した場合は、
references/setup-and-auth.mdを読み込み、元のコマンドを再試行する前に、ガイドに沿って認証を行います。 - 認証の復旧は CLI のみで行います。独自の SDK/Python トークン交換スクリプトを作成しないでください。
- コマンドが不明なフラグや引数、または必須パラメーターの不足で失敗した場合に限り、復旧手段として
--helpを使用します。
デフォルト
- すべてのデータコマンドで
--jsonを優先し、構造化出力を解析します。 - 変更を行う前に名前を ID に解決します。識別子を推測しないでください。
- 書き込み操作では、「読み取り → 変更 → 検証」の手順を必ず実行します。
- 決定的な動作が重要なタスク変更では、明示的な
--project PROJECT_IDを優先します。 - 明示的な日付形式を使用します(日付のみのフィールドには
YYYY-MM-DD、時刻を含むフィールドには ISO 日時)。
安全性
- インストールや環境の変更を行う前に、ユーザーの明示的な確認を求めます。
- ユーザーがその方法を明示的に求めない限り、リスクの高いシステムインストール用フラグを使用しないでください。
- ユーザーに表示される出力に、秘密情報やトークンを決して表示しないでください。
- 次の破壊的な操作を行う前に、ユーザーの明示的な確認を求めます。
tasks deleteprojects deletefolders deletecolumns deletetags deletetags mergehabits delete
リファレンスマップ
現在の作業領域に必要なファイルだけを読み込みます。
コメント
Markdown 対応