📦 厨房
v1.0.0构建并运行一个便携的 Kitchen Compass 膳食规划工作区。在建立 Kitchen Compass 家庭数据根目录、将食谱转换为……时使用。
3· 3·0 当前·0 累计
by 下载技能包
最后更新
2026/4/24
安全扫描
OpenClaw
安全
high confidence该包与其既定目标内部一致：一个本地、便携的膳食规划引擎，基于用户指定的数据根运行，无需外部凭证或隐藏安装器。
评估建议
This skill appears coherent and local: it runs Python scripts against a data directory you control and doesn't ask for credentials. Before installing or running it, consider the following: 1) If you plan to use the weekly-deal features, inspect manage_deal_sources.py / prepare_weekly_deal_scan.py to see whether and how they fetch external URLs — saved retrieval recipes or store URLs supplied by you could cause network requests. 2) Run the tooling in a Python virtual environment and point --data-...详细分析 ▾
✓ 用途与能力
Name, description, and included files align: the repo contains a self-contained Python CLI engine (scripts/, references/, assets/) for building/querying recipe catalogs, planning, inventory, and optional weekly-deal brief tooling. It requests no external credentials or unusual binaries.
ℹ 指令范围
SKILL.md instructs the agent to run local Python scripts against a user-specified --data-root and documents reasonable boundaries (do not ship household data in the skill). The only potential expansion of scope is the optional 'weekly deal' workflow: users can save store retrieval recipes/URLs which, if acted on, could cause network fetches. The SKILL.md emphasizes manual or guided retrieval and states the engine does not autonomously scrape retailers.
✓ 安装机制
No install spec is present (instruction-only for runtime) and all code is bundled in the skill. No external downloads, package installs, or archive extraction are requested by the skill metadata.
✓ 凭证需求
The skill declares no required environment variables or credentials. SKILL.md references optional env vars (KITCHEN_COMPASS_DATA_ROOT, deprecated FOOD_BRAIN_DATA_ROOT, KITCHEN_COMPASS_VERBOSE) for convenience; none are mandatory.
✓ 持久化与权限
always is false and the skill writes only to a user-specified data-root. The code bootstraps and writes files under that data-root; it does not request or attempt to modify system-wide agent settings or other skills' configs.
安全有层次，运行前请审查代码。
运行时依赖
无特殊依赖
版本
latestv1.0.02026/4/24
Kitchen Compass 技能首次发布。 - 提供便携、仅含引擎的膳食规划工作区，逻辑与家庭数据完全分离。 - 清晰的初始化、校验与流程指引，覆盖食谱、库存、膳食规划及历史管理。 - 打包可复用脚本：初始化、食谱索引构建、查询、库存管理、周计划、优惠追踪、历史记录。 - 内置示例食谱，严格保留核心契约/Schema 引用。 - v1 保证支持“主菜+配菜”查询与规划。
● 无害
安装命令
点击复制官方npx clawhub@latest install kitchen-compass
镜像加速npx clawhub@latest install kitchen-compass --registry https://cn.longxiaskill.com
技能文档
使用本 skill 将可复用的 Kitchen Compass 引擎与家庭数据隔离。
运行规则
- 保持 skill 目录可移植；禁止在 skill 内部存放用户的真实食谱、库存或历史。
- 以用户数据根目录为唯一可信源；生成文件均可重建。
- 库存变动必须显式；禁止静默扣减或伪造实时库存。
- 将已安装的 skill 目录视为可移植引擎逻辑、模板与合约文档的权威来源。若另有实时或开发副本，需主动同步，禁止两边独立编辑。
- 冻结食谱合约：
references/recipe-schema.md中的标签、段落顺序、枚举集与组合语义不得更改。 - 保持
references/runtime-contract.md中的运行时假设与历史数据结构。 - 若机器使用的合约常量必须变更，先更新
scripts/contract.py，再同步参考文档。 - 保守原则：v1 引擎仅保证主菜+配菜查询/规划功能。
先读哪份文档
- 首次搭建或创建文件夹 →
references/setup-flow.md - 编辑、迁移、校验食谱或查字段 →
references/recipe-schema.md - 编辑历史或了解运行时约定 →
references/runtime-contract.md - 可选每周优惠简报设置或输出格式 →
references/weekly-deal-brief.md - 可移植性或边界规则 →
references/user-data-layout.md与references/live-vs-portable-boundary.md
使用内置脚本
假设 shell 已位于已安装的kitchen-compass skill 目录：
``bash
cd /path/to/kitchen-compass
`
然后对 household 数据根目录执行 scripts/ 下的脚本。 初始化新的 household 数据根
`bash
python3 scripts/setup_household.py --data-root /path/to/kitchen-compass-data
`
创建标准用户数据布局，并将示例食谱复制到 assets/sample-household/ 及 _recipe-template.md。旧环境变量 FOOD_BRAIN_DATA_ROOT 仍可用但已弃用，优先使用 KITCHEN_COMPASS_DATA_ROOT。 构建查询目录
`bash
python3 scripts/build_recipe_query_index.py --data-root /path/to/kitchen-compass-data
`
索引构建器会先按冻结合约校验所有食谱，失败则非零退出；紧急时可加 --skip-validation，正常情况保持校验开启。 查询食谱
`bash
python3 scripts/query_recipes.py --data-root /path/to/kitchen-compass-data --meal-type dinner --wants-side
` 增改库存
`bash
python3 scripts/manage_inventory.py --data-root /path/to/kitchen-compass-data add --label "Ground beef" --location freezer --kind protein --amount 3 --unit lb
python3 scripts/manage_inventory.py --data-root /path/to/kitchen-compass-data use --item freezer-ground-beef --amount 1 --unit lb --confirmed
` 生成一周计划
`bash
python3 scripts/build_weekly_plan.py --data-root /path/to/kitchen-compass-data --preset balanced
` 管理可选每周优惠源
`bash
python3 scripts/manage_deal_sources.py --data-root /path/to/kitchen-compass-data show
python3 scripts/manage_deal_sources.py --data-root /path/to/kitchen-compass-data add-store --label "Giant - Boot Rd" --retailer giant --source-type circular-url --source-url "https://example.com/circular" --retrieval-step "Resolve saved store before trusting the flyer" --default
python3 scripts/manage_deal_sources.py --data-root /path/to/kitchen-compass-data set-scan-schedule --day-of-week friday --time-local 12:00 --timezone America/New_York
` 准备每周优惠扫描并合并门店输出
`bash
python3 scripts/prepare_weekly_deal_scan.py --data-root /path/to/kitchen-compass-data --week-of 2026-04-21
python3 scripts/render_combined_weekly_deal_sheet.py --data-root /path/to/kitchen-compass-data
` 渲染手动单店每周优惠简报
`bash
python3 scripts/render_weekly_deal_brief.py --data-root /path/to/kitchen-compass-data
` 记录历史
`bash
python3 scripts/record_meal_history.py --data-root /path/to/kitchen-compass-data --event-type made --recipe burger-bowls
`
默认跳过重复事件（相同 date, recipe, meal_slot, event_type）并提示；加 --allow-duplicate 强制写入，或 --replace` 替换已有事件。