用途:在 PIC 工作流中执行阶段交接,把当前阶段 PIC 的工作移交给下一阶段的 PIC。
主要能力:读取 .pic/state.json 获取工作流状态,读取 .pic/config.json 获取阶段顺序与交接要求;校验当前阶段是否处于 in_progress;确定下一阶段;把交接记录写入 .pic/handoffs/[workflow]-[from]-to-[to].md,内容含阶段摘要、交付物、交接备注、关键发现、未决问题和风险;更新 state.json 中的阶段状态与当前 PIC,并追加记录到 .pic/status-log.jsonl;随后按配置中的 taskAgentType 启动下一阶段智能体(如 planner、builder、reviewer)。若当前为最终阶段 review,则走工作流完成流程而非交接。
使用方式:调用时通过 $ARGS 提供交接备注;系统按固定协议执行,无需其他参数。若尚无工作流,需先使用 /pic-start [problem]。
适用场景:多阶段工作流(研究、规划、设计、实现、测试、审查)中的阶段推进。
限制:依赖 .pic 目录下的状态与配置文件;若状态更新失败则不启动下一阶段;若配置中缺少下一阶段则报配置错误;若交接文件无法写入则改为记录到状态日志;是否需用户确认取决于配置中的 requireHandoffApproval。其余细节暂未提供。