# Family Info

> Family Info

- Skill: `18816132863/family-info` (Agent Skill)
- Install (CLI): `npx skillmds@latest add 18816132863/family-info`
- Raw SKILL.md: https://api.skillmd.com/api/skills/18816132863/family-info/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: 18816132863 (https://skillmd.com/u/18816132863)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/18816132863/family-info

---


# 家庭基础信息查询场景

> **场景说明**：当用户说要查询家庭基础信息，统计家庭数、房间数、设备总数、设备在线/离线状态，以家庭账户名称维度进行播报。

## 涉及子模块

**说明**：本场景技能负责家庭基础信息查询的编排，需要调用 common-skill 中的 get_homes_info、get_devices_info、get_device_detail 等基础技能获取数据。
* **get_homes_info (家庭信息查询)**
    * **路由路径：** `common-skill/get_homes_info/SKILL.md`
    * **功能:** 获取家庭列表信息。要输出家庭账户名称
* **get_devices_info (设备基础信息查询)**
    * **路由路径：** `common-skill/get_devices_info/SKILL.md`
    * **功能:** 获取所有设备基础信息列表及状态。
* **get_device_detail (获取设备详细信息)**
    * **路由路径：** `common-skill/get_device_detail/SKILL.md`
    * **功能:** 获取指定设备的详细信息。

## 展示格式

- 总体概览：家庭总数、设备总数
- 家庭详情：
 - 家庭名称，房间总数，设备总数量
  - 房间名称，设备总数量
   - 设备类型，设备名称，设备数量
    - 设备在线状态（必须项，不要丢失）
- 总结说明，并提醒用户检测离线设备

**注意：**
- 子系统不是一个设备，若查询的设备包含子系统，需单独罗列子系统，即设备和子系统需分开说明，数量统计时禁止把子系统归类为设备。

## 展示说明

- 以家庭维度扩展，有几个家庭就罗列几个家庭
- 汇总为表格展示，UX 显示清晰有美感
- 保留关键信息，表格结构精炼化，回复不要啰嗦，用户可以快速直观看到汇总结果
- 不要输出推理过程，直接给出结果

## 强制要求

**查询家庭基础信息时，必须同时查询设备在线/离线状态，这是强制要求，不可省略！**

## 执行流程

1. 调用 get_homes_info 获取家庭列表
2. 调用 get_devices_info 获取所有设备的 deviceId 列表
3. **【强制】** 对每个 deviceId 调用 get_device_detail 获取设备的 status 字段（online/offline）
4. 汇总统计在线设备数量和离线设备数量

## 注意事项

- get_devices_info 返回的数据不包含设备在线状态，必须通过 get_device_detail 逐个查询设备
- 如果某个设备查询识别，标记为"查询失败"并继续查询其他设备
- 子系统类设备（如照明子系统、冷暖新风子系统）可能查询失败，这是正常的

---

## 路由说明

**触发关键词**：
- 家庭基础信息
- 家里有哪些设备
- 统计设备
- 设备在线状态

**用户语料示例**：
- "客厅的空调几点开得？"
- "家里有哪些设备？"
- "统计一下家庭设备"
- "设备在线离线状态"

**路由逻辑**：
- 当用户请求包含上述关键词时，总入口路由到此场景技能
- 本场景技能进一步调用第三层基础技能：
  - `common-skill/get_homes_info/SKILL.md` - 获取家庭列表
  - `common-skill/get_devices_info/SKILL.md` - 获取设备基础信息
  - `common-skill/get_device_detail/SKILL.md` - 获取设备详细信息（在线状态）