agent-infra: Skill for Claude Code

创建 Pull Request

--agent 取值见 .agents/rules/task-management.md「合作者 token 规范」。

创建 Pull Request，并在与任务关联时立即补齐核心元数据和 reviewer 摘要。

platform-pr create 返回唯一的 result / warnings 字段；成功结果为 pr_created、pr_reused 或 no_op，同步降级时为对应的 _with_warnings 结果（包括 no_op_with_warnings）。创建前必须证明任务分支已推送，远端 branch SHA 与本地预期 HEAD 一致；缺失、漂移、PR head SHA 不一致或 bind 前竞态都属于 hard failure，不得用 warning 继续绑定。

行为边界 / 关键规则

版本戳规则：创建或更新 task.md frontmatter 时，先读取 .agents/rules/version-stamp.md，并写入或刷新 agent_infra_version。

任务上下文解析

入口可省略 task ref；显式 task scope 仅接受 --task <ref> 或 -t <ref>，不再解释位置 task ref。保留其余业务操作数后调用 agent-infra-internal task-context resolve {task-scope}；{task-scope} 为空或 task flag 之一。只读取结构化结果的 taskId，后续把 {task-id} 绑定为完整 TASK-YYYYMMDD-HHMMSS。解析失败时透传非零退出码，不自行扫描任务。

步骤开始：started 标记

真实执行 platform-pr create 时由 typed core 在远端写入前幂等登记 Create PR [started]；dry-run 不登记。调用方不得重复手写该条目。

执行流程

前置门控：项目级 PR 流程检查

门控读取（项目级 PR 流程策略）：在执行编号步骤前，读取 .agents/.airc.json 的 prFlow 字段（三态：字段缺省 = 默认推荐 PR、允许跳过；"required" = 强制 PR；"disabled" = 强制无 PR）。

按读取结果分支：

• 缺省 / "required" → 继续到下方第 1 步
• "disabled" → 输出以下消息后立即停止，不要执行任何后续编号步骤、不要触发任何 PR 创建命令、不要修改 task.md 的 pr_delivery_fact、不要发布 PR 摘要评论：

使用 agent-infra-internal agent-client next-steps --skill complete-task --task-ref {task-ref} 生成本场景的 {next-step-commands}。

当前项目未启用 PR 流程（`.agents/.airc.json` 中 `prFlow: "disabled"`）。
无需创建 Pull Request，请直接运行：
{next-step-commands}

1. 解析命令参数

先解析 task scope：可选的 --task <ref> 或 -t <ref> 绑定 {task-id}；位置 task ref 不再解释。剩余的可选位置参数绑定为 {target-branch}。

如果提供了 {task-id}，读取 .agents/workspace/active/{task-id}/task.md 获取任务信息（例如 issue_number、type 等）。 如果未提供，可从当前 session 上下文获取；仍无法确定 {task-id} 时，后续步骤中的任务关联逻辑跳过。

2. 确定目标分支

如果用户显式提供参数就直接使用；否则根据 Git 历史和分支拓扑自动推断。

详细分支判断规则见 reference/branch-strategy.md。自动推断 base 分支前，先读取 reference/branch-strategy.md。

3. 准备 PR 正文

通过 .agents/rules/issue-pr-commands.md 读取 PR 模板，参考最近合并的 PR 风格，并收集 <target-branch> 到 HEAD 的全部提交。