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