用途:Skill Lifeguard 是一个用于提升技能可靠性的技能,面向真实智能体工作场景,让已有或新建技能具备自我维护能力。它侧重可靠性契约,与 skill-audit(技能库适配)和 skill-creator(技能编写)配合使用,先由本技能定义可靠契约,再用二者处理库适配与创作。
主要能力:提出“可靠技能契约”,要求高价值工作流技能包含五个要素,或记录为何有意延后。五要素分别为:明确的反例(点名禁止的行为及具体替代方案)、验证检查点(在关键阶段后而非仅在末尾做通过/失败检查)、机器可检查的完成条件(来自当前会话的命令、断言、产物或状态查询)、重放或冒烟钩子(可重跑或抽样工作流的小方法,并形成日志到补丁的循环)、漂移信号检测(技能陈旧、触发不足、触发过度或产生虚假成功的可观察迹象)。
使用方式:先搜索再创建或移动技能文件;阅读目标技能及其附近定义预期工作流的文档;对技能成熟度分类为 manual(仍需人工验证)、skill(已人工验证并打包为可复用指令)、automation(反复可靠且足够安全,可用于计划任务或钩子驱动);将五个契约要素评分为 present、partial、missing 或 deferred;把补丁打到最小持久位置:SKILL.md 负责路由与边界,references/ 放长示例,scripts/ 放确定性检查,assets/ 或 templates/ 放可复用报告形态;运行仓库校验及技能专属冒烟检查。需要示例契约措辞时读 references/examples.md,起草可复用段落时用 assets/reliable-contract-template.md。
适用场景:技能脆弱、漂移、反复失败,或需要可靠技能契约时触发,例如出现 skill lifeguard、reliable skill 等短语。审计时先给出发现,按 reliable_skill_contract 结构输出目标、成熟度、评分(含五个要素)、阻塞缺口、补丁计划与验证。编辑时保持补丁范围仅限缺失的契约要素,除非可靠性缺口要求,否则不重写技能的领域行为。
限制与操作契约:可直接审计技能文件、起草契约缺口、修补本地技能指令并运行本地校验;发布技能、安装到用户运行时目录、删除用户文件、更改密钥,或将 manual 工作流提升为计划自动化前需上报。拒绝缺乏新鲜验证、重放钩子或漂移信号的可靠性声明。Spellbook 技能可运行 python3 ./scripts/validate_skills.py --check 与 python3 ./scripts/audit_skill_quality.py skill-name;技能自带脚本时还需运行相关语法检查或 fixture,缺少前置条件应上报而非标记契约完成。注意:无通过/失败证据的清单不算检查点;仅警告的兜底可能掩盖缺失数据,输出不完整或误导时应显式失败;一次性人工成功不等于自动化成熟度。