SuperAPI AI 工具集

gitkkal-ship

编程与开发

查看项目

更新于 10-21 04:08

技能介绍

用途

gitkkal-ship 是一个一次性的编排型技能,用于把代码改动端到端地交付:先执行 gitkkal-commit 流程完成提交,再执行 gitkkal-pr 流程打开或更新拉取请求。当用户输入 /gitkkal:ship 或 $gitkkal-ship,或提出语义等价的自然语言请求时使用。该技能只负责阶段顺序编排,提交与 PR 的具体规则全部来自它所加载的两个技能。

主要能力与工作方式

  • 接受一个可选的自由形式提示(例如命令尾部文本),并把同一提示作为建议性上下文转发给两个阶段。
  • 解析仓库根目录并加载 {repo_root}/.gitkkal/config.json;若缺失则使用默认值:language=en、commitPattern=conventional、splitCommits=true、askOnAmbiguity=true。
  • 第一阶段(提交):完整加载并遵循 gitkkal-commit,包括其提交计划确认与索引安全规则。若用户取消提交计划,整个运行停止,不进入 PR 阶段;若没有可提交的改动,则报告后继续第二阶段,因为分支上可能仍有已提交但需要 PR 的工作。
  • 检查点(确认 PR 阶段):报告刚落地的提交主题,并用编号选项询问是否继续创建拉取请求(例如 1) 创建/更新 PR、2) 在此停止),因为打开 PR 是面向外部的操作。
  • 第二阶段(拉取请求):完整加载并遵循 gitkkal-pr,并转发原始提示。
  • 最终报告:汇总两个阶段,包括落地的提交主题、PR 编号、URL 以及模式(创建或更新);在降级模式下报告生成的 PR 标题/正文与命令。

使用方式

用户通过 /gitkkal:ship、$gitkkal-ship 或自然语言请求触发。技能在同一时间只推进一个阶段直至完成,不会把提交暂存与 PR 操作交错进行;在改动任何内容前先呈现计划(先提交计划,后 PR 内容)。需要用户输入(提交计划确认、PR 是否继续、意图不明确)时,优先使用宿主的交互式提问或选择工具,否则退回纯聊天;在纯聊天模式下以独立编号行渲染多选项,避免 Markdown 有序列表语法,每个问题重新从 1) 编号,一次只问一个聚焦问题并等待回答。

加载同级技能

该技能依赖 gitkkal-commit 与 gitkkal-pr;同一技能包中的所有技能总是一起安装,因此同级技能位于本技能目录旁边。若宿主原生支持调用技能(技能工具、斜杠命令),则在对应阶段直接调用;否则读取本技能目录旁的 ../gitkkal-commit/SKILL.md 与 ../gitkkal-pr/SKILL.md,并分别作为该阶段的主导指令遵循。

适用场景

适合希望用一次触发完成“提交 + 拉取请求”整条交付链路的开发者,尤其适合需要确认提交计划、并在对外创建 PR 前保留一次显式放行控制的团队工作流。

限制与防护

技能不重复或改写所加载技能的规则:当本文档与所加载技能在提交或 PR 机制上冲突时,以所加载技能为准,本文档只管辖阶段顺序。阶段须顺序执行:在完成所有提交(包括每次提交所需的 git log -1 --oneline 校验)之后,才能执行任何 push 或 gh 命令。若提交阶段被取消,绝不能基于部分状态创建 PR。同时尊重各阶段自身的澄清行为(askOnAmbiguity、提示与差异冲突)。