OmniFocus Automation

核心功能

OmniFocus Skill 是专为 macOS 设计的任务管理自动化工具，通过 JavaScript for Automation (JXA) 深度控制 OmniFocus 3/4。它提供完整的任务生命周期管理能力，涵盖从快速收件箱捕获到复杂项目追踪的完整 GTD（Getting Things Done）工作流。

显著优点：

• 原生深度集成：直接调用 OmniFocus 内部 API，支持内部任务 ID、重复规则 (RRULE)、标签层级等高级特性
• GTD 完整支持：涵盖收集（inbox）、处理（flag/defer）、组织（project/folder/tag）、回顾（today/search）、执行（complete）全流程
• 灵活的重复机制：支持三种重复模式（fixed/完成后顺延延期/完成后顺延到期），满足习惯追踪与截止日管理不同场景
• JSON 标准化输出：所有操作返回结构化数据，便于脚本流水线与第三方工具集成
• 智能容错设计：标签与重复操作使用 AppleScript 回退，规避 JXA 类型转换已知问题

潜在局限：

• 平台锁定：仅支持 macOS，且强制依赖 OmniFocus 商业软件（约￥300-500 授权费用）
• 自动化权限门槛：首次使用需用户手动授权"辅助功能/自动化"权限，企业托管设备可能受限
• 无跨设备同步能力：仅操作本地实例，iOS/iPad 端任务需依赖 OmniFocus 原生云同步
• 命令式非对话式：当前设计为 CLI 风格命令，自然语言理解需外层封装

适用人群：

• 已深度使用 OmniFocus 的知识工作者、项目经理
• 需将 OmniFocus 与 Alfred、Keyboard Maestro、Hammerspoon 等效率工具链整合的自动化用户
• 习惯用终端/脚本管理待办的开发者群体

常规风险：

• delete 命令永久移除任务无回收站机制，误操作数据不可恢复
• 日期格式强制 ISO 标准，本地化格式输入可能导致静默失败
• 项目/文件夹名称大小写敏感，脚本批量操作前建议用 list 命令验证
• 高频 API 调用（如批量添加标签）可能触发 OmniFocus 后台限流，表现为操作延迟

核心功能

OmniFocus Skill 是专为 macOS 打造的本地任务管理自动化工具，基于 JavaScript for Automation (JXA) 技术，完整覆盖 GTD（Getting Things Done）工作流需求：

• 任务生命周期管理：创建、完成、删除、重命名任务，设置截止日期与推迟日期
• 项目与层级组织：管理文件夹、项目结构，支持任务跨项目移动
• 智能标签系统：自动创建标签、增删标签，实现多维度任务分类
• 重复任务引擎：支持固定周期、完成后延期等多种重复规则
• 快速查询筛选：收件箱、今日任务、已标记、自定义搜索等多视图支持

所有操作返回结构化 JSON，便于脚本集成和自动化工作流编排。

显著优势

1. 零网络暴露
完全离线运行，无 HTTP 请求、无 API 调用、无数据传输通道，从根本上杜绝数据外泄风险。

2. 深度系统集成
直接与 OmniFocus 应用进程通信，利用官方 Omni Automation 接口，操作原子性和数据一致性有保障。

3. 输出标准化
统一 JSON 响应格式，配合命令行包装脚本，可无缝嵌入 Shell 工作流、Alfred 快捷指令或其他自动化工具。

4. 容错设计
针对 JXA 已知 Bug（tag/repeat API 类型转换问题）采用 AppleScript 桥接方案，并实施严格字符串转义，兼顾功能完整性与安全性。

潜在局限

• 平台锁定：仅支持 macOS，需 OmniFocus 3/4 已购正版授权
• 权限门槛：首次使用需用户手动在「系统设置 > 隐私与安全 > 自动化」中授权 OmniFocus 访问
• 输入敏感：项目名称、文件夹名称区分大小写，特殊字符需正确转义
• 无冲突检测：不处理 OmniFocus 内部并发编辑冲突，极端场景可能产生数据不一致

适用人群

• OmniFocus 重度用户，追求键盘驱动的高效工作流
• 需要将任务管理与 Shell/Alfred/Keyboard Maestro 等工具链集成的自动化爱好者
• 重视数据隐私、拒绝云端同步的本地优先主义者
• GTD 方法论实践者，依赖项目-标签-截止日期的复杂任务组织体系

常规风险提示

| 风险类别 | 说明 | 缓解措施 |

|---------|------|---------|

| 自动化权限滥用 | 恶意 Skill 可能利用已授权通道操作 OmniFocus | 仅从可信来源安装，首次运行仔细核对权限请求 |

| 任务数据误操作 | `delete` 命令永久删除，`complete` 不可逆 | 建议配合 `info` 命令确认任务 ID，重要数据定期备份 |

| 重复规则配置错误 | 错误的 RRULE 可能导致任务无限生成 | 使用标准格式（YYYY-MM-DD），小范围测试后再批量应用 |

| 长输入性能影响 | 未限制的任务名称/备注长度可能影响响应 | 建议保持单条记录不超过 10KB |