Agent Skills
返回列表
💻

代码质量检查专业版

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 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