SuperAPI AI 工具集

zig-code-review

测试与质量

查看项目

更新于 10-15 21:48

技能介绍

用途:该技能用于审查 Zig 项目代码,适合在审查 PR、commit、diff,审计项目编码规范与模块结构,或作为合并/发布前的质量门禁时调用。

主要能力:检查代码风格与一致性(项目约定与 Zig 风格指南);检查正确性与安全性,包括错误处理、内存、生命周期与资源清理;检查代码结构与逻辑清晰度,如函数/模块职责与控制流;检查 Zig 版本兼容性陷阱,如构建系统、I/O、容器初始化及已移除特性。

使用方式:需提供待审查代码(diff、文件列表或代码片段)以及目标 Zig 版本。工作流为:确定审查范围;通过 zig version 或项目配置确认版本,并加载 references/ 下匹配的参考文件;执行机械检查(zig fmt 格式、已移除 API、构建配置);审查逻辑与正确性;审查资源与内存;按输出模板给出结构化反馈。输出模板包含摘要、阻塞性问题(位置→症状→风险→建议修复)、非阻塞改进、Zig 版本说明与可选补丁建议。

适用场景:Zig 开发者提交前自检或审查团队 PR;项目维护者统一团队编码规范;CI 流水线作为代码质量门禁。可自定义审查严格度(strict/standard/light)、关注领域(security/style/full)与输出格式。

限制:需要待审查代码和目标 Zig 版本;不负责编写新代码(应使用 zig-0.16 技能),也不审查非 Zig 代码。仅提供建议,不直接自动修复。该技能不收集、存储或传输用户数据,审查完全在本地对话中进行。审查前须确认版本,不同 Zig 版本 API 差异显著;应优先遵循项目既有约定,避免过度建议。