easy-codex-ship

# 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 时输出： ```markdown 摘要： - ... 验证： - ... 风险： - ... ```