SuperAPI AI 工具集

relay-ready

智能体与模型

查看项目

更新于 10-16 03:37

技能介绍

用途:当 /relay 无法安全跳过直接进入计划阶段时使用。适用于请求模糊、过宽,或可能需要多个有序叶子任务,且尚无稳定 Done Criteria 或评审锚点的情况。不用于编写评分标准或派发提示(用 relay-plan)、委派实现(relay-dispatch)、评审执行结果(relay-review)、落地 GitHub 变更(relay-merge)。

就绪判断:无脚本对就绪打分,需自行按下列维度判断,仅阅读围栏代码块之外的文本。清晰度低:出现模糊动词、无明确目标、正文过短;高:首段同时出现明确目标与可观察终态。粒度低:顶层“和”连接两个动作子句、多动词开篇跨多个子系统、跨多模块三条以上要点;高:一个动作动词作用于一个子系统。可验证性低:主观措辞承载标准,或验收标准无明显可观察内容;高:命名测试路径、引用日志行、文件或 diff 目标、数值阈值。任务形态衡量分解压力,满足两个以上信号即为强形态。出现 migration、drop、delete、schema、auth、secret、prod 等关键词即高风险。

路由:Ready 进入 relay-plan;needs_split 采用先提案的塑形路线;Escalate 先与操作者确认范围;否则继续提出有边界的问题。

持久化:将 JSON 契约写入 /tmp/relay-ready-contract.json,含 source.kind、request_text、单叶子 handoff 或多叶子 handoffs[]、每叶 leaf_id、title、goal、order、done_criteria_markdown 及可选的 depends_on、in_scope、out_of_scope、assumptions、escalation_conditions。执行: node "${RELAY_SKILL_ROOT:-skills}/relay-ready/scripts/persist-request.js" --repo . --contract-file /tmp/relay-ready-contract.json --json 结果保存在 ~/.relay/requests/<repo-slug>/<request-id>/,完成后不可变。

下游:以 relay-ready/<leaf-id>.md 作为 relay-plan 的输入,再用 dispatch.js 派发;多叶按 leaf_order 并遵守 depends_on。脚本只校验与持久化,不推断语义叶子边界。提案、澄清、回答与编辑状态保留在对话中,不持久化可变状态。契约字段细节见 scripts/request-contract.schema.json。