Qcsd Quality Gates

QCSD Development 质量门禁技能

描述

AI辅助代码开发质量门禁与自动修复，适合个人开发者，保证代码质量，减少低级错误，结合腾讯全AI自动化研发实践改进。

功能

✅ 完整的6步质量门禁检查流程

✅ 自动治理常见开发问题（依赖错误/路径错误/语法错误/启动失败）

✅ 标准化项目文件结构（Next.js）

✅ 遵循 Conventional Commits 提交规范

✅ 适配个人开发者多项目并行开发场景

触发条件

每次开发新项目，必须执行质量门禁检查

每次输出代码给用户，必须过一遍门禁，自动修复问题再交付

用户要求检查质量，立即强制执行

质量门禁检查清单

1. 需求阶段

需求完整清晰，所有核心需求点都已记录

模糊歧义点已经澄清

需求范围符合「单人可开发」

识别核心高风险点：确认哪些功能出问题会影响核心流程，要求必须有对应测试覆盖

2. 架构设计阶段

技术选型适合个人开发，依赖最小化

文件结构符合标准化

数据库设计合理，索引正确

3. 编码阶段

TypeScript语法正确

所有import路径正确

变量函数命名清晰

没有冗余代码，注释够用

所有需求点都已实现

3.5 AI生成代码专项检查（如代码由AI生成，必检）

> 参考经验：AI生成代码容易"看起来能跑，实际埋坑"，这5关必须过

[ ] 覆盖面有效性：代码/测试保护的是核心高风险点吗？失败了会不会真影响业务？如果答不上来，重构

[ ] 语义化稳定性：定位器/步骤描述绑定业务语义，不靠nth-child、长CSS路径、位置猜测

[ ] 断言业务对齐：先验证业务状态（数据/接口/数据库），再验证UI提示，不只做"截图打卡"

[ ] 隐式依赖清理：不存在无理由固定时间等待，所有前置依赖显式说明

[ ] 失败可观测性：测试失败后有足够日志/证据能快速定位问题

4. 依赖检查

package.json 包含所有需要的依赖

没有多余依赖

版本选择稳定

5. 环境配置

.env.example 包含所有需要的环境变量

每个配置项有说明注释

6. 交付前整体检查

所有需求点都已实现

README.md 完整（介绍+配置+启动命令）

数据库初始化SQL完整

.gitignore 正确

可调试性检查：测试用例失败后能通过日志/截图快速定位问题，大段用例已拆分

自动修复能力

依赖安装报错 → 自动分析错误，修改版本或移除冲突依赖

import路径错误 → 自动查找正确路径修复

语法错误 → 自动修正语法和类型错误

启动失败 → 自动读取错误日志，定位问题修复

缺失文件 → 自动创建

AI代码坏味道自动治理：

- 扫描硬编码nth-child/长CSS定位器，提示替换为语义化写法（getByRole/getByTestId/getByLabel） - 发现无理由waitForTimeout()添加TODO注释，提示替换为状态断言等待 - 检测到只有UI可见性断言，提示补充业务状态断言 - 识别重复冗余定位，建议合并重构

作者

pejic

许可证

MIT