核心用法
Tandoor Recipe CLI Skill 为 AI Agent 提供了通过 tandoor-cli 命令行工具与 Tandoor Recipe Manager 实例交互的能力。支持食谱浏览、搜索、随机推荐,膳食计划管理,购物清单维护,食材库存追踪,以及烹饪日志记录等完整功能。
显著优点
- 权限分级精细:明确区分读取(安全)、写入(需确认)、破坏性(需明确确认)和行政操作(需特权令牌),降低误操作风险
- 供应链透明:开源 MIT 许可证,源码可审计,支持版本锁定避免意外更新
- 配置灵活:支持环境变量、配置文件、
.env文件三种认证方式 - 输出友好:所有读取命令支持
--json标志,便于 Agent 流水线处理 - 功能全面:覆盖从日常菜谱查询到家庭多用户管理的完整场景
潜在缺点与局限性
- 依赖特定 CLI 版本:技能文档与 CLI 版本强绑定,版本不匹配可能导致行为异常
- Token 权限敏感:行政操作(如 household 管理)需要空间所有者令牌,普通管理员权限不足
- 无原生回滚机制:删除操作不可逆,虽需双重确认但缺乏自动备份
- npm 供应链风险:虽建议锁定版本,但仍需信任 npm 包发布流程
适合人群
- 自建 Tandoor Recipe Manager 服务器的个人或家庭用户
- 希望通过 AI Agent 自动化膳食规划、购物清单管理的效率追求者
- 具备基础命令行使用经验、理解 API Token 安全重要性的技术用户
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| Token 泄露 | 长期令牌若泄露可被滥用 | 使用短期令牌、定期轮换、最小权限原则 |
| 误删数据 | 破坏性操作不可逆 | 双重确认机制、定期备份 Tandoor 数据库 |
| 供应链攻击 | npm 包被恶意篡改 | 锁定版本、审计源码、使用私有 registry |
| 权限提升 | 使用过高权限令牌执行普通操作 | 按场景区分只读/写入/管理令牌 |