Yatta! - Task & Capacity Management

核心功能

Yatta! Skill 是一款面向个人生产力管理的 API 集成工具，通过命令行与 Yatta! 任务管理系统深度对接。核心能力覆盖完整的任务生命周期管理：支持创建、更新、归档任务及批量操作；提供艾森豪威尔矩阵视图实现优先级可视化；具备实时容量规划功能，防止过度承诺；支持项目与上下文（Context）的多维组织；集成日历订阅同步、委托任务跟进及 AI 洞察分析。

显著优点

1. 完整方法论支撑：内置艾森豪威尔矩阵（Do First / Schedule / Delegate / Eliminate）和容量管理（Capacity Planning），将时间管理理论转化为可执行系统
2. 丰富的任务属性：支持优先级、预估工时、复杂度评分、标签、矩阵状态等元数据，便于精细筛选和分析
3. 委托与跟进机制：独有的 delegated_to 和 follow_up_schedule 字段，解决团队协作中的任务追踪痛点
4. 安全编码示范：文档强制要求使用 jq -n --arg 构建 JSON 和 URL 编码，有效防范注入攻击
5. 手动调用策略：disable-model-invocation: true 确保用户明确授权，避免自主操作风险

潜在局限

1. API 权限过于集中：Yatta! API 密钥无作用域限制，单个密钥即可读写删全部数据，无法实现最小权限原则
2. 依赖 Supabase 直链：当前使用 zunahvofybvxpptjkwxk.supabase.co 域名，品牌化 API 地址仍在开发中，存在供应商锁定观感
3. 无内置撤销机制：删除/归档操作即时生效，部分操作不可逆，文档虽警告但无软删除保护
4. 速率限制较严格：100 请求/分钟可能限制大规模批量操作场景
5. 需要技术门槛：纯 API 调用模式，无图形界面，普通用户学习成本较高

适合人群

• 习惯命令行工作流的开发者和技术用户
• 需要与现有脚本/自动化工具链集成的效率爱好者
• 团队中使用 Yatta! 作为核心任务系统，需批量管理任务的项目负责人
• 对数据主权敏感、倾向于本地脚本而非 SaaS 界面的用户

常规风险

数据安全风险：API 密钥泄露将导致完整账户接管，文档反复强调使用 1Password CLI 等密码管理工具及环境变量存储。注入攻击风险：若不遵循文档要求的 jq 安全模式，用户输入可能触发 shell 或 JSON 注入。误操作风险：批量更新和归档无二次确认，测试环境验证不足可能导致生产数据丢失。供应链风险：Supabase 基础设施虽可靠，但非 Yatta! 自有域名可能引发钓鱼顾虑，建议等待 api.yattadone.com 上线后使用。

核心用法

Yatta! Skill 是一个面向 OpenClaw 代理的任务与生产力管理集成工具，通过与 Yatta! 后端 API 的交互，实现完整的个人工作流管理。核心功能覆盖六大模块：任务管理（创建、更新、归档、批量操作）、项目管理（多项目工作流支持）、上下文管理（任务分类与标签）、日历同步（iCal 订阅集成）、委托与跟进（自动化提醒流程），以及容量规划（实时工作负载计算与防过载）。

使用方法上，用户需先配置 YATTA_API_KEY 环境变量获取 API 访问权限，随后通过标准化的 REST API 调用执行操作。Skill 提供了丰富的过滤与查询能力——支持按状态、优先级、项目、截止日期、艾森豪威尔矩阵象限等多维度检索任务。特别值得注意的是，该 Skill 强制要求手动调用（disable-model-invocation: true），所有破坏性操作均需用户明确指令，避免代理自主修改数据。

安全编码方面，Skill 采用 jq 工具构建 JSON 载荷并通过 @uri 过滤器进行 URL 编码，彻底规避 Shell 注入与 JSON 注入风险。对于高频场景，还提供 yatta-safe-api.sh 封装脚本实现零样板代码的安全调用。

显著优点

安全架构领先：相比同类生产力工具，Yatta! Skill 的安全文档完整度极高，不仅明确标注所有破坏性操作，还提供输入验证指南、端点验证脚本和分层安全建议。强制手动调用策略从根本上杜绝了代理误操作风险。

方法论驱动设计：内置艾森豪威尔矩阵（紧急/重要四象限）和容量管理功能，将时间管理理论转化为可执行的工作流，帮助用户从"任务堆积"转向"战略性优先级管理"。

零依赖轻量化：仅依赖系统级工具 curl 与 jq，无第三方 Node.js/Python 包，显著降低供应链攻击面，同时保证跨平台兼容性。

自动化友好：支持批量操作、日历订阅同步、跟进计划自动化，并可构建每日简报、周报生成等脚本化工作流，适合开发者风格的效率管理。

潜在缺点与局限性

API 权限粒度不足：Yatta! 当前仅提供全权限 API Key，无法实现只读或限定范围访问，密钥泄露风险较高，必须依赖用户端的安全存储实践。

外部服务依赖：后端托管于 Supabase，使用自动生成域名而非品牌域名，虽已在文档中充分披露，但对企业级用户可能引发合规顾虑。服务可用性完全依赖 Yatta! 平台稳定性。

学习曲线陡峭：相比图形界面应用，命令行 API 调用需要用户熟悉 jq 语法、环境变量管理和 Shell 脚本编写，非技术用户上手成本较高。

功能边界限制：当前版本不支持离线模式、本地数据缓存或冲突解决机制，网络中断时完全不可用。

适合的目标群体

该 Skill 最适合技术型知识工作者——软件开发者、产品经理、技术写作者、独立咨询师等具备命令行使用经验、追求工作流自动化的用户群体。对于已在使用 Yatta! 主应用、希望将其与开发环境深度集成的用户价值最大。同时适合效率方法论实践者（GTD、深度工作、时间块管理等），因其内置的矩阵视图和容量计算可直接支撑理论落地。

不适合：纯图形界面偏好者、无技术背景的普通办公用户、需要企业级 SSO/审计日志的团队场景。

常规风险

密钥管理风险：API Key 存储于环境变量或密码管理器，若发生泄露将导致完整账户数据暴露。建议启用 1Password CLI 等动态注入方案，避免静态密钥残留于 shell 历史或配置文件中。

误操作风险：尽管已禁用自动调用，用户在手动执行批量更新或归档操作时仍可能因参数错误导致数据丢失。建议在关键操作前通过只读查询确认影响范围。

服务连续性风险：Yatta! 作为个人开发者维护项目，长期维护承诺不明；Supabase 免费额度或策略变更也可能影响服务可用性。建议定期导出关键数据备份。

速率限制：API 限制 100 请求/分钟，批量场景需实现退避重试逻辑。