进行修复

写作 社区

技能解读

当前原文的自动摘译,尚未人工审校。

上下文检测

扫描<work-folder>/reviews/以获取最新的审核工件:*.review.*.md(代码审核输出)→使用以下流程应用代码修复*(未来:计划审核工件→应用计划改进)*审核文档包含带有复选框的结果 - 选中的[x]结果得到修复,未选中的[ ]结果被跳过。

查找审核文档

如果提供路径作为参数,请使用它。否则,自动发现:使用预加载的Work folder。如果none(在主线上),询问用户此评论针对哪个分支。在 <work-folder>/reviews/ 中查找审核文件 (*.review.*.md)。使用最新的一个(按文件名中的日期)。如果未找到审核文档:“未找到审核文档。先运行/code-review生成一个。”

阅读审查文件

阅读评论文档。注意:前面的phase: - 如果已经有committed或fixes-verified,则警告:“此审核已被应用。运行/code-review full以进行新的审核周期。”检查的[x]结果 - 这些是修复任何Instructions:字段的结果 - 用户指令优先于审阅者建议sha: - 审阅时的HEAD

阅读项目背景

阅读存储库根目录中的CLAUDE.md — 注意在阶段 1 中使用的验证命令(lint、类型检查、测试、格式)。

检查未提交的更改

如果存在未提交的更改(来自预加载的上下文):“存在未提交的更改。想要在继续之前隐藏它们,还是按原样继续?”等待他们的答复。创建进度任务: 修复结果 验证修复 完成 - 更新审核文档、提交、推送

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
写作
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@tomevault-io · 未声明许可证
上下文用量评级
低消耗
接入复杂程度
需简单配置
是否需要外部接口密钥
不需要
兼容的系统
未声明(默认跨平台)
运行环境要求
未检出明确要求
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
  • 命令执行
网络行为
仅限本地
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

01
第 1 步:将发现结果分组到修复批次中

涉及相同文件的结果必须位于同一批次中(防止编辑冲突)。不重叠的批次可以作为并行代理运行。每批次:1-5 个结果。

02
第 2 步:回归测试(仅限 BLOCKER/ISSUE)

在修复错误之前编写测试来证明错误的存在。范围:仅限可单元测试的 BLOCKER/ISSUE 结果。跳过:缓存行为、约定修复、死代码、样式。建议和 NIT 永远不需要测试。将测试写作外包给并行代理。每个代理:接收查找文本和相关源文件内容 指令:编写针对当前代码失败的重点测试 - 不要修复代码

03
第 3 步:将编辑工作外包给代理

您(协调员)不进行编辑。将所有编辑委托给代理。最大化并行性。查看步骤 1 中的批次。所有涉及非重叠文件的批次都可以(并且应该)同时生成为并行代理 - 具有多个代理工具调用的单个消息,而不是顺序生成。仅序列化共享文件的批次。对于跨不同文件的 3-7 个结果的典型审查,大多数或所有批次应并行运行。

04
第 4 步:跟踪进度

阅读`~/.claude/skills/shared/references/finding-format.md`了解状态生命周期。当代理返回报告时更新审核文档: `[x]` -> `[fixed]` 编辑后,带有一行更改摘要 `[fixed]` -> `[verified]` 验证通过后(批量更新) 如果验证失败,保留为 `[fixed]` 并附加失败的内容 `[ ]` -> `[skipped]`未经检查的发现

05
第 5 步:验证(在所有编辑完成后集中验证)

在所有编辑代理返回报告之前不要运行验证。关键:在任何提交或推送之前必须进行验证。没有例外,没有捷径。阅读 CLAUDE.md 和 `.claude/rules/` 以查找存储库的验证命令和策略。如果存在`verification.md`规则,请严格遵循它——它可能需要运行完整的测试套件,而不仅仅是有针对性的测试。

06
第 6 步:解决所有问题

在提交之前,扫描审核文档并确保每个检查的`[x]`发现已更新为最终状态。此时,任何发现都不应显示裸露的`[x]`。终端状态:`[fixed]` -> `[verified]`、`[skipped]`、`[will-not-do]`、`[deferred]`、`[already-resolved]`、`[could-not-prove]`。如果任何检查结果仍然是`[x]`:立即更新它们——如果故意不解决,则用注释标记`[skipped]`,如果超出范围,则标记`[deferred]`。

07
第 2 阶段:最终确定

完整的顺序是:验证 -> 提交 -> 推送 -> 发布 PR 评论。所有四个步骤都是强制性的,并且必须按顺序进行。不要跳过任何步骤。未经核实请勿推送。请勿在未发布 PR 评论的情况下结束会话。自动继续:修复完成并通过验证后,立即继续执行第 2 阶段的所有内容 - 提交、推送,然后发布 PR 评论 - 无需停下来询问。用户

08
第 7 步:承诺

将审核文档`phase:`更新为`fixes-verified`。审查周期的所有修复都会进入一次提交 - 永远不会通过查找来拆分。将`phase:`更新为`committed`。

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。