核心用法
Yatta! Skill 是一款面向开发者和高级用户的命令行任务管理工具，通过 REST API 与 Yatta! 生产力平台深度集成。该技能以 curl + jq 为核心依赖，提供完整的任务生命周期管理能力，涵盖任务创建、筛选、批量更新、归档，以及项目管理、上下文标签、评论系统、日历订阅、跟进提醒和产能计算等高级功能。
显著优点
1. 全面的功能覆盖：不仅支持基础 CRUD 操作，还提供艾森豪威尔矩阵视图、产能利用率分析、完成速度指标、连续完成天数统计等生产力分析功能，数据驱动决策。
2. 灵活的自动化能力：支持通过 shell 脚本实现每日简报、周计划报告、邮件转任务等自动化工作流，适合构建个人或团队的生产力管道。
3. 精细的数据筛选：支持按状态（todo/doing/done）、优先级、项目、矩阵状态（delegated/waiting）、日期范围等多维度筛选，配合 jq 可实现复杂的数据处理。
4. 安全的密钥管理：官方推荐使用 1Password CLI 进行密钥管理，支持环境变量注入，避免硬编码风险。
潜在缺点与局限性
1. 破坏性操作风险高：API 密钥具有完全权限（无只读作用域），DELETE/POST/PUT 操作会立即生效且部分删除不可恢复，用户需自行承担误操作风险。
2. 技术门槛较高：要求用户熟悉命令行操作、curl 语法、jq 数据处理和 JSON 格式，非技术用户难以直接使用。
3. 依赖外部服务稳定性：当前直接暴露 Supabase Edge Functions URL，虽文档说明后续将推出品牌化域名，但目前存在供应商锁定风险。
4. 无图形界面反馈：所有操作均为命令行交互，缺乏可视化的即时反馈机制，批量操作前难以预览影响范围。
适合人群
- 习惯终端环境的开发者、DevOps 工程师
- 需要构建自动化工作流的效率极客
- 已使用 Yatta! 主应用并寻求 API 扩展的高级用户
- 团队管理员需要批量管理任务或导出分析数据
常规风险
- 数据丢失风险：归档操作可恢复，但部分删除操作永久生效；批量更新无事务回滚机制
- 速率限制：100 请求/分钟的限制可能影响大规模批处理
- 密钥泄露风险：yatta_ 开头的密钥若泄露，攻击者可获取完整账户权限
- 网络依赖：API 调用失败时需自行实现重试和错误处理逻辑
- 日期时区处理：ISO 8601 格式要求严格，时区转换易出错
建议首次使用时在测试项目中验证所有关键操作，并建立完善的密钥轮换机制。