easy-codex-ship

name	easy-codex-ship
description	当本地改动已通过代码最终审查或用户已接受代码审查剩余风险，需要准备交付总结、验证记录、提交信息、提交操作或拉取请求说明时使用。

Easy Codex 交付

最终交付准备。仅在代码最终审查通过，或用户接受代码审查剩余风险后使用。

用户选择

• “选择功能”指：可点击选择可用时必须用控件；工具不可用时用文本降级，给每个选项编号，列 2-3 个互斥选项，推荐项第一，要求用户回复编号数字、完整选项名或 其他: <自定义>；开放答案用“其他”，并允许用户直接输入自定义内容；禁止要求用户输入关键词或技能名。

强制门禁

• 必须在规格/计划字段 绝对 worktree 路径 内交付；字段缺失、相对路径、未通过 <主项目根>/<显示路径> realpath 校验、或指向 main worktree 时阻塞。
• 基准 缺失、git rev-parse --verify <基准>^{commit} 失败、或不是 HEAD 祖先时阻塞，返回 $easy-codex-writing-plans 补齐。
• 必须读取 docs/reviews/ 代码最终审查产物；缺失则返回 $easy-codex-review。
• 未经代码最终审查放行且用户未接受代码审查风险时，返回 $easy-codex-review；计划审查通过或接受计划风险不能交付。
• 交付阶段禁止实现、修 bug、改测试、改规格或改计划。
• 除非检测到明确未提交的本次工作改动并经用户选择，否则不运行 git add、git commit 或推送。

工作流

1. 读取字段 绝对 worktree 路径、主项目根、显示路径 和 基准，用 realpath 与 git worktree list --porcelain 验证后切入；git status --short。
2. 汇总已提交阶段：git log <基准>..HEAD、git diff --stat <基准>..HEAD、阶段提交信息。
3. 只用 git diff HEAD、git diff --cached、git ls-files --others --exclude-standard 检查未提交/未跟踪遗漏。
4. 读取 docs/reviews/ 代码最终审查产物，必须选择并校验 基准 == 计划基准 且 HEAD == 当前 HEAD 的记录；缺失或不匹配则返回 $easy-codex-review。汇总 review 结论、已接受风险、验证结果、未验证项。
5. 识别本次工作相关文件；排除无关用户改动。
6. 生成交付摘要、风险、验证记录、阶段提交列表和 PR 说明。
7. 通常只提供：只要总结、准备 PR、停止。
8. 仅当存在明确未提交的本次工作改动时，才提供：提交未提交改动；同时说明所属阶段或为什么不是阶段提交遗漏，再确认提交、取消。

交付内容

• 改了什么：
• 关键文件：
• 阶段提交：
• 验证和结果：
• Review 结论：
• 已接受风险：
• 未验证项：
• 建议提交信息：

提交规则

• 默认不新增提交、不暂存、不推送；实现阶段已有每阶段提交。
• 只有检测到明确未提交的本次工作改动，且说明所属阶段或遗漏原因后，才能提交。
• 提交前确认只包含本次工作相关文件。
• 不暂存无关用户改动。
• 提交信息要短，说明行为变化。
• 推送必须另行获得明确请求。

PR 说明

用户选择准备 PR 时输出：

摘要：
- ...

验证：
- ...

风险：
- ...