SuperAPI AI 工具集

review-fix-codex

编程与开发

查看项目

更新于 10-16 01:57

技能介绍

用途

review-fix-codex 是一个代码审查与自动修复工作流技能,用于对当前分支运行 Codex 代码审查,并只修复对当前代码库仍然有效的审查意见。它属于 willbooster/agent-skills 技能集,通过命令行工具 bunx @willbooster/agent-skills 调用。

主要能力

  • 对当前分支运行 Codex 代理的代码审查。
  • 累积审查返回的发现,形成“已验证事实”(Verified Facts),并保留仍然影响审查的事实:已知内容、重要性以及验证方式。
  • 对累积事实进行精炼,减少重复并移除过时细节。
  • 逐条判断审查意见对当前代码库是否仍然有效。
  • 对有效意见更新代码进行修复;对无效意见在代码中添加说明性注释,解释现有实现的必要性。
  • 对超出当前 PR 范围的有效审查意见创建新 issue。
  • 若产生代码变更,则提交并推送到当前分支。
  • 若修复了任何有效意见,则回到判断步骤继续循环;否则退出工作流。

使用方式

工作流按以下步骤执行:

  1. 以阻塞、前台任务方式运行以下命令,超时设为 1 小时(以防止过早终止):
bunx @willbooster/agent-skills@latest review --agent codex
  1. 如果命令返回 There is no concern.,则不做任何代码修改直接退出。否则处理返回的发现。

  2. 将每个返回的发现作为事实累积到 ## Verified Facts 中,同时包含返回的任何 ## Verified Facts。只保留仍然影响审查的事实:已知内容、重要性以及验证方式。

  3. 精炼累积的事实,减少重复并移除过时细节,然后通过 heredoc 语法经 stdin 传入:

bunx @willbooster/agent-skills@latest review --agent codex <<'EOF'
## Verified Facts

[all accumulated facts]
EOF
  1. 复用累积事实,判断每条发现对当前代码库是否仍然有效。

  2. 对有效发现,通过更新代码来处理。对无效发现,在代码中添加说明性注释,详细说明为什么现有实现是必要的。

  3. 如果有对当前 PR 而言超出范围的有效审查意见,为它们创建新 issue。

  4. 如果做了任何代码变更,提交并推送到当前分支。

  5. 如果修复了任何有效发现,回到第 4 步。否则退出工作流。

适用场景

适用于需要在当前分支上执行代码审查并自动处理审查意见的开发流程,尤其是希望只修复仍然有效的问题、对无效意见留下解释、并将超范围问题转为新 issue 的场景。

限制

  • 依赖 bunx 与 @willbooster/agent-skills 包,需通过命令行运行。
  • 审查命令需以阻塞前台任务运行并设置 1 小时超时。
  • 仅针对当前分支与当前代码库进行判断。
  • 关于收费、价格、平台支持范围等具体信息,资料中暂未提供。