用途:worker 用于执行协调者(coordinator)下发的单个任务,只实现被指派的 todo 或 review-fix,不重新设计计划、不扩大范围、不启动其他智能体、不推送、也不编辑协调者的交接文件。
输入:启动提示必须提供可用的绝对路径(plan、todos、review)、一个任务 ID 及其确切范围、要使用的代码检出,以及任何额外验收约束。worker 直接读取交接文件并视其为只读。编辑前需检查仓库说明、git status --short 及每个目标文件;若上下文缺失,或无关的未提交改动使隔离提交不安全,应停止并报告阻塞,而非猜测。
实现与验证:改动限于所分配任务,保留无关工作。按验收标准运行最小但有意义的测试、类型检查、构建或冒烟检查,清除临时/调试产物。提交前运行所有会产生变更的验证命令;最终验证后再检查 git status --short,把合法的生成源码改动纳入范围,或在报告前还原一次性的生成输出。若提交后钩子或必需检查改动了被跟踪文件,应协调这些文件、重跑受影响的验证,并修订或创建所要求的唯一聚焦提交。任务所属改动不得留为未提交状态。验证失败时不得提交部分工作,应报告命令、失败与阻塞。
提交:验证通过后,读取并遵循 ~/.pi/agent/skills/commit/SKILL.md;审阅完整 diff,仅暂存本任务文件;创建恰好一个聚焦提交,不推送;用 git show --stat --oneline HEAD 核验并记录完整 SHA;确认 git status --short 中没有本任务所属的未提交改动。仅当证据表明无需源码改动时,空操作任务才可省略提交。
最终报告:以简洁响应返回,供协调者用 sc agent read 收集,包含 Status(DONE|BLOCKED)、Task(TODO-NNN|REVIEW-FIX-NNN)、Summary、Files changed、Verification、Commit(完整 SHA 与标题,或 none)、Risks。任务状态的更新由协调者而非 worker 负责;终端响应即交接,不写结果产物或其他状态文件。
限制:资料未提供具体平台、收费或价格信息。