mcpField
F
forge-ship

forge-ship

github.com/mgratzer开发8333 次安装3 天前更新
代码仓库

关于 forge-ship

forge-ship 是端到端实现变更、安排独立上下文审查并汇报结果的技能。可选的无人值守和 guard 模式会自动分诊审查发现，并继续执行 PR 检查直至达到相应状态。

主要功能

  1. 01端到端实现变更
  2. 02委派至新上下文进行审查
  3. 03分诊审查发现
  4. 04guard 模式运行质量与 CI 检查
  5. 05汇报 PR 和实现结果

适用场景

  1. 01实现 GitHub Issue
  2. 02交付前审查变更
  3. 03在 guard 模式下运行 PR 检查

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/mgratzer/forge --skill forge-ship

安装后在 Claude Code 中输入/forge-ship确认已加载。

详细介绍

发布变更

端到端完成实现：编写代码、审查并发布。实现在当前会话中执行；审查始终委派给全新上下文，并仅在风险较高时深入审查。

输入

与 forge-implement 相同（$ARGUMENTS）：Issue 编号或 URL、计划文件路径，或自由文本。可选：-- <additional context>。

无人值守模式： --unattended 跳过计划审批，并按严重性自动分类审查发现。

守护模式： --guard 会在 PR 开启后继续执行 forge-guard 流程——质量检查、CI、同行审查、反馈轮次——然后给出 forge-land 风险判定，最终状态为 merged（仅在项目选择启用自动合并时）、merge-ready、review-ready 或 needs-human。隐含启用 --unattended。

流程

第 1 步：实现

完整执行 forge-implement 流程，但有一处修改：不要生成 implement 的总结——下方的审查会为最终报告提供信息。

第 2 步：审查（委派）

遵循 review-delegation 流程：收集实现产生的差异，默认使用一次全新上下文审查；由于本会话编写了差异，因此绝不适用内联微小差异审查路径。仅在风险较高时增加第二轮审查，并汇总审查发现。

提供给子 Agent 的输入： 分支差异、变更文件列表，以及 review-delegation 中规定的项目规范。 预期输出： 按文件分组并标注严重性（P0/P1/P2）的去重审查发现。

第 3 步：分类审查发现

有人值守模式（默认）： 向用户逐项展示审查发现及建议，尽可能倾向于立即修复——只有会实质扩大 PR 范围或确实超出范围的变更才延期。

无人值守模式： 根据 review rubric 中的严重性和范围自动分类：立即修复范围内的 P0–P2 发现；延期处理确实超出范围或规模大得多的 P1–P2 项；忽略 P3。

已修复的发现会提交并推送；延期项会转为 Issues——参见 issue-operations。

第 4 步：守护与合并（仅限 --guard）

对第 1 步中的 PR 执行完整的 forge-guard 流程。如果最终状态为 needs-human，则该状态就是此技能的终止状态。如果达到 review-ready，不要报告该状态；应对同一个 PR 执行完整的 forge-land 流程，并以其终止状态作为此技能的终止状态。不使用 --guard 时，通过 status-reporting 报告 pushed——PR 已开启并完成自我审查，后续由人工处理。

第 5 步：总结

汇总报告实现、审查、守护和合并的结果。

输出格式

## Ship Summary

**PR:** #<number> — <title>
**Branch:** <branch-name>
**Result:** pushed | merged | merge-ready | review-ready | needs-human — <reason>

### Implementation
- <N> commits, <M> files changed
- Tests: <added/modified/none>
- Docs: <updated/none>
- Exercised: <intended | wrong: <observed vs expected> | not exercised: <why>> (plus "not run: <parts>" when parts were skipped)

### Review Findings
- Fixed in PR: <list or "none">
- Deferred: #<issue> — <title> (or "none")

### Guard   (guard mode only — the Passes, Rounds, and Open sections from forge-guard; Result above is authoritative)

### Land    (guard mode only, when guard reached review-ready — Judged, Checks, and Review requested from forge-land)

### Quality Gates
- Lint: ✓/✗
- Format: ✓/✗
- Types: ✓/✗
- Tests: ✓/✗
- Coverage: ✓/✗/not configured

指南

  • 即使差异很小，也要在此处委派审查——本会话编写了变更，因此内联审查会变成自我审查
  • 不要跳过审查——即使实现看起来很完善
  • 倾向于在同一个 PR 中修复——除非某项发现确实规模更大或超出范围

相关技能

组成部分： 组合 forge-implement、与 forge-reflect 共用的全新上下文审查流程（_shared/review-delegation.md），以及在设置 --guard 时依次执行的 forge-guard 和 forge-land。 同行审查后： 使用 forge-address-pr-feedback 处理审查者意见（守护模式会自动处理）。 同时处理多个 Issues： 使用 forge-batch 将 Issues 分组为 Waves，然后针对每个 Issue 启动一个 forge-ship --guard 会话。

使用示例

/forge-ship 42
/forge-ship 42 -- keep the diff minimal
/forge-ship docs/roadmap.md
/forge-ship --unattended 42
/forge-ship --guard 42

评论

支持 Markdown