AgentSkillsCN

quality_guard

检查代码变更是否符合 .agent/rules.md 定义的规范(KISS, 中文注释, 事实导向)。

中文原作
SKILL.md
--- frontmatter
name: quality_guard
description: 检查代码变更是否符合 .agent/rules.md 定义的规范(KISS, 中文注释, 事实导向)。

代码质量守卫 (quality_guard)

此 Skill 用于在提交前审计代码,确保方案和代码实现不偏离项目核心原则。

核心职责

  1. 原则一致性: 检查是否有过度工程化 (Over-engineering)。
  2. 规范检查: 确保回复和注释使用中文,方案符合“实施计划”模板。
  3. 事实核查: 验证逻辑是否存在明显的表象修补而非根源解决。

执行步骤

1. 扫描暂存区/当前文档

在生成 gitmoji_commit 建议之前,运行此检查:

  • 分析 git diff --cached
  • 检查新增注释的语言(应为中文)。

2. 识别风险

若发现以下情况,必须主动指出并建议修改:

  • 过度设计: 引入了当前任务不需要的复杂抽象或第三方库。
  • 打补丁行为: 通过多层 if-else 解决问题,而非优化模型或底层逻辑。
  • 语言违规: 发现了英文注释(除非是代码本身需要的标识符)。

3. 给出反馈

反馈应保持“事实导向”,直接指出问题点。

示例: "检测到 AuthService 中引入了不必要的递归,违反了 KISS 原则。建议改为简单的循环实现。另外,第 45 行注释为英文,请改为中文。"

注意事项

  • 不仅检查代码,也要检查 Agent 自身的回复是否符合 rules.md 中的格式要求。
  • 允许合理的防御性编码,但必须以维护性为先。