SuperAPI AI 工具集

implementing-issues

通用与其它

查看项目

更新于 10-16 07:15

技能介绍

用途:按 TDD 流程端到端实现一个 GitHub 或 Linear 的 issue,并完成分支管理与 PR 创建。

主要能力与工作流:自动检测版本控制系统(jj root 成功则用 jj,否则用 git);自动检测 issue 跟踪平台(数字或 #number 视为 GitHub,TEAM-ID 格式视为 Linear);检查工作副本状态,确保不在 main/master/dev 上;按规范创建功能分支;阅读并理解 issue 需求;查看项目上下文文件(spec.md、requirements.md、CLAUDE.md);遵循 TDD 先写测试;实现使测试通过的最小代码;在保持覆盖率的前提下增量重构;整理提交历史(squash 或精选提交);推送并创建 PR;写出含测试计划的完整 PR 描述。

分支命名:GitHub 用 feature/issue-{number}-{short-description} 或 fix/issue-{number}-{description};Linear 用 feature/{team-id}-{short-description} 或 fix/{team-id}-{description}。

分支安全要点:jj 下可运行 jj log -r @ --no-graph -T 'bookmarks' 检查;若在 main 上则 jj new main -m "feat: description" 并 jj git fetch。git 下用 git branch --show-current 检查;若在保护分支上则 git checkout -b "feature/issue-<number>-<description>" 并 git fetch origin。

实现标准:先写捕获验收标准的失败测试;写最小实现使测试通过;重构时保持测试通过;遵循 CLAUDE.md 中的项目模式;为复杂逻辑添加有意义注释;公开 API 变更时更新文档。

推送与 PR:jj 用 jj squash -m "feat: final commit message"、jj bookmark set <branch> -r @、jj git push --bookmark <branch>;git 用 git push -u origin HEAD。创建 PR 可用 gh pr create --title "[Issue #<number>] Title" --body 配合摘要与测试计划清单。

常用命令:GitHub 用 gh issue view <number> --json title,body,labels,assignees,milestone 与 gh pr create;Linear 用 linear-cli issues 与 linear-cli issue <team-id>。

限制:需已配置对应平台 CLI 与仓库权限;具体安装方式、收费与平台支持范围资料未提供。