jackin-create-pr

jackin-create-pr

在 jackin❯ 仓库中为小型修复创建 PR——拼写错误、依赖项升级、单行 Bug 修复、文档微调等，无需纳入路线图项目。它也是其他技能复用的共享 PR 流程。直接提交；无需单独的提交技能。

jackin❯ 规则文件会自动加载——PULL_REQUESTS.md、.github/ Agent 规则、BRANCHING.md、COMMITS.md。此技能负责安排它们的执行顺序，不会重复说明其中的规则。完整规则请阅读这些文件。

适用场景

• 操作者运行 jackin-create-pr。
• 变更小且独立（无需设计，也无需纳入路线图项目）。

不适用场景

• 值得纳入路线图项目的功能或想法 → jackin-propose。
• 实施已敲定的路线图项目 → /goal Implement <slug>.md。

参数

• --branch <name> — 指定分支名。
• --auto-branch — 自行选择分支名，无需确认。
• --title <msg> — 提交和 PR 标题（否则根据差异生成，遵循 Conventional Commits）。

流程

1. 创建分支。 绝不向 main 提交。如果当前位于 main，则创建一个以 fix/、chore/、docs/ 或 refactor/ 为前缀、根据变更命名的分支。除非提供了 --auto-branch 或 --branch，否则先提出分支名并征求确认。
2. 提交。 有未提交的变更 → 按照 COMMITS.md 直接提交：使用 Conventional Commits 格式的主题，并进行 DCO 签署（git commit -s）。如果已经提交 → 跳过。然后运行 git push。
3. 生成正文。 [bin] 运行 cargo xtask pr body --base origin/main > /tmp/pr-body.md。分类后的变更摘要（rust / docs / capsule / schema + 文件列表）会打印到标准错误——请阅读；正文骨架会写入文件：运行时从 .github/PULL_REQUEST_TEMPLATE.md 读取的 PR 模板，其中已选好并按字节精确写入本地验证区块，文案部分则留作占位符。区块选择规则：始终包含 Checkout 和隔离环境；Rust 变更时包含 Rust 测试；涉及 docs/** 时包含 Docs 检查和遍历；涉及 crates/jackin-capsule/ 时包含 jackin-capsule 冒烟测试（任何 console/load 之前必须先使用 --capsule）；涉及版本化 schema 时包含 schema 迁移冒烟测试。
4. 填写并创建。 [agent] 编辑 /tmp/pr-body.md——根据摘要和差异填写文案部分（Summary、What ships、Behavior changes）；删除不需要的可选部分。然后运行 gh pr create --body-file /tmp/pr-body.md。二进制文件已写入正文，因此无需引用 heredoc。
5. 验证渲染效果。 运行 gh pr view <PR> --json body -q .body——确认新增文案的渲染效果正常（手动编辑时没有多余的 \`` 或 $）。如有需要，使用 gh pr edit --body-file` 修复。
6. 回复。 分享 PR URL，并在最终消息中重申本地验证命令。

常见错误

• 向 main 提交，而不是提交到分支。
• 手动拼写正文或模板，而不是运行 cargo xtask pr body——该命令会读取模板并为你选择验证区块。
• 发布仍带有文案占位符的骨架。
• 在正文中使用已部署的文档 URL（合并后会失效）——请按名称引用文档。

工具

cargo xtask pr body（jackin❯ 仓库）会输出变更摘要和模板骨架，并根据差异自动选择本地验证区块。与 propose 共享。该二进制文件保证机械部分的正确性（区块选择、capsule 顺序、精确命令文本、heredoc 引用）；文案由 Agent 撰写。