{/* This page is auto-generated from the skill's SKILL.md by website/scripts/generate-skill-docs.py. Edit the source SKILL.md, not this page. */}

Property Listings

以桌面卡片形式呈现房产和租屋挂牌。

Skill 元数据

参考：完整 SKILL.md

Property Listings Skill

在 Hermes 桌面对话记录中，把调研过的房产以可浏览的卡片呈现。 这是一个呈现配方，不是挂牌搜索服务，也不是投资估值。

使用时机

• 呈现房产或租屋搜索结果、对比候选清单、或重新排序房产。
• 跟进已经展示过的某套房：继续用卡片，让候选清单保持可比。
• 在桌面应用之外，改用带源链接的普通 Markdown；其他客户端不必渲染 listing 围栏。

前提条件

• 一个 Hermes 桌面会话用于原生卡片；后端可以是本地或远程。
• 房产细节由用户提供，或通过 web_search、web_extract 或本会话可用的浏览器工具核实。
• 卡片格式无需额外 API key 或依赖。

运行方式

通过 Skills 目录安装此可选 skill，或用 terminal：

hermes skills install official/productivity/property-listings

呈现挂牌时用 skill_view(name="property-listings") 加载它。安装不会回溯更新正在运行对话的 skill 索引；要自动发现就新开一个对话，或现在显式加载已安装的 skill。

快速参考

输出一个语言为 listing 的围栏代码块，其内容是合法 JSON。 用单个对象、对象数组，或 { "listings": [...] } 做对比。

流程

1. 收集地址、价格、规格、照片和规范详情 URL。区分已核实事实与未知；不要编造价格、配套或照片 URL。
2. 把同一套房的各门户镜像去重成一张卡，保留有用的源链接。源日期和可用性注意事项写在周围 prose 里。
3. 为呈现的每套房输出 listing 围栏，包括跟进和重排。facts 保持简短，未决顾虑放进 catches。
4. 发送前检查 JSON。下面这个虚构格式示例说明了所有字段；把它的值和示例 URL 替换为已核实的挂牌数据：

{
  "address": "12 Example Lane",
  "price": "$2,400/mo",
  "beds": 3,
  "baths": 2.5,
  "size": "1,600 sqft",
  "note": "Fits the requested space and budget.",
  "facts": ["12-month lease", "Covered parking"],
  "catches": ["Verify pet policy and total move-in fees"],
  "images": ["https://example.com/property/front.jpg", "https://example.com/property/kitchen.jpg"],
  "links": [{"label": "Listing details", "url": "https://example.com/property/12"}]
}

常见陷阱

• 卡片是从收集来的数据编写的，不是从挂牌 URL 或嵌入的门户页面抓取的。
• 一张稀疏卡片只需一个地址。省略未知字段，而不是拿猜测填满。
• 用直连远程图片 URL，不要用本地路径、data URL 或搜索结果页。过期或被墙的图片会从图廊消失；文字和链接仍然重要。
• 一个围栏最多 24 套房、每套房 40 张图，facts、catches、links 各 12 条。渲染器会把文本字段截断到 400 字符。
• 畸形 JSON 或没有身份的卡片会回退成普通代码块。一张合法卡片并不能证明底层挂牌是最新或准确的。

验证

• 每套呈现的房都有地址和已核实源链接；未知处明确标注。
• 桌面把地址、价格、规格、facts、catches、links 渲染成原生卡片。
• 照片组成图廊；选中照片打开灯箱。三张及以上照片用主图+辅助帧的马赛克；其余照片在那里仍可浏览。
• 如果卡片渲染失败，校验围栏语言和 JSON，然后保留一份带相同 facts 和链接的可读 Markdown 回退。