Xiwu Inventory

当用户问"还有 XX 吗"、"找一下 XX"时：

1. 执行：xiwu search <关键词> --json
2. 如果结果为空，告诉用户"没有找到相关物品"
3. 如果有结果，以自然语言呈现，包含：物品名称、数量、单位、分类、到期日（如有）、位置（如有）

按分类查看

当用户问"XX 类有什么"、"冰箱里有什么"时：

1. 将用户的描述映射到预置分类名（如"冰箱"→ 生鲜、冷冻食品、乳制品）
2. 执行：xiwu list -c <分类名> --json
3. 以自然语言列表呈现结果

查看临期物品

当用户问"什么快过期了"、"快要过期的东西"时：

1. 执行：xiwu list --expiring 7 --json（默认 7 天）
2. 如果用户指定了天数（如"3天内过期的"），使用对应天数
3. 将临期物品按到期日排序呈现，标注剩余天数

查看过期物品

当用户问"过期了哪些"、"哪些东西过期了"时：

1. 执行：xiwu list --expired --json
2. 如果没有过期物品，告诉用户"暂无过期物品"
3. 如果有过期物品，按分类分组呈现，提醒用户及时处理

库存盘点

当用户问"家里物资整体情况"、"盘点一下"时：

1. 执行：xiwu stocktake --json
2. 总结：总物品数、已过期数、临期数
3. 按分类列出各类物品数量

查看分类列表

当用户问"有哪些分类"、"分类"时：

1. 执行：xiwu categories --json
2. 列出所有可用分类

写操作

添加物品

当用户说"买了 XX"、"新添了 XX"、"入库 XX"时：

必填字段检查（按顺序）：

可选字段（不追问，有则填入）：

执行流程：

1. 从用户消息中提取所有已知字段
2. 逐项检查 name、category、quantity 是否已提供
3. 如有缺失，一次性追问所有缺失字段（不要分多次追问）
4. 收齐后执行：xiwu add "<name>" -c <category> -q <quantity> --json（附带用户提供的可选字段）
5. 将添加结果呈现给用户

示例：

用户: "我刚买了牛奶" → 追问: "好的，请补充以下信息：\n· 牛奶属于哪个分类？（可选：调味品、主食、乳制品、饮料、零食、冷冻食品、生鲜、清洁用品、洗护用品、纸巾、药品、宠物用品、其他）\n· 买了几件？"

用户: "乳制品，两箱" → 执行: xiwu add "牛奶" -c 乳制品 -q 2 -u 箱 --json

消耗/减少物品

当用户说"XX 用了一个"、"喝了一盒"、"消耗了"时：

1. 确认物品 ID：
   • 如果用户提到了 ID（如"3号"），直接使用
   • 如果只说了名称（如"牛奶喝了一盒"），执行 xiwu search <名称> --json
   • 搜索结果只有一条，向用户确认后使用该 ID
   • 搜索结果有多条，列出匹配项让用户选择
   • 搜索无结果，告诉用户"未找到相关物品"
2. 确认操作：向用户确认操作（"确认将 [物品名] 的数量减少 X？"）
3. 执行：xiwu update <id> -q <新数量> --json（将当前数量减去消耗量）
4. 呈现更新结果

删除物品

当用户说"XX 扔了"、"把 XX 删了"、"过期了扔掉"时：

1. 确认物品 ID：同消耗物品的 ID 确认流程
2. 确认操作：向用户确认删除（"确认删除 [物品名]？此操作不可撤销。"）
3. 执行：xiwu remove <id> --json
4. 呈现删除结果

修改物品属性

当用户说"把 XX 改成 YY"、"修改 XX 的到期日"时：

1. 确认物品 ID：同消耗物品的 ID 确认流程
2. 确认修改内容：向用户确认将要修改的字段和新值
3. 执行：xiwu update <id> <修改参数> --json
4. 呈现更新结果

update 命令参数映射：

结构化输出

本 Skill 的所有输出为结构化数据，供 Agent 层消费。不自行决定推送格式、渠道或接收人。

定时预警输出格式

当由 OpenClaw Cron 定时任务触发时，执行以下命令并返回结构化数据：

xiwu list --expired --json
xiwu list --expiring 7 --json
xiwu stocktake --json

返回格式：

{
  "type": "inventory_alert",
  "timestamp": "<ISO 8601>",
  "expired": [
    {
      "id": 1,
      "name": "物品名",
      "quantity": 1,
      "unit": "盒",
      "category": "乳制品",
      "expire_date": "2026-04-01"
    }
  ],
  "expiring_soon": [
    {
      "id": 2,
      "name": "物品名",
      "quantity": 2,
      "unit": "箱",
      "category": "生鲜",
      "expire_date": "2026-04-12",
      "days_remaining": 3
    }
  ],
  "summary": {
    "total_items": 15,
    "expired_count": 2,
    "expiring_soon_count": 3,
    "categories_count": 5
  }
}

Cron 集成说明

• Skill 不自行推送通知，只返回上述结构化数据
• Agent 层（SOUL.md）根据返回数据决定推送格式、渠道和接收人
• Cron 触发时无需用户输入，Skill 自动执行查询并返回结果

购买建议上下文

当用户问"该买什么了"、"需要补货吗"或 Cron 触发补货检查时：

1. 执行 xiwu stocktake --json 获取整体库存
2. 执行 xiwu list --expiring 7 --json 获取临期物品
3. 整合数据，输出购买建议上下文：

{
  "type": "purchase_suggestion_context",
  "timestamp": "<ISO 8601>",
  "low_stock": [
    {
      "name": "牛奶",
      "quantity": 1,
      "unit": "盒",
      "category": "乳制品",
      "suggestion": "库存较低，建议补货"
    }
  ],
  "expiring_soon": [
    {
      "name": "鸡蛋",
      "quantity": 3,
      "unit": "个",
      "category": "生鲜",
      "expire_date": "2026-04-12",
      "days_remaining": 3,
      "suggestion": "即将过期，优先消耗"
    }
  ],
  "shopping_list": [
    {
      "category": "乳制品",
      "items": ["牛奶"],
      "reason": "库存不足"
    }
  ]
}

此上下文供 Agent 层调度其他 Skill（电商、比价等）生成具体购买建议。 本 Skill 不直接调用电商或比价服务。

错误处理

规则

1. 禁止猜测必填字段：name、category、quantity 缺失时必须追问用户，不得自行推断默认值
2. 禁止跳过 ID 确认：写操作涉及物品 ID 时，如从搜索推断，必须经用户确认
3. 禁止自行推送：不发送通知、邮件、短信等，推送由 Agent 层决定
4. 禁止猜测到期日：用户未提供到期日时不填入，不自行生成默认日期
5. 始终使用 --json：所有命令调用必须包含 --json 参数，确保结构化输出
6. 一次性追问：缺失多个字段时，一次性列出所有缺失项，不逐个追问
7. 不调用外部服务：本 Skill 只与本地 xiwu CLI 交互，不调用电商或比价 API