gm-finish 是面向 PRD 驱动工作流的收尾技能,核心目标让开放 PRD 行数归零,每次切片对应一次工作流运行。
用途与流程:先做清理,把仅含标题、缺少正文、验收、见证或 blocked_by 的行通过 prd-resolve 关闭,并将 witness_evidence 设为 superseded: <原因>,使链式 .gm/prd-log.jsonl 记录原因;不移动文件、不写索引,每个基础行只保留一个阻塞项,其余关闭。随后进入切片:每轮最多取 60 条本周期未尝试的开放基础行,单次运行不超过 150 个代理,存活代理数不超过 gm_processor_capacity(此处为 8),超出容量的代理只会排队并等待 spool;只有当两个切片存活代理合计不超过容量时才可并行。每轮切片前清理 .gm/exec-spool/out/*.json 中超过 1 小时的响应文件,并在切片收据中记录清理前后的文件数量。逐行通过 Skill(skill="gm-orient", args="row=<id>; session=<SID>") 加载六阶段链;若子代理因连接错误停止,同一行最多重启 3 次。行以见证派发 ID 标记为已解决,或以受阻结束;只有在 gm-eliminate 对每个未知项执行实时检查并记录派发 ID 后才提交阻塞项,所有者决策、仅 CI 构建与单向门是仅有的例外。每轮切片后按显式路径提交 .gm/prd-log.jsonl 与归档,推送到完整 sha 并读取 ci-status,同一轮内解决合并冲突。根据计数决定下一轮切片;当待处理为 0,或某轮未解决任何行且剩余行全为所有者决策或仅 CI 构建时停止,并按 ID 报告这些行。
执行原则:技能要求每次运行以完成所请求工作为目标,中途停止视为不完整。遇到检查失败、工具或服务故障、输入缺失、网络或环境故障等阻塞时,应在同一次运行内修复:在有界或可恢复路径上重试、改用替代路径达成同一结果、从源头修复故障,然后继续剩余工作。只有当工作完成,或所有路径均已尝试仍受阻时才停止,并报告受阻步骤、尝试过的路径与各自的证据。
适用场景与限制:适用于已有 PRD 行队列、需要按容量有界推进并逐轮发布结果的收尾任务。资料未提供安装命令、收费、平台支持范围或具体效果数据,暂未提供。