代码质量
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @zcwl/code-quality-2。
技能介绍
代码质量不应只在代码评审时才被检查,而应在编写和修改阶段就持续落地。在实际开发中,常见痛点包括团队编码风格不一致导致的可读性下降、代码中潜在的安全漏洞,以及因缺乏统一标准而造成的维护成本攀升。尤其是在使用 AI Agent 辅助编码时,如果没有明确的规范约束,生成的代码风格就可能与项目现有标准脱节。
核心能力与工作方式
Code Quality 技能围绕编码风格、安全准则和无障碍要求三个维度构建。其核心机制是在 Agent 对话中接收代码内容和约束条件,自动执行规则匹配与检查,并输出问题列表和修复建议。
主要能力包括:
- 编码风格检查:提供统一的编码风格标准,自动检测代码中的违规并生成修正方案
- 安全准则检查:自动扫描代码中可能存在的安全漏洞,并关联修复建议
- 无障碍要求覆盖:确保生成的代码符合无障碍规范
- 多种文件格式处理:支持读取、解析和写入多种文件格式
- API 集成与命令执行:通过标准接口调用外部服务,在安全沙箱中执行系统命令
以常见流程为例,调用时可以通过行内代码指定mode参数(如json、text或markdown),将待处理内容填入content字段,技能会根据style配置生成对应风格的输出结果。典型场景包括编码执行、质量检查和风格检查,分别对应不同的输入输出模式。例如,质量检查场景下,输入为代码库与标准配置,输出为问题列表与修复建议。
适用边界与注意事项
该技能不适用于需要人工判断的复杂决策场景。其运行依赖 Agent 内置的 LLM 能力,且需在满足依赖说明的环境中启动。配置参数错误或运行环境不满足要求时,会触发相应的错误处理流程。建议在正式接入前确认环境要求,并妥善保管 API Key,避免泄露到版本控制系统中。
使用场景
- 团队协作开发时统一编码风格,自动检测并修正代码格式不一致问题
- 修复代码漏洞时自动关联漏洞库,输出安全修复建议
- 为关键功能模块生成单元测试用例,验证边缘场景输入
- 分析函数执行耗时,定位性能瓶颈以便优化代码执行速度
适合人员
- 后端工程师,需要规范团队代码库风格并自动扫描安全漏洞
- 前端开发者,希望保持一致的编码标准和组件无障碍要求
- 测试工程师,负责生成单元测试覆盖关键逻辑并输出测试报告
- 技术负责人,关注代码质量基线和项目整体安全可靠性指标