SuperAPI AI 工具集

goal-instruction-writer

智能体与模型

查看项目

更新于 10-25 02:02

技能介绍

Goal Instruction Writer 是一个用于设计与审计智能体 Goal 指令的技能,把模糊请求转成可直接运行的指令,使智能体无需猜测成功、进展或停止的含义,同时保留用户意图、语言、权限边界与请求范围。它只设计指令契约,不执行底层任务;运行时访问、权限、持久化与外部审批由宿主智能体和用户提供。

用途与模式

适用于多阶段智能体任务的预览、起草、精炼或审计,也适用于验收证据、范围、验证节奏、漂移恢复或外部等待不明确的情形。普通一次性提示不需要该技能;若请求主要是操作宿主原生 Goal 循环,应改用 goal-loop。模式包括:Draft(从粗略请求构建 Goal)、Refine(保留现有 Goal 并补齐目标、证据、循环或终止字段)、Audit(识别歧义、无界重复、不可验证标准及不安全或未授权的转换,并提出最小修复)、Convert(把清单、工单或项目简述转为 Goal 且不扩大范围)、Preview(在写出最终 Goal 前展示具体循环、分支、漂移门与停止条件,不输出可执行 Goal,也不执行外部工作)。未说明模式时从输入推断;只询问会改变目标、权限、验收证据或合法终态的问题,否则说明假设并继续。

预览优先

当用户要求“先看循环”“preview”“先设计流程”等时使用预览优先;多阶段、成本高、不可逆或不确定性大的工作也优先预览。短小可逆任务可直接起草。预览是设计检查点而非执行批准:说明暂定结果、基线与假设;以具体状态转换展示循环,包括首个工作单元、成功与失败分支、进展证据、漂移检查、阶段门与合法停止状态,区分迭代检查与阶段或交付检查,包括证据复用与昂贵检查的边界;列出可能改变循环或范围的决策,反馈、采纳、试点、发布或验证类工作需包含证据阈值、计入内容与反馈窗口;最后明确交接,等待用户确认或修改循环后再生成最终 Goal。用户确认后,将已接受的预览带入最终 Goal,不悄悄改变循环、范围或终态规则。

三层契约

第一层目标:用一句可观察终态描述成果,并具体化基线(当前存在什么、以哪个版本或事实为准)、范围(可改与冻结内容)、验收标准(与证据绑定的可观察检查,而非“继续努力”等行为)、依赖与权限(可用工具、访问、负责人决策与外部门)、交付物(交回的文件、决策、报告或消息)。反馈、采纳、试点、发布或验证类 Goal 需先定义反馈证据阈值:什么算反馈、入口点是否足够或至少 N 条非作者回复、时间窗或尝试窗口。每个 Goal 最好只有一个承重结果,拆分无关结果,用可衡量结果替换“改进”“处理”“完成”等模糊动词。

第二层循环:有界迭代并带可见进度信号——检查当前状态与最后持久游标;选择最小下一工作单元并指明目标标准、预期变化与范围理由;在允许范围与权限内行动;按验证策略对照相关标准验证并捕获证据;将结果分类为 ON_TARGET、SIDE_QUEST 或 DRIFTED 并应用漂移规则;记录变化、剩余差距、决策与下一游标。说明适合任务的迭代上限:时间盒、工具或 token 预算、最大尝试次数或有限工作单元列表。加入空操作规则:没有新信息不重复同一动作;重复失败后改变假设或带阻塞停止。外部依赖需记录未满足标准、下次检查时间或通知、截止时间;触发前继续独立工作或保留检查点让出。等待与确认依赖仍待定的到期检查不计入默认两次等效无进展阈值,但实际工具调用与耗时仍计入宿主限制。

验证策略:迭代检查选择足以覆盖受影响行为的最小检查,遇影响扩大、新失败、未决不确定性或必需门时扩大;阶段与交付检查在相关实现稳定后完成剩余回归、构建、集成与产物检查;证据复用需绑定被检源或产物、相关输入、依赖与环境,情况仍有效时沿用,区分复用证据与新跑检查;重跑前说明使结果失效的变更或新证据并选择受影响检查;昂贵检查给合适超时或尝试上限,超时即标准未验证并报告差距;所有标准有有效证据且交付完成即结束。

第三层终止:明确合法终态——Complete(全部验收标准已验证且交付物可用)、Blocked(有名称可验证的依赖、缺少权限或负责人决策阻碍下一有意义动作且无法无新输入解决,报告已做尝试、依赖与确切解除条件)、Paused(负责人明确要求暂停,保留游标且未经授权不恢复)、Timeboxed/Budgeted(未完成即达上限,报告已验证进展、剩余差距与最安全下一步)、Stopped(负责人取消或行动将超出授权,不得悄悄继续)、Realignment required(漂移检查失败,停止当前循环、保留检查点,重新锚定下一动作后再恢复,可用 GOAL REALIGNMENT REQUIRED 作为本地终态标签)。Blocked 仅在依赖有名称可验证、无新输入或权限无法解决、报告说明解除条件三者同时成立时成立;难度、缓慢、不确定、需求歧义、换个方法可解决的失败、可询问的偏好都不算阻塞。禁止“满意为止”“无限尝试”或仅凭努力声称成功;不得因工作变难或变有趣就更改目标或验收标准。

使用与输出

使用用户语言返回结果,除非另有格式要求,按此顺序:设计说明(一段话解释目标、循环、终止与漂移控制选择,列出假设或高价值开放问题);循环预览(仅预览模式,展示状态转换、分支、证据、漂移门、终态与未决决策,然后停止等待确认);可粘贴 Goal(起草、精炼或转换模式,用围栏块给出完整指令,含 Objective、Goal anchor、Baseline and scope、Acceptance criteria、Feedback evidence(如适用)、Verification strategy、Execution loop、Drift control、Limits and no-op rule、Termination、Reporting 各节);审计说明(精炼或审计时列出每个剩余歧义及最小修复)。可粘贴块必须作为指令可执行,而非讨论如何写指令。

限制

该技能只设计指令;执行、权限、持久化与调用来自宿主与用户。保存的下次检查时间不会创建调度器,宿主须提供计时器、事件或稍后授权调用及检查点访问。文档中的等待分支尚未经实时等待/恢复测试验证。起草或预览 Goal 本身不授权底层任务。资料未提供收费、价格与平台信息。