SuperAPI AI 工具集

code-review

编程与开发

查看项目

更新于 10-16 07:09

技能介绍

用途:审查一个完整的 FastMCP 变更,评估其正确性、受支持行为、兼容性与可维护性,可用于自审或审阅拉取请求。

主要能力:

  • 阅读 AGENTS.md、CONTRIBUTING.md、相对合并基点的完整 diff,以及此前的审查线程与回复。
  • 在上下文中追踪被改代码,包括调用方与共享抽象。
  • 一次性收集独立的、有实质影响的发现。

契约判定:

  • 从已发布文档、测试、历史和维护者决定中确定预期契约。
  • 可复现的行为不自动等于 bug。
  • 检查改动是在问题发生处修复根因,还是在别处添加补偿。

兼容性评估:

  • 即使是 bug 修复也要评估行为变更。
  • 比较省略默认值、显式覆盖、错误、序列化和受支持的配置。
  • 追踪共享分支到相邻行为以及所有受影响的 MCP 组件类型;使用基础组件的规范身份,而不是自行发明一个。
  • 明确陈述兼容性结论:什么既有输入会改变行为、这是否是修复问题所必需、以及什么迁移能保留旧行为。
  • 区分有意的修正与意外的回归。测试通过或机器人审查干净,并不能替你做这个产品决策。
  • 对于依赖变更,验证声明的最低版本是否支持当前使用的每一个 API。在声称兼容时,测试旧的最低版本。保持锁文件改动仅局限于该依赖变更。

发现报告:

  • 报告可触达的缺陷,给出具体触发条件和后果。
  • 对机器人评论按其实质进行评估;不要在没有新证据的情况下重复已解决或已被有力反驳的发现。
  • 避免猜测性案例、装饰性阻塞项以及泛泛的“增加测试”请求。
  • 针对实际失败和受影响的相邻契约审查回归测试。
  • 记录运行了哪些检查以及是在哪个修订版本上运行的。
  • 保持不确定性明确:检查过的 diff、通过的聚焦测试和完整的已验证审查是不同的证据。

使用方式:

  • 发布后使用 review-pr 跟踪 CI 和自动反馈。
  • 合并仍需要用户授权以及仓库当前的合并门禁。

适用场景:FastMCP 项目的自审或拉取请求审阅。

限制:未提供具体的安装命令、收费或价格信息;资料中未说明该技能可脱离 FastMCP 仓库使用。