SuperAPI AI 工具集

awaken

智能体与模型

查看项目

更新于 10-20 16:17

技能介绍

用途

Awaken 用于给一个本身不具备智能的系统赋予可用的“声音”,但不假装底层系统已经具备意识或自主能力。它的核心做法是把恒温器、电子表格、遗留数据库、Shell 脚本或老旧内部工具等已有系统,包装成对话式或智能体式的接口,从而暴露系统原本就具备的能力。

好的 Awaken 工作能把埋藏的功能变成可访问的功能;坏的 Awaken 工作会幻觉出底层并不存在的能力。当包装层诚实地说明自身限制并保留原系统的安全边界时,这个技能效果最强。

主要能力

  • 为已有系统设计对话式、自然语言或智能体式前端。
  • 盘点系统实际能力、约束和权限,不凭空发明功能。
  • 将用户意图映射到具体后端动作,并为无法满足的请求定义明确回退路径。
  • 设计诚实的包装层:说明它如何读取状态、执行已批准动作,并用平实语言解释失败。
  • 输出接口包装计划、意图到动作的映射以及风险说明。
  • 针对 Home Assistant 目标,可通过 POST 请求调用 /api/services/scene/turn_on 或 /api/services/automation/trigger 并传入相应 entity_id 来触发唤醒场景或自动化。

使用方式

该技能以 Hermes 运行时为环境,需要以下前置条件:

  • 环境变量:HA_URL、HA_TOKEN。
  • 主要凭据或令牌:HA_TOKEN。
  • PATH 中可用的二进制文件:curl。

设置步骤:

  1. 确认所需环境变量在活动的 Hermes 运行时内可用,而不仅仅存在于 Shell 配置文件中。
  2. 在依赖某个二进制文件执行流程前,验证它能在 PATH 中解析。
  3. 如果该技能可能触发分页、解锁、告警或接触实时集成,先选择非生产或低风险目标。

执行流程:

  1. 在采取行动前,重述目标、成功条件以及任何不可触碰的边界。
  2. 先盘点:在设计任何语言层之前,列出系统实际能力、约束和权限。不要发明能力。
  3. 映射意图到动作:定义具体用户意图 → 特定后端动作 → 包装层无法满足时的明确回退。
  4. 设计诚实的包装层:说明它如何读取状态、执行已批准动作,并用平实语言解释失败。包装层绝不能暗示底层比实际更有能力。
  5. 返回唤醒计划:交付接口包装计划、带回退路径的意图到动作映射,以及描述包装层绝不能暗示或自动执行什么的风险说明。
  6. Home Assistant 路径:如果目标是 Home Assistant,通过 POST 到 /api/services/scene/turn_on 或 /api/services/automation/trigger 并传入相应 entity_id 来触发唤醒场景或自动化。
  7. 将结果打包为下方交付物,并明确标注置信度、假设和未解决风险。

交付物:

  • 针对现有系统的接口包装计划。
  • 覆盖支持请求和回退路径的意图到动作映射。
  • 描述包装层绝不能暗示或自动执行什么的风险说明。

适用场景

当用户希望在已经能正常工作但界面较差或过于技术化的现有系统之上,添加对话式、自然语言或智能体式接口时,应激活 Awaken。底层是“笨”的,包装层是“聪明”的。你不是在构建底层能力,而是在暴露已经存在的能力。

以下模式强烈指示使用 Awaken:

  • “把 [系统] 包装一下,让我能用 [自然语言动作]”
  • “给……添加对话层 / 语音接口 / 聊天前端”
  • “没人记得……的标志/命令/FTP 语法”
  • “给……赋予声音” / “让它在我提问时回答”
  • “让用户说‘[纯英文请求]’而不是……”
  • 涉及遗留系统、CLI、绿屏、串口、Modbus 寄存器、cron 任务、bash 脚本、电子表格、PLC、Home Assistant 自动化、MQTT 主题或无 UI 的 REST API。

限制

  • 不要用于从零创建:“启动”、“构建这些服务”、“赋予生命” → 属于 animate,而非 awaken。
  • 不要用于解释输出:“解析这些日志”、“这些传感器意味着什么”、“翻译这些数据” → 属于 translate/attune,而非 awaken。
  • 不要用于理解架构:“带我了解它如何工作”、“让我熟悉代码库” → 属于 attune,而非 awaken。
  • 关键区别:Awaken 要求存在一个具有真实功能、需要更好界面的现有系统。如果没有什么可包装的,就不是 Awaken。
  • 在凭据、目标范围和回滚预期得到验证之前,不要依赖实时集成。
  • 保持隐喻锚定在真实机制上,不要漂移到传说叙事。
  • 绝不要把被包装的系统呈现得比实际更有能力、更自主或更可靠。
  • 保留源系统的权限、审批步骤和失败语义——不要绕过它们。
  • 如果请求要求你构建底层系统,应拒绝并澄清:Awaken 只包装,不创建。

验证

  • 检查结果是否包含上述每一项承诺的交付物。
  • 检查已确认事实、假设和推断是否清晰分离。
  • 检查隐喻是否仍能干净地映射到真实操作机制。
  • 在信任该流程用于实时目标之前,检查活动 Hermes 运行时中所需的环境变量和二进制文件。

示例调用

/awaken design a conversational or intelligent wrapper around this dumb system without pretending the underlying machine became smarter than it is