Code Quality

代码质量标准 - 编码风格规范、安全指南和无障碍要求。适用于:(1) 编写新代码 (2) 代码风格/安全审查 (3) 实现UI/UX功能 (4) 处理安全问题 (5) 确保无障碍合规。涵盖命名约定、格式化、安全最佳实践(禁止泄露密钥/个人敏感信息)、无障碍标准(语义化HTML、键盘导航)和响应式设计。

lza6 5ee551c 3 files · 2.0 KB Updated

File contents

代码质量标准

编码风格

  • 命名规范: 变量/函数使用 camelCase;类/类型使用 PascalCase
  • 格式化: 4 空格缩进;目标行宽 ≤80 字符(合理换行)
  • 注释: 有意义且最新的注释;删除过时的注释
  • 安全: 绝不记录密钥/个人敏感信息;验证输入;默认最小权限原则
  • 错误/日志: 明确的错误类型;按级别记录结构化日志;提供可操作的消息

无障碍与用户体验质量

  • 优先使用语义化角色/标签;键盘导航和焦点顺序必须正常工作
  • 375, 768, 1024, 1440 像素断点处包含响应式检查,并附注说明/截图
  • 使用确定性的测试 ID;避免脆弱的 CSS/XPath 选择器

安全与合规防护

  • 代码、测试和截图中不得包含真实的凭证
  • 使用测试账号/固件数据;脱敏处理密钥
  • 遵循最小权限和输入验证原则
  • 在相关情况下,在 PR 中记录安全威胁考虑

参考文件

查看 references/coding-style.md 获取详细的风格指南、格式化规则和注释标准。

查看 references/security-checklist.md 获取安全验证清单、威胁建模和个人敏感信息处理指南。

查看 references/accessibility-standards.md 获取 WCAG 合规指南、语义化 HTML 模式和键盘导航测试。

lza6/claude-code-cli-config/tree/main/skills/code-quality commit 5ee551c8df

Frequently asked questions

npx skillmds@latest add lza6/code-quality