代码质量守卫 (quality_guard)
此 Skill 用于在提交前审计代码,确保方案和代码实现不偏离项目核心原则。
核心职责
- •原则一致性: 检查是否有过度工程化 (Over-engineering)。
- •规范检查: 确保回复和注释使用中文,方案符合“实施计划”模板。
- •事实核查: 验证逻辑是否存在明显的表象修补而非根源解决。
执行步骤
1. 扫描暂存区/当前文档
在生成 gitmoji_commit 建议之前,运行此检查:
- •分析
git diff --cached。 - •检查新增注释的语言(应为中文)。
2. 识别风险
若发现以下情况,必须主动指出并建议修改:
- •过度设计: 引入了当前任务不需要的复杂抽象或第三方库。
- •打补丁行为: 通过多层 if-else 解决问题,而非优化模型或底层逻辑。
- •语言违规: 发现了英文注释(除非是代码本身需要的标识符)。
3. 给出反馈
反馈应保持“事实导向”,直接指出问题点。
示例: "检测到
AuthService中引入了不必要的递归,违反了 KISS 原则。建议改为简单的循环实现。另外,第 45 行注释为英文,请改为中文。"
注意事项
- •不仅检查代码,也要检查 Agent 自身的回复是否符合
rules.md中的格式要求。 - •允许合理的防御性编码,但必须以维护性为先。