SuperAPI AI 工具集

fix-issue

编程与开发

查看项目

更新于 11-08 02:48

技能介绍

fix-issue 是 SetupVibe 仓库(promovaweb/setupvibe)中用于修复已报告 GitHub issue 的工作流技能,当前提供的是 Claude Code 版本。资料说明它使用 Read、Grep、Edit 和 Bash 进行调查、修复与验证,并要求其功能与 .codex/skills/fix-issue 保持对齐。

使用方式 以斜杠命令调用: /fix-issue <编号>:调查并修复对应 issue。 /fix-issue <编号> comment:完成修复后,在 issue 中发布评论,请报告者测试。 例如 /fix-issue 15、/fix-issue 15 comment。

主要流程

  1. 读取与诊断:用 gh issue view <编号> --repo promovaweb/setupvibe 读取 issue,记录作者,并判断受影响文件。资料给出的候选文件包括 desktop.sh(macOS 或 Linux 桌面错误)、server.sh(Linux 服务器错误)、conf/zshrc-.zsh(PATH、别名或 shell 问题)、conf/tmux-.conf(tmux 或插件问题)以及 docs/(文档错误或缺失)。修改前须用 Read 或 Grep 阅读相关脚本片段,不修改未读代码。
  2. 创建分支:编辑前执行 git checkout -b fix/issue-<编号>,例如 fix/issue-15。
  3. 定位根因:回答具体哪一行或哪个代码块导致问题,属于 PATH、权限、管道断裂、执行顺序还是条件逻辑问题,以及修复影响 macOS、Linux 还是两者;脚本中两个系统有独立分支。资料还列出若干常见缺陷模式及典型修复方向,包括管道破坏 user_do、sudo 下 $HOME 错误、mv 工作目录错误、sudo 下 PATH 不可用、TMPDIR 位于 noexec 分区、缺少 eval "$(tool init -)"、.bashrc 未更新等。
  4. 应用修复:仅用 Edit 修改受影响文件,遵循已有的 user_do 与 sys_do 模式,区分对应系统分支;若涉及 zshrc,则在 conf/zshrc-macos.zsh、conf/zshrc-linux.zsh 及相关时 conf/zshrc-server.zsh 中同步修改。
  5. 验证:检查语法、变量转义、sudo 上下文中的 $REAL_HOME 使用,以及是否破坏另一系统的流程。
  6. 提交与推送:git add、git commit -m "fix: ... (closes #<编号>)"、git push -u origin fix/issue-<编号>。
  7. 完成通知:按模板向用户报告分支、根因、改动文件,并提示运行 comment 参数发布 issue 评论。
  8. 发布评论:带 comment 参数时,用 gh issue comment 针对 desktop.sh 或 server.sh 生成对应测试命令与说明,替换作者与 issue 编号。资料特别规定:创建或修改任何 .md 文件时,必须先调用 /markdown-format 技能,规则见 MARKDOWN.md。

适用场景与限制 该技能面向 promovaweb/setupvibe 仓库的 issue 修复,依赖 GitHub CLI(gh)与 git,并主要面向 Claude Code 环境;它不适用于其他仓库或其他平台的 issue 流程。资料未提供技能安装命令、最低版本要求、收费或性能数据。