SuperAPI AI 工具集

llm-friendly-context

智能体与模型

查看项目

更新于 10-22 03:10

技能介绍

用途

LLM-Friendly Context 的目标是实现稳定的下游执行:让下一个智能体清楚知道该读什么、该做什么、什么算成功,以及哪些未决决策可能改变结果。

该技能管控面向 LLM 的输出内容的清晰度——包括提示词、任务交接和生成的产物。调用方提供产物类型以及任何产物专属的模板或输入契约;只包含其消费者用于决策、行动或验证的信息。当消费者依据已声明契约的字段名和值含义进行分支判断时,应使用这些字段名和值含义。

主要能力

核心规则

  • 使用正向、可执行的指令:说明下一个智能体应该做什么;将质量策略转化为正向标准。例如:"在文档化的兼容性用例中保留现有公共 API 行为。"仅当禁令保护不可逆边界或已交付契约时才保留禁令;此时需同时指明受保护的条件和允许的动作。
  • 把模糊指令具体化:用可观察的条件、路径、命令、模式、示例或决策规则替换主观术语。当以下术语把决策留给下一个智能体时,通常需要澄清:appropriate、proper、related、existing behavior、optional、as needed、if needed、per convention、unresolved alternatives、TBD、placeholder。
  • 明确输出形态:定义消费者使用的章节、字段、表格列、JSON 键或清单项。对于交接,仅当产出的产物路径和状态字段控制下一次转换时才包含它们。
  • 提供最小充分上下文:充分是指对所分配动作充分,而非完整背景——每个包含项都被该动作或它必须产出的结果所消费。包含该动作消费的目的、源产物、硬约束、已接受的决策和未决条件。优先使用具体文件路径和章节提示,而非宽泛的模块名。当引用能改变范围内决策、动作或验证结果时继续跟进;当下一个链接只是确认已决定的内容时停止。
  • 将复杂工作拆解为可验证步骤:将具有 3 个以上目标或顺序依赖的工作拆分为有序步骤。每个步骤需要一个检查点:什么证据证明它已完成。
  • 显式允许不确定性:在将其视为未决之前,先从治理产物和代表性仓库证据中解决缺失的操作细节。记录剩余不确定性及其对结果或证明的影响。在已确认边界内做出可逆的仓库本地选择,并保留所用证据。将阻塞下一步的未知项作为确切的证据前提进行路由。仅当已确认结果、期望未来需求和非目标无法同时保持为真且需要用户选择时,或当不可逆外部动作需要授权时,才询问用户。当仅证明不可用时,完成不受影响的工作并准确报告无法验证的内容及原因。
  • 保持约束适度:只添加能减少歧义或保留真实需求的约束。当目标动作、上下文和成功标准已经清晰时,保持简单下游任务的轻量。将声明的大小期望——最小、几行、明确的行数或文件估计——视为整个已完成差异的一个预算,而非每个文件或每个步骤。当工作无法满足时,报告超支及原因,而非默默超出。

重写模式

在将提示词、交接或产物视为完成之前,使用以下重写:

模糊形式 重写为
optional 用作未决选择 Required、omitted,或仅在命名条件下 required
下一个智能体必须在多个备选方案中选择 已选选项,或确定性决策规则
as needed / if needed 触发条件和所需动作
per convention 要遵循的文件、函数、测试或文档化约定
related files 具体路径、glob 或搜索提示
existing behavior 要保留的可观察行为、源文件、测试、API 响应或 UI 状态
placeholder 确切的临时值/行为、允许的依赖和验证期望
TBD 用作必需信息的占位符 它能改变的决策和确切的证据前提;当该项无下游影响时省略
appropriate / proper 可衡量的标准或清单

交接清单

在向另一个智能体发送提示词或产物之前,验证:

  • 目标动作是明确的
  • 必需的输入路径、源产物和决策相关事实已命名
  • 每个包含的上下文项都被目标动作或其必需结果所消费
  • 已接受的决策和约束只陈述一次,无替代措辞
  • 输出格式或预期状态字段已指定
  • 成功标准是可观察的
  • 模糊表达已被重写或标记为未决
  • 任何声明的大小期望都表示为整个已完成差异的一个预算,并命名了超支报告条件
  • 下一个智能体能够从提供的用途、来源、标准和证据完成其范围,或返回一个确切的证据前提或权威工作流停止

生成产物清单

在编写或最终确定生成的文档之前:

  • 每个需求、声明、任务、测试骨架或审查发现都有足够的源上下文,可追溯其存在原因
  • 每个可执行指令都命名目标、动作和预期结果
  • 验证步骤说明要运行或观察什么,以及什么结果证明成功
  • 如果产物派生自另一个产物,复制的决策在措辞和含义上保持一致
  • 任何声明的大小期望都表示为整个已完成产物的一个预算,并命名了超支报告条件
  • 缺失信息记录其影响的决策或证明;只有已确认的值边界选择或不可逆外部动作授权才是阻塞性升级

使用方式

该技能以规则和清单形式提供,供编写面向 LLM 的提示词、任务交接或生成产物时参照执行。调用方需提供产物类型及产物专属模板或输入契约。使用者在发送提示词或产物前,应逐项核对交接清单和生成产物清单。

适用场景

  • 编写或审查面向下游智能体的提示词
  • 智能体之间的任务交接
  • 生成需要被其他智能体消费的产物(文档、任务列表、测试骨架等)

限制

资料未提供该技能的具体安装方式、平台支持、收费模式或价格信息。