用途:这是 incu-way 仓库中唯一会把工作持久化到 git 的技能,负责暂存、提交、推送和创建 PR。其他流程只写文件,并在自然检查点提示用户运行本技能,自身不会提交、推送或开 PR。
主要能力与用法:先运行 git branch --show-current 定位上下文,按分支前缀推导 {slug};若存在 .ways/state.json 则读取(暂不写入)以了解流程、阶段与对应检查点。随后用 git status --short、git diff --stat、git diff --stat --staged 展示将要提交的内容,无改动则停止。提交信息遵循 Conventional Commits:<type>(<scope>)<!>: <description>,type 限于 feat、fix、docs、style、refactor、perf、test、build、ci、chore、revert;描述用祈使语气、冒号后小写、不加句号,整行约 72 列内;正文说明原因,页脚可写 Closes/Refs #123,破坏性变更需在 scope 后加 ! 并配 BREAKING CHANGE: 页脚。要求一次提交一个逻辑变更,若混入无关改动应先提示拆分。
确认门:提交前必须说明文件列表与拟定信息并等待用户确认,确认后才执行 git add 与 git commit。推送与开 PR 需另行询问,确认后执行 git push -u origin {branch} 与 gh pr create --base {base} --head {branch} --title "{title}" --body "{body}",并返回 PR URL。若仓库为公开(用 gh repo view {owner}/{repo} --json isPrivate -q .isPrivate 判断,无法判断时按公开处理),标题、正文、分支名、提交信息及本次 diff 涉及的文件都不得包含人名、内部频道名或内部对话引用,需先脱敏。
限制:不得被其他技能自动调用,仅在用户当前轮次明确要求时运行;不得跳过确认门;不负责合并 PR。具体 PR 模板与各阶段提交格式以调用流程自身的 SKILL.md 为准,资料未提供固定模板内容。