function_health

用途

function_health 技能用于通过 function-health CLI 从 Function Health 的 FHIR API 检索患者的实验室生物标志物历史记录和临床医生咨询笔记。

主要能力

该技能提供两类命令：

授权命令：

• function-health status
• function-health authorize-url
• function-health disconnect

数据命令：

• function-health observations [--count N] [--page N] [--all]
• function-health documents [--count N] [--page N] [--all]

数据命令返回 JSON FHIR Bundles。对于 observations，需汇总生物标志物名称、采集日期、数值、参考范围以及存在时的解释。对于 documents，需从结构化 JSON 内容中汇总临床医生笔记。HTML 附件载荷在 v0 中会被剥离，并以 omitted_reason/size_bytes 元数据形式报告，而不会持久化到磁盘。

FHIR 读取保留原始时间戳，并为 observation、document、attachment、resource-update 和 clinical period 时间添加语义化的 UTC 和用户本地时间形式。仅含日期的临床值保持为日期。

使用方式

Function Health 是 OAuth 支持的技能。在任何 Function Health API 使用之前：

1. 运行 function-health status。
2. 如果状态不是 connected，先完成链接流程。
3. 运行 function-health authorize-url。当 connect_url 存在时，将 <connect_url> 替换为返回的 URL，并仅分享此 Markdown 链接：[Connect Function Health](<connect_url>)；不要单独粘贴原始 URL。
4. 回调完成后，再次运行 function-health status，仅在状态为 connected 时继续。

凭证安全：凭证自动管理，不暴露给代理。绝不打印 client_secret、access_token 或 refresh_token。

操作规则：

• 在任何数据命令之前始终运行 function-health status。
• 绝不陈述未在命令完成输出中逐字出现的具体临床值——生物标志物结果、参考范围、解释或日期。如果调用为空、内容被省略或失败，遵循“无真实数据 → 绝不编造”：说明数据不可用并提供下一步。绝不用看似合理的数值填补空白。这是最高优先级的安全规则。
• 在跨供应商比较生物标志物时，优先使用 LOINC 代码（http://loinc.org）进行标准化。
• 不要将解释（Normal/Abnormal）视为医疗建议；将其作为信息呈现并鼓励临床随访。
• 当用户要求趋势或纵向分析时，使用 --all 分页获取完整历史。

适用场景

适用于需要从 Function Health 平台获取患者实验室检测结果和临床笔记的场景，例如查看生物标志物历史、汇总临床医生笔记、进行纵向趋势分析等。

限制

• 无真实数据时绝不编造（最高优先级安全规则）：工具调用未返回真实记录时，绝不发明医疗事实——生物标志物数值、参考范围、解释、日期或临床笔记内容。
• 空结果：调用完成但 Bundle 无匹配条目时，应说明“我没有看到该项目的任何实验室结果/临床笔记。它们可能尚未出现在您的 Function Health 账户中。”
• 内容被省略：文档载荷被剥离（仅有 omitted_reason/size_bytes，无结构化笔记文本）时，报告笔记内容无法检索（例如 v0 中 HTML 附件被剥离）；不要推断或总结笔记“可能”说了什么。
• 失败/错误：工具报错、非零退出或未连接时，报告调用失败并建议重试或重新连接。不要凭记忆或假设回答临床问题。
• 数据稀疏时，承认缺口而非填补——不要从单个数据点外推趋势或发明缺失的生物标志物。
• HTML 附件载荷在 v0 中会被剥离，不会持久化到磁盘。