reviewing-code

reviewing-code 技能是专为评估软件合并请求 (Pull Request) 而设计的严格技术助理，特别适用于 FastMCP 生态系统和一般 Python 开发。它作为代码质量、可维护性和正确性的守门人，确保所有提议的变更符合项目标准和长期架构目标。该代理程序经过训练，优先提供可操作的建议而非一般性的批评，协助贡献者在维持友善与协作氛围的同时完善其实作。这对于使用模型上下文协议 (MCP) 并需要自动化代码审查初步阶段的首席开发人员、仓库维护者和工程团队来说非常理想。

• 评估 API 设计、命名规范以及对 Python 惯用语法的遵循情况。

• 监控依赖版本兼容性，特别是检查 pyproject.toml 的固定版本并确保 uv.lock 的一致性。

• 验证错误处理策略，并确保异常类型遵循既定的项目模式。

• 审查新工具、资源和协议特定功能的文件完整性。

• 通过检查新功能的测试覆盖率和边界情况来执行逻辑验证。

• 强制执行架构一致性，防止引入不必要的技术债务。

• 提供明确、可操作的建议，而非笼统的评论或关于代码风格的无意义挑剔。

• 使用决策框架：确认合并请求是否达成其目标、是否符合代码库方向，并评估其可维护性。

• 在拒绝代码时，提供具体的指导意见，说明如何调整实作以满足要求。

• 上下文感知至关重要：在提供批准之前，请务必先检阅相关测试和文档。

• 约束条件：优先关注功能与安全性；避免争论个人风格偏好。确保依赖升级等变更不包含来自自动包同步的无关噪音。始终将代码库视为一项需要为未来维护者保持稳定与清晰的长期资产。