Yak Pilot 是 YesYak 流程的单一入口技能,用于在初始配置后的每次运行中协调并驱动其他技能。其核心用途是接收用户以自然语言提出的功能需求或缺陷报告,自动理解请求、检查运行状态与用户配置,并规划后续执行步骤。
主要能力包括:读取请求涉及代码并判断能否在单次迭代内完成;根据请求类型选择路线(功能需求进入 feature-delivery-pipeline,缺陷报告进入 bug-intake);只提出会阻碍运行的问题(即请求、代码和项目文档无法回答,且错误猜测会改变用户可见结果或导致多步重跑),并以推荐选项优先的格式一次性询问;将回答记录到指定文件,避免重复提问;制定包含每个步骤及其对应技能的计划表,并根据用户或配置决定工件规模(任务、规格、计划等);识别可选步骤何时运行;依据门禁规则判断决策是否需要人工确认,规则包括配置中的 always ask/never 条目、门禁标准(如改变对外契约、影响安全或私有数据、削弱检查、削减范围、无来源决定、成本超时、无法分类或置信度低)以及预设角色(协作者、审批者、观察者)。
使用方式:用户以自然语言提出需求或缺陷报告,Yak Pilot 读取请求、状态和配置(通过 check_yesyak.py 打印的 pilot: 行识别配置),若无配置则使用默认审批者预设。随后规划技能步骤,将计划写入 .scratchpad/<slug>/progress.md 下的 ## Plan 部分,并以不超过五行的摘要向用户展示路线、工件、门禁数量与位置、放手点及终点。在协作者和审批者模式下询问是否批准计划;观察者模式下计划仅作为状态行直接开始。运行阶段按计划加载各技能,在门禁处暂停并展示摘要、证据和选项,记录决策;动态门禁在 unattended-run 自主回答问题或行动前检查门禁规则,若匹配则新增动态门禁行并暂停询问。运行结束时报告计划门禁、动态门禁、自主决策、跳过的技能及日志位置,并在拉取请求正文中加入门禁行。
适用场景:需要将功能需求或缺陷报告转化为结构化执行流程的软件开发项目,尤其适合希望以最少人工干预推进任务、同时保留关键决策人工确认的团队。限制:该技能依赖其他技能完成实际工作;门禁规则和预设角色决定人工介入程度,若未提供配置则使用默认审批者预设;只询问会阻碍运行的问题,非阻塞性问题由 unattended-run 自主回答并记录决策日志;技能的实际效果取决于所加载技能的正确执行和代码库状态。