omnifocus

OmniFocus Manager 是一款专为进阶使用者设计的技能，旨在将任务管理流程直接整合至终端机或 Claude 互动环境中。它提供强大的接口来与 OmniFocus 项目及任务互动，缩减手动输入与自动化数据处理之间的差距。此工具非常适合开发人员、项目经理以及任何依赖 OmniFocus 进行 GTD（待办事项管理）的使用者，帮助透过程序化方式操控任务清单，从而减少切换操作情境的负担。

• 智慧型方法检测会自动选择最有效率的执行路径，涵盖 Omni Automation (JavaScript API)、AppleScript 或 SQLite 只读备援模式，确保在所有版本的 OmniFocus 上皆能保持高度兼容性。

• 全方位的任务生命周期管理功能，允许使用者建立包含中继数据的新任务、透过标签或项目名称等筛选条件查询现有任务，以及执行如「标记任务为完成」等状态更新操作。

• 原生项目列出功能可提取关于目前项目的结构化 JSON 数据，包含任务数量与状态指标，有助于提升数据的可见度与洞察力。

• 强大的指令列整合能力支持常见 Shell 操作，让使用者能够串接任务、将输出导向至如 jq 等工具进行进一步处理，并将 OmniFocus 数据整合至更大型的报告或分析流程中。

• 灵活的参数支持功能可处理任务标题、注记、ISO 8601 格式的截止日期以及复杂的标签结构，以维护高质量的任务数据。

• 在建立任务前务必先查询精确的项目名称，因为项目名称可能包含特殊字符或文件夹字首；建议优先使用 --list-projects 指令进行验证。

• 执行更新时，请先透过 --read 指令取得特定的任务 ID，以确保操作精确度。

• 对于名称复杂的项目，建议使用 AppleScript 作为备援方式；若无法取得自动化权限，则可使用 SQLite 只读模式进行数据查询。

• 完整写入功能需要操作系统层级的自动化存取权限（请检查隐私权与安全性设置）；若遇到存取错误，请参阅本地设置说明。

• 本工具针对 JSON 输出进行优化，非常适合用于程序化解析并整合进自定义脚本中。