用途:为 jackin❯ 仓库中的小型、自包含改动(错别字、依赖升级、单行 bugfix、文档调整)打开拉取请求,无需路线图条目;同时作为其他技能复用的 PR 机制路径。提交在流程内完成,没有单独的 commit 技能。
主要能力:自动加载并遵循仓库规则文件(PULL_REQUESTS.md、.github/ 代理规则、BRANCHING.md、COMMITS.md),只做排序不重述;从 diff 推导 Conventional Commits 标题;用 cargo xtask pr body 生成变更摘要与 PR 模板骨架,并自动选择 verify-locally 块(Checkout + 隔离环境始终包含,Rust 改动加 Rust 测试,docs/** 加文档检查,crates/jackin-capsule/ 加 capsule 冒烟,版本化 schema 改动加迁移冒烟);由代理填写正文散文部分后创建 PR。
使用方式:操作者运行 jackin-create-pr。参数:--branch <name> 指定分支名;--auto-branch 自动选分支名不确认;--title <msg> 指定提交与 PR 标题,否则从 diff 推导。流程:先建分支(绝不提交到 main,按 fix/、chore/、docs/、refactor/ 前缀命名),再按 COMMITS.md 内联提交(Conventional Commits 主题、DCO 签名 git commit -s)并 git push;然后运行 cargo xtask pr body --base origin/main > /tmp/pr-body.md,读取 stderr 的分类摘要,编辑 /tmp/pr-body.md 填写 Summary、What ships、Behavior changes 等散文段;接着 gh pr create --body-file /tmp/pr-body.md;用 gh pr view <PR> --json body -q .body 验证渲染,必要时 gh pr edit --body-file 修复;最后回复 PR URL 并重复 Verify-locally 命令。
适用场景:小型、自包含、无需设计或路线图条目的改动。不适用:值得路线图条目的功能或想法(用 jackin-propose);实现已定稿的路线图条目(用 /goal Implement <slug>.md)。
限制与常见错误:不要提交到 main;不要手工构建正文或模板,应使用 cargo xtask pr body;不要留下未填写的散文占位符;正文中不要放已部署的文档 URL(合并后会失效),应按名称引用文档。