用途
one-shot-completion 是一个面向 AI 编码代理的行为规范技能,用于用户要求“一次性做完”“端到端修复”“直接给成品”或任务本身隐含交付物的场景。它解决的是代理容易停在第一个看似合理的结果、把中间状态当成交付的问题。
主要能力
- 先定验收标准:在行动前把目标转写为明确的验收标准,并补上合理用户会预期但未明说的隐含交付物。
- 需求账本:建立简短账本,记录请求产出、隐含产出、约束、失败条件及每项的证明方式,并据此执行。
- 完成前核验:要求用直接证据逐项验证;尽可能打开或运行实际交付物;检查受同一改动影响的相邻界面;移除可自动化的手工清理;明确标注仍未验证的标准。
- 区分活动与完成:指出“代码已写”“测试已加”“看起来对”只是中间状态,除非它们就是请求的结果。
- 识别常见失败模式:提醒代理不要只满足字面名词而漏掉安装、打包、入口点、文档、错误路径或验证,这些在用户要求“可直接使用”时都应视为隐含交付物。
- 仓库请求路由:对“建仓库”“放到 GitHub”“完成项目”等请求,转到 github-fleet-maintenance 及其仓库完成契约,涵盖真实 CI、适用的安全设置/扫描与 Dependabot 覆盖、文档、可用产物和发布清单交接;发布遵循现有授权,缺少批准时先准备具体发布内容并只标出该待办步骤,同时尊重明确的空仓库或原型范围。
使用方式
该技能以规则和契约形式描述工作流程,用户在提出“全部做完”类请求时触发,代理按需求账本执行并在收尾前逐项核验。资料未提供具体安装命令、调用接口或配置参数。
适用场景
适合需要端到端交付的编码任务、修复请求、项目完成请求,以及用户期望获得可直接使用成果的场景;也适合需要区分“做了”与“做完”的质量把关场景。
限制
资料未提供该技能的具体平台支持、性能数据、收费信息或与其他工具的集成细节;仓库类请求的具体执行依赖 github-fleet-maintenance 技能,其细节未在本资料中展开。