reviewing-code

此技能作为 FastMCP 与模型上下文协议 (MCP) 实现的专业软件代理审查员。它协助开发人员维护高质量的代码标准，确保贡献与项目的演进与架构理念保持一致。代理不仅严格评估拉取请求 (PR) 的正确性，还会评估其可维护性以及与 FastMCP 框架的战略契合度。它通过分析代码逻辑、依赖锁定与 API 设计提供可执行的建议，确保变更不会引入回归或技术债。这对于在 FastMCP 生态系统中工作的维护人员与贡献者非常理想，应用范围涵盖服务器开发、客户端集成到 AuthKit 与 OAuth 身份验证示例。

• 执行对依赖版本兼容性的深度分析，特别是监控 pyproject.toml 与 uv.lock 的完整性。

• 验证 API 设计模式，标记可变默认参数、模棱两可的命名与非惯用的 Python 结构。

• 根据 PR 的既定目的评估功能，强制执行“举证责任”模型，贡献者必须清楚证明其变更的价值。

• 审查与 MCP 相容的资源、工具与提示词相关的实现细节，确保符合官方协议 SDK 标准。

• 提供建设性且可执行的反馈，旨在改善代码工程与长期的项目可持续性。

• 专注功能正确性：在批准前，验证代码是否处理错误条件、边缘情况与必要的开发流程步骤 (如 pytest, uv sync)。

• 强制执行向后兼容性：确保依赖版本或 API 定义的变更不会静默破坏现有用户；要求针对版本转换提供明确的处理方式。

• 维护风格一致性：避免对主观风格挑剔，优先考虑项目既定的惯例、命名模式与以用户为中心的 API 设计。

• 战略契合：无论代码质量如何，若功能未使代码库朝向预定方向发展，应一律拒绝。

• 预期输入：拉取请求的代码差异 (diff)、相关文件片段与周边测试覆盖率背景信息。

• 提供输出：针对重构、架构调整与合并就绪所需的验证步骤提供具体、非通用的建议。