SuperAPI AI 工具集

forge-ship

编程与开发

查看项目

更新于 10-16 00:29

技能介绍

用途:forge-ship 用于端到端交付一次变更——实现、审查、推送。实现部分在当前会话中运行;审查始终委托给全新上下文,并仅在风险足够时加深审查。

输入:与 forge-implement 相同($ARGUMENTS),可为 Issue 编号/URL、计划文件路径或自由文本,可选附加 -- <additional context>。

模式:--unattended 跳过计划审批,并按严重程度自动分诊发现项;--guard 在 PR 打开后继续执行 forge-guard 流程(质量通过、CI、同行评审、反馈轮次),终止于 review-ready 或 needs-human,隐含 --unattended。

流程:第一步实现,执行完整 forge-implement 流程,但不产出其摘要;第二步审查(委托),收集实现产生的 diff,默认使用一次全新上下文审查(本会话编写了 diff,故不适用内联微小 diff 路径),仅在风险足够时增加第二轮,并汇总发现项;第三步分诊,默认模式下逐项向用户展示并建议,强烈倾向立即修复,仅当显著扩大 PR 范围或确实超出范围时推迟,无人值守模式按严重程度与范围自动分诊,修复范围内 P0–P2,推迟确实超范围或明显更大的 P1–P2,忽略 P3,已修复项提交并推送,推迟项转为 Issue;第四步 guard(仅 --guard),对第一步的 PR 运行完整 forge-guard 流程,其终止状态即本技能的终止状态,无 --guard 时通过 status-reporting 报告已推送;第五步汇总,一并报告实现、审查与 guard 结果。

输出格式:Ship Summary,含 PR、分支、结果(pushed | review-ready | needs-human)、实现(提交数、文件数、测试、文档)、审查发现(PR 中已修复、推迟项)、Guard(仅 guard 模式)、质量门(Lint、Format、Types、Tests、Coverage)。

准则:即使微小 diff 也委托审查,因为本会话编写了变更,内联审查等于自审;不要跳过审查;倾向在同一 PR 中修复,除非发现项确实更大或超范围。

相关技能:组合 forge-implement、与 forge-reflect 共享的全新上下文审查流程(_shared/review-delegation.md),以及设置 --guard 时的 forge-guard;同行评审后可用 forge-address-pr-feedback 处理评论;多个 Issue 可用 forge-batch 分组为 Waves,再用 contrib/launchers/ 中的启动器为每个 Issue 启动一个受 guard 保护的 ship。

示例用法:/forge-ship 42;/forge-ship 42 -- keep the diff minimal;/forge-ship docs/roadmap.md;/forge-ship --unattended 42;/forge-ship --guard 42。

限制:资料未提供收费、价格、平台支持范围等细节。