用途
Code Auditor 用于对代码库执行全面分析,覆盖架构、代码质量、安全、性能、测试和可维护性六个方面。适合在用户希望审计代码、分析代码质量、检查问题、审查代码库、查找技术债、进行安全审计或性能审查时使用。
主要能力
该技能分析以下六个维度:
- 架构与设计:整体结构与组织、使用的设计模式、模块边界与关注点分离、依赖管理、架构决策与权衡。
- 代码质量:复杂度热点(圈复杂度)、代码重复(DRY 违规)、命名约定与一致性、文档覆盖、代码异味与反模式。
- 安全:常见漏洞(OWASP Top 10)、输入验证与清理、认证与授权、密钥管理、依赖漏洞。
- 性能:算法复杂度问题、数据库查询优化、内存使用模式、缓存机会、资源泄漏。
- 测试:测试覆盖评估、测试质量与有效性、缺失的测试场景、测试模式与实践、集成测试与单元测试的平衡。
- 可维护性:技术债评估、耦合与内聚、未来变更的难易程度、新人上手友好度、文档质量。
使用方式
该技能采用以下方法:使用 Explore 代理(thorough 模式)进行探索;用 Grep 和 Glob 识别模式;读取关键文件进行详细分析;在可用时运行静态分析工具;最后将发现综合为可执行的报告。
彻底程度分为三档:
- 快速(15-30 分钟):仅高层级、关键问题。
- 标准(30-60 分钟):覆盖所有维度的全面分析。
- 深度(60 分钟以上):详尽分析并附详细示例。
输出格式为代码审计报告,包含:执行摘要(整体健康评分、关键问题数量、前三大优先事项);按类别列出的发现(按高、中优先级等分级,每条发现附文件与行号引用、影响说明、建议行动);按优先级排序的行动计划(快速见效项少于 1 天、中期改进 1-5 天、长期举措超过 5 天);以及指标(分析文件数、代码行数、测试覆盖率、复杂度热点数量)。
使用的工具包括:Task(Explore 代理)用于彻底探索代码库;Grep 用于模式匹配问题;Glob 用于按类型或模式查找文件;Read 用于详细文件分析;Bash 用于运行 linter 和覆盖率工具。
适用场景
适用于需要对代码库进行整体健康评估、查找技术债、进行安全或性能专项审查、评估测试覆盖与质量、以及规划质量改进工作的场景。可与 feature-planning(规划技术债削减)、test-fixing(处理发现的测试缺口)、project-bootstrapper(搭建质量工具)等技能集成。
限制
配置上可聚焦特定领域,例如仅安全审计、仅性能审计、仅测试评估或快速架构审查。成功标准要求覆盖全部六个维度、所有发现均附具体文件与行号引用、给出严重程度或优先级评级(Critical/High/Medium/Low)、提供可执行建议而非仅观察、给出修复的预估工作量,并同时包含快速见效项与长期改进。关于具体支持的编程语言、运行环境要求、收费方式等信息,资料中暂未提供。