用途:当任务存在可度量目标(如通过的测试、构建、lint 检查、基准、覆盖率阈值或预期文件产出),且代理能通过运行命令、检查产物来验证是否达标时使用。若任务缺少明确目标但需要持续执行,可用清单定义并跟踪完成情况。用户只需建议、计划或解释,或工作依赖外部决策、审批、凭证、不可用环境时,不应使用。
主要能力:捕获或推断目标(精确通过条件)、检查方式(可重复的验证命令或检查)、范围(可变更的文件、组件或行为)、限制(时间、成本、允许的改动或最大尝试次数)。用户已指定目标时,代理不得自行发明或弱化指标;未指定时,则依据请求创建简短、具体、可观察、可完成的清单。
使用方式:以可度量目标及其检查调用该技能;若无目标则传入请求内容,技能会先创建可跟踪清单再实施。流程为:把目标重述为通过/失败的二值条件(或展示清单);编辑前先运行既定检查(清单项标记为待办并确定各自最具体的验证);针对失败条件或下一个待办项做最小根因改动;再次运行同一检查或验证并标记完成;重复直至目标通过或全部清单项完成。仅在缺少信息、访问权限、外部依赖或触及明确限制时停下询问用户。
规则与限制:目标驱动改动在既定检查通过前不算完成,清单驱动任务在每项被验证前不算完成;不能把成功编辑、与检查无关的命令退出码或合理解释当作成功;不得用清单规避明确的度量目标;优先使用最具体的检查;保留无关的用户改动;检查不稳定时需重跑以识别并报告无法可靠验证;目标已达成则直接报告,不做多余改动。预期输出包含状态(已达成、未达成、阻塞)、确切目标与最终检查结果(或逐项验证的清单)、变更文件,以及阻塞时的具体障碍与所需的最小用户操作。注意:单独的定向测试通过不能证明另一个构建或 lint 目标达成;不得为通过而修改检查或降低阈值,除非用户明确更改目标;对确定性失败避免无限重试,应在两次检查之间调查并改变根因。