Agent Skills
返回列表
💻

代码质量检查专业版

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @zcwl/code-quality-paid。

技能介绍

解决哪些实际问题

代码库中的安全漏洞、依赖过时、权限配置错误等问题,往往在手动审查或零散工具中被遗漏。当项目规模扩大到数万文件时,逐行检查耗时且难以覆盖 OWASP Top 10 等核心风险;不同团队的规则差异又导致审查标准不一致,CI/CD 流水线中的代码质量门禁也难以标准化落地。

技能如何工作

核心能力

  • OWASP Top 10 深度扫描:覆盖 A01-A10 全类别,提供漏洞定位、风险评级与修复建议,例如识别 SQL 注入、SSRF 等高危风险并输出可执行修复方向。
  • 全项目批量审计:自动识别项目结构,分批处理超量文件或大体积文件,避免系统崩溃,支持中大型项目的批量代码审查。
  • 自定义规则引擎:通过 .codequality.yml 配置企业专属规则,支持多租户独立规则集,兼容免费版配置格式。
  • 多格式报告输出:生成 audit.sarif(CI/CD 集成)、audit.html(人工审阅)、audit.json(程序处理)等报告,可直接对接问题跟踪系统。

关键使用步骤

  1. 配置规则:创建或沿用 .codequality.yml,定义扫描维度与严格度(strict/normal/loose)。
  2. 运行审计:通过 Agent 对话触发,输入待检查内容或指定项目路径,技能自动执行扫描。
  3. 查看报告:结果输出至 ./reports/ 目录,包含结构化报告与执行摘要,支持多格式按需使用。

适用边界与注意点

  • 输入限制:单次处理内容不超过 10,000 字符,并发请求不超过 10 个,超大规模项目建议分批执行。
  • 非人工决策场景:不适用于需要主观判断的复杂架构设计或业务逻辑评审,输出结果需结合人工复核。
  • 安全规则:所有 API Key 通过环境变量加载,日志自动脱敏;建议将配置文件加入 .gitignore,遵循最小权限原则,外部服务调用使用 HTTPS 加密传输。

使用场景

  • 对包含数万文件的大型项目进行全面安全审计,扫描 OWASP Top 10 风险并生成合规报告。
  • 在 CI/CD 流水线中集成代码质量检查,提交代码时自动执行扫描并输出 SARIF 格式报告。
  • 为多租户团队配置独立的代码审查规则,协同进行批量代码审查并分配跟踪问题。
  • 通过 .codequality.yml 自定义企业安全规则,对特定项目执行严格度可调的代码质量扫描。

适合人员

  • 后端开发工程师:需要在提交代码前自动发现 SQL 注入等 OWASP Top 10 高危漏洞。
  • DevSecOps 工程师:需要将自动化代码扫描接入 CI/CD 流水线并生成标准化的安全报告。
  • 技术团队负责人:需要为多团队配置统一的代码审查规则并跟踪分配审查问题。
  • 安全合规专员:需要对超大型代码库进行批量安全扫描以输出满足审计要求的合规报告。