Skill 交接条件
Skill 交接条件是一组让别人也敢用 Skill 的最低边界说明:需要哪些输入、哪些信息只是推断、什么时候必须停止、停下后交给谁确认,以及是否已有失败记录、版本记录和相近任务复测结果。
简介
一个 Skill “自己能用”并不等于“别人能用”。作者熟悉任务背景、知道哪些输入缺失可以脑补、知道输出哪里只是推断、知道什么时候应该停下来;但如果这些判断没有写进 Skill,接手者看到的只是一份看似完整的说明书。交接条件的目的,就是把这些隐藏判断外化为可执行边界。
《从自己能用到别人敢用:Skill 的验证、版本与交接》指出,真正阻碍 Skill 交接的不是说明书不够长,而是关键判断从来没有写进去。一个可交接 Skill 需要输入要求、事实标签、自查清单、失败兜底、版本证据和复测结果共同支撑。它不需要一开始证明“别人一定用得好”,但至少要证明“别人知道什么时候能用、怎么判断输出、出了问题该停在哪里”。
关键信息
- 适用对象:准备分享给同事、朋友、社群成员或团队 Agent 系统的 Skill。
- 核心问题:从“作者脑中有边界”升级为“文件中有边界”。
- 最低条件:输入边界、事实边界、停止边界、交还路径、版本与复测证据。
- 相关概念:Skill、Skill 版本记录、输出失败诊断树、事实标签、AI产品PRD、Agent安全护栏。
核心特性
1. 输入边界:哪些必须给,哪些不能给
交接时最危险的输入要求是“请提供业务背景”。这句话看似友好,实际过于宽泛,使用者不知道该给什么,AI 也不知道哪些信息缺失时不能继续。成熟 Skill 应把输入拆成三类:必须提供、可选提供、禁止或不应提供。
例如 PRD Skill 可能要求必须提供目标用户、业务目标、已确认规则、数据来源、上线范围和不做事项;可选提供竞品截图、历史 PRD 和评审意见;禁止提供未脱敏的敏感用户数据。缺失必须输入时,Skill 应先提问或停止,而不是继续生成完整文档。
2. 事实边界:哪些是已确认,哪些只是推断
AI 最容易让人放松警惕的一点,是把推断写得像事实。交接条件要求 Skill 在输出中显式标注信息状态,例如“已确认”“根据输入推断”“待确认”。如果输入没有明确写“系统支持短信通知”,输出就不能把它写成已确认能力,只能放入待确认项。
这个机制能保护接手者不被流畅文本误导。它也让复审更高效:使用者不需要逐字怀疑,而是优先检查被标为推断和待确认的高风险部分。
3. 停止边界:什么时候不能继续生成
可交接 Skill 不能只知道“怎么继续写”,还要知道“什么时候不能继续写”。停止条件可以包括:关键输入缺失、业务规则互相矛盾、涉及高风险合规/财务/法律判断、来源无法验证、输出会影响不可撤回操作、用户要求超出 Skill 职责。
停止不是保守,而是可靠。一个靠谱同事不会在不知道规则时假装知道;一个可交接 Skill 也应该把未知暴露出来,并把问题交还给合适的人确认。
4. 验证边界:自查不是“认真检查”,而是可执行清单
“请认真检查”不是一个可执行动作。交接条件要求把自查项写死,并且具体到输出里能找到证据。例如 PRD Skill 可以检查是否包含目标用户、关键流程、异常状态、不做事项、验收标准、数据口径和待确认问题;内容转写 Skill 可以检查字数、开头、平台语气、互动引导和禁用项。
自查清单的目的不是把责任交给 AI,而是让接手者知道“这份输出至少应该满足哪些硬性标准”。
5. 证据边界:版本记录和复测结果决定能否放心交接
说明书写得完整,不代表别人用起来稳定。更有价值的是 Skill 版本记录:这个 Skill 曾在哪些真实任务中失败,修改了哪条规则,用哪个相近任务复测,结果是消失、缓解还是无效。交接前如果能提供这些证据,接手者就能理解 Skill 的能力边界和历史可靠性。
不同素材中的观点
- 2026-07-08-woshipm-skill-validation-version-handoff:交接前至少要回答四个问题:这个 Skill 需要哪些输入、哪些输入缺失时不能继续;输出中哪些是已确认事实、哪些只是推断;出现哪些情况时必须停止;停下来后问题应该交还给谁或由谁确认。作者还指出,要证明别人也能正确使用,需要独立试用、失败记录和复测结果。
- 2026-07-19-woshipm-ai-output-failure-diagnosis:用具体规则补丁演示停止边界:当触达渠道、发送能力或用户授权未提供时,不得写入短信/邮件/站内信方案,须先列为待确认并说明影响章节。输出失败诊断树 还要求用相近任务复测这条停止规则是否仍被绕过,复测结果记为消失/缓解/无效/转移——把交接清单从“写了停止条件”推进到“停止条件被验证过”。
- 2026-07-07-woshipm-agent-safety-guardrails:Agent安全护栏 同样强调职责边界、风险分层、二次确认和转人工。Skill 交接条件是同一思想在“方法论文件”层的落地。
- 2026-07-08-woshipm-ai-coding-harness:Agent Harness 要求任务卡写清业务目标、范围边界、验收标准和回滚方式。Skill 交接条件也要求把输入、输出、停止和验证写成可执行边界。
实用信息
最小交接清单
## Skill 交接清单
### 输入要求
- 必须提供:
- 可选提供:
- 不应提供 / 需要脱敏:
- 缺失关键输入时:停止 / 追问 / 降级输出
### 输出事实标签
- 已确认:来自用户输入或可信资料
- 推断:基于上下文推理,需人工确认
- 待确认:缺资料或冲突信息
### 停止条件
- 哪些情况不能继续生成:
- 停止后交给谁确认:
### 自查清单
- 输出前必须检查:
- 不通过时如何处理:
### 版本证据
- 最近一次失败记录:
- 最近一次规则修改:
- 相近任务复测结果:使用建议
- 对外分享 Skill 前,先让一个不熟悉上下文的人独立试用一次。
- 试用失败时,不要立即重写全篇;把失败归入输入、事实、过程、输出、验证或停止条件中的一类。
- 每次交接前附上最近 1-3 条版本记录,让接手者知道这个 Skill 是怎么变稳定的。
- 对高风险任务,交接条件应优先强调停止和转人工,而不是强调自动完成。