核心功能
CANN Review 是一款面向 GitCode 平台 CANN（华为昇腾异构计算架构）项目的专业代码审查技能，专为 C/C++/Python 代码工程场景设计。该技能通过 GitCode API 实现全自动化 PR 审查流程，无需浏览器自动化，确保操作稳定性和可靠性。
显著优点
智能化审查维度：构建三层审查体系——内存安全（malloc/free 匹配、RAII 模式、异常路径释放）、安全漏洞（缓冲区溢出、空指针解引用、整数溢出）、代码可读性（命名规范、注释完整性、结构清晰度）。每个维度配备标准化检查清单，审查结论结构化呈现。
高效 API 驱动架构：完全基于 GitCode REST API 实现，规避浏览器自动化的稳定性风险。支持 PR 信息获取、文件 diff 拉取、评论自动发布全流程，响应速度显著优于传统自动化方案。
灵活触发机制：支持手动触发（用户提供 PR URL）和定时自动扫描双模式。自动模式下可批量扫描多仓库、生成待审查队列、逐个执行审查并输出汇总报告，适配 CI/CD 流水线集成。
专业报告生成：采用 Markdown 结构化模板，审查结论前置突出，涵盖严重性评级、代码质量、内存安全、安全性、测试覆盖等多维度评估，附带改进建议与代码亮点认可，体现建设性审查文化。
企业级安全设计：API Token 支持环境变量、配置文件、交互式向导三种配置方式，配置文件权限强制 600；明确禁止命令行直接传递 Token 防止 history 泄露；内置 429 频率限制处理与 JSON 转义安全机制。
潜在局限
平台绑定性：仅适配 GitCode 平台 CANN 项目，GitHub/GitLab 等其他代码托管平台需架构改造。
语言覆盖范围：针对 C/C++/Python 优化，对 Java/Go/Rust 等语言的审查深度有限，部分安全检查规则不适用。
API 依赖风险：审查功能完全依赖 GitCode API 可用性，平台服务中断或 API 变更将直接影响技能运行。
Token 管理成本：需用户自行申请和管理 Classic Token（需 api + write_repository 权限），企业场景下存在权限审计与轮换成本。
审查深度边界：基于静态规则匹配和模式识别，无法替代动态分析工具（如 Valgrind、ASAN）的运行时检测能力，复杂逻辑缺陷仍需人工复核。
适合人群
- CANN 生态开发者及代码审查员
- 昇腾 AI 处理器相关项目维护团队
- 寻求自动化代码质量门禁的 DevOps 工程师
- 内存安全与系统安全敏感型 C/C++ 项目团队
常规风险
| 风险类别 | 说明 | 缓解措施 |
|---------|------|---------|
| Token 泄露 | API Token 配置不当导致未授权访问 | 强制 600 权限、禁止命令行传参、支持环境变量隔离 |
| 误报/漏报 | 静态规则局限导致审查结论偏差 | 报告明确标注 AI 生成、建议人工复核 |
| 频率限制 | 批量审查触发 API 限流 | 内置延迟机制、分页处理、队列化执行 |
| 已合并 PR 评论失败 | 项目设置禁止合并后评论 | 状态预检、优雅跳过、日志记录 |
| JSON 注入 | 特殊字符导致评论发布失败 | 自动转义处理、Python json.dumps 备选方案 |