Community生产力与协作github.com

steipete/things-todo

通过 things CLI 管理 Things 3 任务:添加、列出、搜索、更新、删除与验证。

things-todo 是什么?

该技能通过第三方命令行工具 `things` 与 Things 3 任务管理器集成,在 macOS 环境下提供完整的任务管理能力。支持添加、列出、搜索、更新、删除和验证任务,并支持标题、备注、截止日期、列表/项目归属、标签、检查清单等丰富属性。与 Apple 提醒事项不同,本技能专为 Things 用户设计,优先使用 `things` CLI 而非 `$reminders` 系统。底层通过 Things URL Scheme 和 AppleScript 进行安全写入,使用 JSON 格式进行可脚本化的读取和验证。关键限制包括:仅限 macOS、更新操作需要 THINGS_AUTH_TOKEN 认证、写入时需避免直接操作 SQLite 数据库,以及检查 Today 列表时需结合多个字段而非单一字段。

兼容平台~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 或 AppleScript 经由 things 进行;请勿直接写入 SQLite 数据库。

添加

默认操作:添加,然后搜索/读取返回。

things add "预订 LHR-SFO 直飞商务舱航班" --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 tag1,tag2
  • --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 回收站;在需要确认清理时,验证普通搜索结果为空且回收站搜索结果包含该项目。

约定

  • 将模糊的请求转化为具体的下一步行动标题。
  • 当用户明确表示只是记录而非重写时,保留原有措辞。
  • 将无关操作拆分为单独的待办事项。
  • 仅在用户暗示时使用“今天”;否则默认使用收件箱/随时。
  • 在批量更新/删除前优先使用 --dry-run。
  • 对于当前日期计算,运行 date;不要猜测。

注意事项

  • 仅限 macOS;如果 Things.app 在远程主机上缺失或不可见,远程主机可能显示版本为 UNKNOWN。
  • update 需要 THINGS_AUTH_TOKEN;add 不需要。
  • --tags 在添加/更新中为复数形式;tasks --tag 在过滤中为单数形式。
  • today JSON 可能显示 start: Anytime 加上一个真实的 start_date;要验证 Today 列表位置,请使用命令成员关系/读取返回,而不是仅依赖某一个字段。

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.

相关技能