SuperAPI AI 工具集

git-issue

编程与开发

查看项目

更新于 10-15 16:48

技能介绍

用途:git-issue 用于“Issue 优先”的 GitHub 工作流,把当前 AI 会话绑定到某个 Issue 对应的分支。触发场景包括:需要先创建 GitHub Issue 再创建并检出匹配分支;提供已有 Issue 编号或 URL 并进入其对应分支;以 git-issue / /git-issue / @skills/git-issue 加主题、编号或 URL 调用;要求对当前会话强制锁定 Issue 分支。范围涵盖 Issue 起草、创建、关联分支的创建或复用、检出验证以及会话分支守卫。不适用于仅提交、推送、创建 worktree,或与 Issue 分支无关的 PR 操作。

主要能力:从用户任务上下文生成结构良好的 Issue(简洁标题、问题或背景正文,尽量含验收标准);通过 gh issue develop 列出、复用或创建关联分支;检出后验证当前分支;并在后续会话中限制不切换到无关分支。

使用方式:先确认处于 Git 仓库(git rev-parse --show-toplevel),确认 gh 已认证(gh auth status),并用 gh repo view --json nameWithOwner,url 解析目标仓库。已有 Issue 时用 gh issue view <issue> --json number,title,state,url 校验,再用 gh issue develop --list <issue> 查看关联分支,必要时先 fetch 再检出;无关联分支时用 gh issue develop <issue> --checkout --name <type>/<issue-number>-<slug> 创建。新 Issue 用 gh issue create --title <title> --body <body> 创建,再用 gh issue develop 创建检出分支。分支命名遵循小写 ASCII 的 type/<issue-number>-<slug>,类型优先 fix、feat、docs、chore、refactor、test。检出后用 git status --short --branch 与 git branch --show-current 验证。若调用时缺少主题、编号或上下文,会先用用户语言追问,且不产生 GitHub 写入。

限制与注意:网络副作用仅限目标仓库的 Issue 与分支操作;不推断凭证、令牌、仓库归属或权限;不重写历史、删除分支、关闭 Issue 或推送提交;不检出 main、master 等无关分支,除非用户明确退出或重新指定;若 gh issue develop 不可用或失败,可基于默认分支创建同名本地分支,并报告无法确认 GitHub 关联。默认面向用户的产出语言为韩语,除用户明确要求或需保持一致的其他语言。