用途与定位 该技能面向“仅展示”(Display-Only)的技能建议能力,作用是记录机制与契约,而不提供任何实际行为。它不发布调用方、不注册命令、不添加钩子、不修改设置,也不保证建议界面一定存在。
前置门槛 能力受 workflow.jev.enabled 控制,出厂默认为关闭。调用方须先确认门槛。门槛关闭时,不构造请求、不发起网络调用、不产生信号;缺席的信号是 NO SIGNAL,等同于“我们没有询问”,不是否定回答,也不构成改变路线的理由。开启状态有三个就绪面:门槛键本身、按约定引用的凭据文件(~/.moai/.env.typesafe,由凭据加载器读取,不得内联或复制进设置)、以及 doctor 就绪检查(仅 TCP 探测,三行输出门槛、凭据与可达性,不发送任何判断请求)。无法确认三者时,按门槛关闭处理。
建议的含义 建议是供人阅读的信号:带标签的模型回答,指出某技能可能值得加载,并附带置信度,除此之外不做任何事。它不是选择(选择器保留选择权,建议不会翻转它);不是自动加载(不会因建议而加载、附加或注入技能内容);不是判断(不关闭卡片、不批准合并、不修改队列等难以撤销的动作仍归人);不是代码路径输入(没有分支依赖该回答,人阅读是唯一消费方式)。
被否决的机制 文档记录了两种被评估后否决的机制:一是隐藏列表并直接注入选定的 SKILL.md 正文,这会破坏仅展示链路,且直接内容注入正是契约禁止的自动加载;二是环境函数钩子在每个提示上评估建议,这会按提示商业化模型调用、割裂模板分发,并依赖可能变化的早期实验面,未采用。
操作清单(仅在存在调用方时适用) 包括:记录每次决策,并每会话一次公告建议日志已启用(每会话一行,而非每次调用都播报);过滤非任务来源(操作者手动输入的提示不是任务事件);过滤禁用模型调用的技能(disable-model-invocation 在调用前过滤);按会话缓存技能名册与正文;防止重复注入(上下文中已有的技能不再建议);名称规范化(显示名与目录 id 是同一技能的不同拼写,去重、记录、展示前统一到规范形式)。
边界 问题设计(在代码中计算问题、始终允许无匹配答案、保持状态精简、表述两种极性)属于另一个参考技能,本文不重述;测量基线亦归其他轨道。该技能不是能力、不是裁决、不是可用性承诺;若调用方从未在别处构建,缺席的建议只是 NO SIGNAL。