SuperAPI AI 工具集

coding-conventions

编程与开发

查看项目

更新于 10-16 08:10

技能介绍

用途:这是一个跨领域的技能,用于在智能体给出所有建议时统一执行安全、性能与质量规范,提供与行业标准对齐的可操作检查清单。

主要能力:安全方面覆盖与 OWASP Top 10 对齐的常见漏洞防护,适用于处理用户输入、认证、数据存储或外部通信的代码;性能方面覆盖前端、后端与数据库操作的优化模式;无障碍方面覆盖 WCAG 2.1 AA 合规,适用于所有面向用户的组件。

使用方式:在代码审查、功能设计、实现验证、错误处理策略设计以及审计现有系统质量缺口时使用。技能提供三份检查清单:checklists/security-checklist.md、checklists/performance-checklist.md、checklists/accessibility-checklist.md。

错误处理模式:在系统边界校验输入并立即失败;创建携带上下文的领域专用错误类型;不向用户暴露内部错误细节,内部记录完整上下文、外部返回净化后的消息;对非关键操作优雅降级,区分关键与可选;对瞬时失败(网络、限流)实现带最大尝试次数的指数退避。

最佳实践:先做安全检查再做性能优化;把无障碍作为默认而非事后补充;在代码审查过程中使用检查清单;对标准例外记录理由;尽可能自动化检查(lint、测试)。

限制:资料未提供安装命令、平台支持、收费方式或具体集成步骤。