SuperAPI AI 工具集

review-implementing

编程与开发

查看项目

更新于 10-15 15:27

技能介绍

用途

Review Feedback Implementation 是一个用于系统化处理并落实代码评审反馈的技能。当用户提供评审者评论、粘贴 PR 评审笔记、提到要实现评审建议、说出“处理这些评论”或“实现反馈”,或分享评审者要求修改的清单时,即可使用该技能。

主要能力

该技能围绕一套系统化工作流展开,覆盖从解析反馈到验证完成的完整过程:

  1. 解析评审笔记:识别单条反馈项,拆分编号列表(1.、2. 等),处理项目符号或无编号反馈,提取不同的变更请求,并在开始前澄清含糊项。
  2. 创建待办清单:使用 TodoWrite 工具创建可执行任务,每条反馈对应一个或多个待办,将复杂反馈拆分为更小任务,使任务具体可衡量,并在开始前将第一个任务标记为 in_progress。示例待办包括:为 extract 函数添加类型提示、修复重复标签检测逻辑、更新 chain.py 中的 docstring、为边界情况添加单元测试。
  3. 系统化实现变更:对每个待办项,先用 Grep 搜索函数/类、用 Glob 按模式查找文件、阅读当前实现;再用 Edit 工具修改,遵循项目约定(CLAUDE.md),除非要改变行为否则保留现有功能;随后检查语法正确性、运行相关测试、确保改动符合评审者意图;完成后立即标记待办为 completed,再进入下一项(同一时间只允许一个 in_progress)。
  4. 处理不同类型的反馈:
    • 代码修改:用 Edit 工具修改现有代码,遵循类型提示约定(PEP 604/585),保持风格一致。
    • 新功能:必要时用 Write 工具创建新文件,添加对应测试,更新文档。
    • 文档:按项目风格更新 docstring,按需修改 markdown 文件,保持说明简洁。
    • 测试:以函数而非类编写测试,使用描述性名称,遵循 pytest 约定。
    • 重构:保留功能,改进代码结构,运行测试验证无回归。
  5. 验证:实现变更后运行受影响的测试,检查 lint 错误(uv run ruff check),确认改动未破坏现有功能。
  6. 沟通:实时更新待办清单,对含糊反馈请求澄清,报告阻塞或挑战,完成时总结变更。

使用方式

该技能以工作流形式被触发使用,核心操作包括:使用 TodoWrite 跟踪进度、用 Grep/Glob 定位代码、用 Edit/Write 修改或创建文件、运行测试与 ruff 检查。技能强调始终使用 TodoWrite 跟踪进度,每完成一项立即标记完成,同一时间只保留一个 in_progress,不批量更新状态,对不清楚的反馈主动提问,改动影响被测代码时运行测试,所有代码改动遵循 CLAUDE.md 约定,后续如需创建提交则使用 conventional commits。

适用场景

适用于开发者收到代码评审意见后需要逐条落实的场景,包括处理 PR 评审笔记、实现评审建议、回应评审者提出的修改清单等。

限制与边界情况

  • 反馈相互冲突时:向用户寻求指引,清楚说明冲突。
  • 需要破坏性变更时:实现前通知用户,讨论影响与替代方案。
  • 改动后测试失败时:在标记待办完成前修复测试,确保所有相关测试通过。
  • 引用的代码不存在时:向用户请求澄清,确认理解后再继续。

关于该技能的收费、价格、支持平台等具体信息,资料中暂未提供。