Code Quality — 代码质量标准

--- name: code-quality zh_name: 代码质量标准 description: Coding style standards, security guidelines, and accessibility requirements. Use when (1) Writing new code, (2) Reviewing code for style/security, (3) Implementing UI/UX features, (4) Addressing security concerns, (5) Ensuring accessibility compliance. zh_description: 提供代码风格标准、安全指南和可访问性要求。适用于编写新代码、代码审查、UI/UX 实现、安全问题解决和可访问性合规。 Covers naming conventions, formatting, security best practices (no secrets/PII), accessibility standards (semantic HTML, keyboard nav), and responsive design. --- # 代码质量标准 ## 编码风格 * **命名：** camelCase for vars/functions；PascalCase for classes/types * **格式化：** 4 空格缩进；目标 ≤80 字符（有意义地换行） * **注释：** 有意义、当前；删除过时注释 * **安全：** 永不日志机密信息/PII；验证输入；默认最小权限 * **错误/日志：** 显式错误类型；按级别结构化日志；可执行消息 ## 可访问性与 UX 质量 * 优先使用语义角色/标签；键盘导航和焦点顺序必须有效 * 包含 **375, 768, 1024, 1440** 的响应式检查，附笔记/截图 * 使用确定性测试 ID；避免脆弱的 CSS/XPath ## 安全与合规防护 * 代码、测试或截图中不包含真实凭据 * 使用测试账户/固定点；编辑机密信息 * 遵循最小权限和输入验证 * 在 PR 中记录相关威胁考虑 ## 参考文件 请参阅 `references/coding-style.md` 获取详细样式指南、格式化规则、注释标准。 请参阅 `references/security-checklist.md` 获取安全验证清单、威胁建模、PII 处理指南。 请参阅 `references/accessibility-standards.md` 获取 WCAG 合规、语义 HTML 模式、键盘导航测试指南。