用途
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 的提示词、任务交接或生成产物时参照执行。调用方需提供产物类型及产物专属模板或输入契约。使用者在发送提示词或产物前,应逐项核对交接清单和生成产物清单。
适用场景
- 编写或审查面向下游智能体的提示词
- 智能体之间的任务交接
- 生成需要被其他智能体消费的产物(文档、任务列表、测试骨架等)
限制
资料未提供该技能的具体安装方式、平台支持、收费模式或价格信息。