代码质量检查专业版
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @zcwl/code-quality-tool-pro。
技能介绍
要解决什么问题
企业研发团队在免费版「点文件扫一查」往往够不上 DevSecOps:要对照 OWASP Top 10 做可定位、可评级的漏洞清单,要对 上万文件 的仓库做批量审计,还要把结果以 SARIF / HTML / JSON 送进 Jira、GitHub Security 或合规归档。专业版就是在免费版规则之上,把这些能力串成一条可重复执行的审计链路,且 完全兼容 免费版 .codequality.yml,升级不用改配置。
技能如何工作
- OWASP Top 10 深度扫描:按 A01~A10 类别检查越权、弱加密、注入(SQL/命令/XSS)、不安全设计、配置错误、脆弱依赖、认证与会话、数据完整性、日志与 SSRF 等,输出风险等级与修复建议。
- 全项目批量审计:识别项目结构并套用对应规则;文档边界提到 超过 10,000 个文件 的超大型库需考虑分批或分布式策略。
- 自定义规则引擎:通过
input_params做规则的创建、查询、导出,配合版本化的.codequality.yml统一团队标准。 - 多格式报告与 CI/CD:支持 SARIF、HTML、JSON 等输出;请求体含
input(必填)、options、callback_url,适合异步流水线回调。
典型请求形态:input 传入代码路径或指令,options 控制模式与报告格式偏好。
适用边界与注意点
- 触发范围限于 代码生成、编程辅助、调试测试、开发部署 等研发场景,不适合当成通用办公自动化。
- 输入若含 SQL 注入样例关键字(如
' OR '1'='1)会按安全扫描逻辑处理,勿与生产密钥混在同一输入里。 - 正则规则过于复杂可能拖慢扫描;报告量极大(文档示例 >100 份)时注意存储与归档策略。
- 错误码含参数错误(1001)、扫描失败(1002)、依赖缺失(1003)、网络(1004)、代码库过大(1005);大型项目文档示例建议 分布式 与 增量 Git diff 审计 以控制耗时。
优选实践:分层扫描(先快扫阻断再深度)、规则入 Git、增量只扫变更文件、历史报告留存合规追溯。
使用场景
- 发版前对单体或多模块仓库跑 OWASP Top 10,生成带风险等级与修复建议的合规审计报告
- 在 GitLab/Jenkins 流水线里用 callback 异步拉取 SARIF,上传到缺陷跟踪或 Security 面板
- 多团队共用平台但规则不同,通过多租户配置为各组维护独立规则集与审查分配
- 合并请求阶段只对 Git diff 变更文件做增量扫描,避免全库 30 分钟以上长扫
适合人员
- 负责在 CI 里设质量门禁、要把 SARIF 对接 Jira/GitHub Security 的 DevSecOps 工程师
- 每季度牵头全项目安全审计、需自定义 `.codequality.yml` 与导出 HTML/JSON 归档的安全负责人
- 维护 10k+ 文件单体仓、要分批或增量策略控制扫描耗时的平台/基础架构同学
- 从免费版升级、希望保留现有规则又启用 OWASP 与批量审计的企业研发团队 Tech Lead