SuperAPI AI 工具集

llm-friendly-context

智能体与模型

查看项目

更新于 10-16 09:27

技能介绍

用途:当编写或修订任何将由其他智能体执行或评判的内容时使用,包括提示词、交接材料、规划产物、评审发现、完成报告、生成的指令、测试骨架注释、工作计划和任务文件。目标是保证下游执行稳定:下一个智能体应知道目标动作、必需输入、已接受的决策、可观察的成功标准,以及需要升级处理的条件。

主要能力与规则:使用正向、可执行的指令,直接说明下一个智能体应执行的动作;把质量方针转化为可观察的验收标准。把模糊指令具体化,用可观察条件、路径、命令、模式、示例或决策规则替换主观表述;通常需要先澄清的措辞包括 appropriate、proper、related、existing behavior、optional、as needed、if needed、per convention、未定备选、TBD、placeholder。规定输出形态,定义必需章节、字段、表格列、JSON 键、检查项或状态值;交接时写明产出物路径和调用方必须检查的确切状态字段。提供必要上下文,包含目的、来源产物、硬性约束、已接受决策与未决条件,优先给出具体文件路径和章节提示而非宽泛模块名。把复杂工作拆解为可验证步骤,3 个以上目标或存在顺序依赖时拆成有序步骤,每步都要有证明完成的检查点证据。显式允许不确定性:若来源缺失、矛盾或无法核实,说明不确定性及所需升级;把未知的业务、产品、安全、兼容性或契约决策记录为阻塞性未决项,并注明解决所需的输入。约束要与风险相称,只保留减少歧义或维护真实需求的约束;当下游任务的目标动作、上下文与成功标准已明确时保持轻量。

改写模式:将「optional」改写为必需、省略或仅在某具名条件下必需;将多个备选改写为已选定项或确定性决策规则;将「as needed/if needed」改写为触发条件与所需动作;将「per convention」改写为要遵循的文件、函数、测试或成文约定;将「related files」改写为具体路径、glob 或搜索提示;将「existing behavior」改写为要保留的可观察行为、源文件、测试、API 响应或 UI 状态;将「placeholder」改写为确切的临时值或行为、允许的依赖与验证预期;将用于必需信息的「TBD」改写为带负责人、所需输入或升级条件的阻塞性未决项;将「appropriate/proper」改写为可度量标准或检查清单。

交接前检查:目标动作是否明确;必需输入路径与来源产物是否具名;已接受决策与约束是否用稳定措辞陈述一次;输出格式或预期状态字段是否规定;成功标准是否可观察;模糊表述是否已改写或标记为未决;下一个智能体能否通过明确选择、决策规则或阻塞性未决项完成其范围。生成产物前检查:每条需求、主张、任务、测试骨架或评审发现是否有足够来源上下文可追溯其存在原因;每条可执行指令是否写明目标、动作与预期结果;验证步骤是否说明运行或观察什么、什么结果证明成功;派生产物是否以与来源一致的措辞和含义保留所复制的决策;阻塞性缺失信息是否记录缺失输入与升级条件。

限制:本技能为指令编写规范,不提供自动校验工具或运行时执行;具体命令、路径与字段需按实际项目提供,资料中未给出具体示例代码。