核心用法
Tandoor Recipe CLI Skill 为 AI Agent 提供了通过命令行与 Tandoor Recipe Manager 实例交互的能力。该工具基于 tandoor-cli npm 包，支持完整的食谱生命周期管理、膳食计划编排、购物清单维护以及家庭成员协作功能。
显著优点
1. 权限分级精细：将操作明确划分为读取（安全）、写入（需确认）、破坏性（需显式确认）和行政管理（需特权令牌）四个层级，有效降低误操作风险。
2. 数据格式灵活：支持 text、json、api 三种输出格式，其中 json 格式专为编辑回环设计，方便 Agent 获取-修改-更新工作流。
3. 批量操作支持：购物清单的批量勾选与清空、食谱的批量导入等场景均有专门优化。
4. 供应链透明：明确标注 npm 包来源与 GitHub 仓库地址，支持版本锁定安装，降低供应链攻击面。
5. 配置方式多样：支持环境变量、配置文件、~/.config 目录和 .env 文件四种配置方式，适应不同部署环境。
潜在缺点与局限性
1. 版本敏感：Skill 文档与 CLI 工具版本强绑定，版本不匹配可能导致命令行为异常或缺失。
2. 权限门槛复杂：家庭管理、邀请链接创建等操作需要空间所有者令牌，普通管理员甚至超级用户都可能遭遇 403 错误，权限模型理解成本较高。
3. 令牌管理负担：虽然文档强调最小权限原则和定期轮换，但实际落地依赖用户安全意识，缺乏自动化令牌生命周期管理。
4. 无内置审计日志：CLI 本身不记录操作审计轨迹，依赖 Tandoor 实例的后端日志进行追溯。
适合人群
- 使用 Tandoor Recipe Manager 自托管实例的技术用户
- 需要通过自动化脚本批量管理食谱、膳食计划或购物清单的家庭管理员
- 希望将食谱数据与 AI 工作流集成的开发者
常规风险
| 风险类型 | 说明 |
|---------|------|
| 数据误删 | `delete`、`clear`、`--force` 等操作不可逆，需严格遵循显式确认流程 |
| 令牌泄露 | `TANDOOR_API_TOKEN` 若被硬编码或日志泄露，可导致实例被完全控制 |
| 供应链风险 | npm 包被恶意更新可能植入后门，建议锁定版本并校验仓库签名 |
| 权限提升 | 使用空间所有者令牌执行非必要操作会扩大攻击面 |
| 并发冲突 | 多 Agent 同时写入同一食谱或购物清单可能产生数据竞争 |
安全建议
- 生产环境使用只读令牌，仅在进行管理操作前临时切换特权令牌
- 在 CI/CD 或自动化脚本中使用短时效令牌并配合密钥管理服务
- 定期执行
tandoor -V验证 CLI 版本与 Skill 文档一致性 - 敏感操作前通过
--dry-run（如import命令支持）预览变更