SuperAPI AI 工具集

github-do-issue

通用与其它

查看项目

更新于 10-15 22:39

技能介绍

用途:为任意项目实现 GitHub issue 提供结构化工作流。适用于用户说“work on issue #N”“do #N”“implement #N”,或提供 GitHub issue URL、引用 issue 编号要求实现时。

主要流程:

  1. 抓取 issue:从参数解析编号(42、#42,或从 URL 提取 owner/repo 与编号)。用 gh issue view "$ISSUE_NUMBER" ${ISSUE_REPO:+--repo "$ISSUE_REPO"} --json number,title,body,labels,assignees,milestone,state,comments 获取详情;若 URL 指向其他仓库会提示确认;issue 已关闭需用户确认后再继续。
  2. 理解需求:提取变更内容、验收标准、范围边界、关联上下文;信息不清时先向用户澄清。
  3. 制定计划:识别需创建或修改的文件、检查现有测试与项目约定(README.md、CLAUDE.md、AGENTS.md、CONTRIBUTING.md 等),向用户展示实施计划并等待批准。
  4. 实施:按批准的方案编写聚焦改动,遵循现有代码约定,参考 issue 评论中的最新决定,避免范围蔓延;若项目使用 i18n 需为新增用户可见字符串添加翻译键。
  5. 验证:按语言运行检查,如 npx tsc --noEmit、npm test、npm run lint、cargo check、cargo test、python -m pytest、mypy .、ruff check .、go build ./...、go test ./...、./gradlew build、flutter analyze、swift build、dotnet build、mix test 等;同时查看 CI 配置了解项目检查项;至少运行类型检查或编译器并修复错误。
  6. 报告并停止:列出修改文件与验证结果。

限制:不提交、不推送、不创建分支、不创建 PR;不修改 issue 范围外的文件;需求模糊时询问而非猜测;若复杂度超出预期应暂停并告知用户,建议拆分。前置条件:需在 git 仓库中(git rev-parse --show-toplevel 检查),需要安装 gh(https://cli.github.com)。