Community生產力與協作github.com

steipete/things-todo

透過 Things CLI 操作 Things 3:新增、列出、搜尋、更新、刪除與驗證任務。

things-todo 是什麼?

此技能讓 AI 助理能夠透過命令列工具「things」與 Peter 的 Mac 上的 Things 3 任務管理應用程式進行互動。它支援完整的任務生命週期操作:新增、列出、搜尋、更新、刪除及驗證任務。此技能會優先使用 Things 專屬的 CLI,僅在使用者明確要求時才回退到 Apple 提醒事項。其底層依賴於第三方 CLI 工具「things3-cli」,並透過 Things URL Scheme 或 AppleScript 執行寫入操作,透過 JSON 輸出執行讀取操作,以避免直接操作 SQLite 資料庫,從而確保資料完整性。開發者需要注意,此技能僅限 macOS 平台,且某些操作(如更新)需要事先設定 `THINGS_AUTH_TOKEN` 環境變數。此技能也會遵守特定的轉換慣例,例如將模糊的需求轉化為具體的下一步行動、保留使用者明確的用語,以及將不相關的動作拆分為個別的待辦事項。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/things-todo

Installed? Explore more 生產力與協作 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Things Todo

用於 Peter 的 Mac 上的 Things 3 任務。偏好使用 things 處理 Things 支援的待辦事項;僅當使用者要求 Apple 提醒事項時才使用 $reminders。

工具

  • CLI:things
  • 儲存庫:https://github.com/ossianhempel/things3-cli
  • 安裝:
GOBIN=/opt/homebrew/bin go install github.com/ossianhempel/things3-cli/cmd/things@latest

更新 URL 操作的授權:

source ~/.profile >/dev/null 2>&1 || true
things auth

THINGS_AUTH_TOKEN 應來自 ~/.profile 或 1Password。絕不要將其印出。 things update --dry-run 必須將其塗改為 auth-token=***。

開始

使用 JSON 進行腳本化讀取與驗證:

things tasks --format json --limit 20
things today --format json
things search "query" --format json

Things 資料庫的讀取可能需要呼叫的應用程式具有「完整磁碟存取權限」。寫入操作應透過 Things URL Scheme 或 things 的 AppleScript 進行;請勿直接寫入 SQLite 資料庫。

新增

預設:新增,然後搜尋/讀取回來。

things add "預訂倫敦-舊金山直飛商務艙機票" --notes "僅限直飛。" --when tomorrow --tags travel
things tasks --search "LHR-SFO" --format json

有用的旗標:

  • --notes "文字"
  • --when today|tomorrow|evening|anytime|someday|YYYY-MM-DD
  • --deadline YYYY-MM-DD
  • --list "專案或領域"
  • --tags 標籤1,標籤2
  • --checklist-item "文字" 可重複使用
  • --dry-run 用於檢查 things:/// URL 而不進行實際修改。

更新 / 刪除

先找到 UUID,然後按 ID 進行修改:

things tasks --search "flight" --format json
things update --id <uuid> "新標題" --notes "已更新備註"
things tasks --search "新標題" --format json
things delete --id <uuid> --confirm <uuid>
things tasks --search "新標題" --format json
things trash --search "新標題" --format json

寫入後務必讀取回來。刪除會將項目移至 Things 垃圾桶;若清理很重要時,請驗證一般搜尋結果為空,且垃圾桶搜尋中包含該項目。

慣例

  • 將模糊的要求轉化為具體的下一步行動標題。
  • 當使用者明確表示要收集(capture)時,保留其用語。
  • 將不相關的動作拆分為不同的待辦事項。
  • 僅在使用者暗示時才使用「今天」;否則預設使用收件匣/隨時。
  • 在大量更新/刪除前偏好使用 --dry-run。
  • 若要計算當前日期,請執行 date 指令;不要猜測。

注意事項

  • 僅限 macOS;如果 Things.app 不存在或無法顯示,遠端主機上可能會顯示版本為 UNKNOWN。
  • update 需要 THINGS_AUTH_TOKEN;add 則不需要。
  • 對於新增/更新,--tags 是複數;對於過濾,tasks --tag 是單數。
  • today 的 JSON 可能顯示 start: Anytime 加上一個真正的 start_date;請使用命令的成員資格/回讀,而不是僅依賴單一個欄位,以驗證是否歸入「今天」。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

相關技能