用途:为已完成的开发阶段创建或复用拉取请求(PR),并记录 PR 身份。属于企业角色技能,需匹配的 Core 支持,且仅在用户显式调用并通过企业预检后才会调用 GitHub。
主要能力:根据 log.json 的 header.phase_branches.mode 选择路径。堆叠计划(mode 为 stacked)走手动修复记录器,对记录的阶段分支运行 publish-phase,阶段分支按 ref 读取、从不检出;其他计划为当前分支创建或复用 PR。它不负责阶段裁决报告,阶段摘要与内联裁决属于企业适配器。
使用方式:调用格式为 /pocketto:create-pr <plan_dir> [<phase_file>]。<plan_dir> 含 log.json 与执行计划文件;<phase_file> 可选,省略时按路径选取唯一符合条件的 log.phases[] 条目(非堆叠为 REVIEW,堆叠为 DONE),零个或多个匹配需显式指定。预检步骤包括:npx -y pocketto-pi mode --json --contract 3 确认企业模式;运行 enterprise/cli.js preflight <project-root> --json 检查 Core 与适配器兼容性;gh auth status 检查认证;读取 log.json 解析路径、阶段与关联 issue。堆叠路径运行 node enterprise/cli.js publish-phase <project-root> <spec_dir> <phase_key> --json,不添加 --contract。非堆叠路径检查元数据、用 gh pr list --head <branch> --json number,url 发现 PR、提交 traveling state、用 npx -y pocketto-pi format pr 生成正文后执行 gh pr create,最后用 meta set 记录 PR 编号与 URL。
适用场景:用户请求阶段 PR,或明确确认企业提议时。非堆叠计划目标阶段处于 REVIEW;堆叠计划目标阶段为 DONE 且存在 phase-closed 事件。
限制:企业禁用、Core/适配器预检失败或无关联 issue 时不得使用。Core 为本地优先,不调用 gh、不合并 PR、不关闭 issue。该记录器从不管理分支、不强制推送、不 rebase、不重定向 PR 基分支;推送被拒或冲突需人工在 GitHub 处理。堆叠路径的 PUSH_CONSENT_REQUIRED 需用户批准具体 SHA 后重跑,不得代为记录批准。失败运行不改变生命周期状态,不应循环重试。