SuperAPI AI 工具集

light

部署与运维

查看项目

更新于 10-20 17:16

技能介绍

Light 是一个面向系统可见性建设的技能,主要用于为流程、代码库或系统中存在的“盲区”添加可观测性、日志、文档或解释。资料将其描述为一种混合型技能,并标记为可立即交付。它关注的是在原本没有可见性的地方创造可见性,而不是探测隐藏内容。

主要用途与适用场景包括:某个流程运行时没有日志、指标或内部状态可见性;代码库或系统存在缺少文档、阻碍理解的区域;需要对不透明的对象补充解释、注释或可观测性;以及通过 Home Assistant 使用自然语言控制已连接的智能灯。

使用前需要满足前置条件:Hermes 运行环境中可用的环境变量 HA_URL 与 HA_TOKEN,主要凭据为 HA_TOKEN,PATH 中需要存在 curl。设置时应确认这些环境变量在活动的 Hermes 运行时内可用,而不仅存在于 shell 配置文件中;同时在依赖相关二进制之前确认其可在 PATH 中解析。若该技能可能触发告警、解锁或接触实时集成,应优先选择非生产或低风险目标。

执行流程要求先复述目标、成功条件与不可触碰边界,再给出 3 到 6 个步骤,说明暗区、所选产物、产物应存放的位置、读取方式以及相关的新鲜度限定。必要时可包含精确的产物示例,例如结构化日志行。最终结果需要以交付物形式打包,并明确标注置信度、假设与未解决风险。交付物应列出创建的具体产物、操作人员检查的位置,以及仍然保持不可见的部分。针对日志任务需明确说明结构化日志行;针对文档任务需明确说明 runbook 笔记、README 段落或 stdout 行;针对状态任务需明确说明状态说明、心跳或指标。

该技能附有明确的护栏要求:保留戏剧化框架的同时说明具体机制;强调 Light 只照亮而不评判;观测必须限定在授权范围内;需包含关于误报、漏报以及时间戳、最后可见或隐私的说明;拒绝过度埋点、未经请求的重构、隐蔽监控和根因过度归因。验证时应检查结果是否包含承诺的全部交付物,确认事实、假设与推断是否清晰分离,区分具体行动与框架性描述,并在信任该流程前检查活动 Hermes 运行时中的环境变量与二进制。示例调用为:/light illuminate this area with the minimum logging, docs, or observability it needs。