yotta-code-quality · 元质

面向 **Cursor / Codex / Claude Code / 通用 Agent** 的结对代码审查技能。把「代码质量审查」沉淀为可复用、可配置、有方法论支撑的技能，让智能体在交付前像资深工程师一样通读代码、定位劣化，并给出带依据的修复方案。

一句话定位：**先诊断、再修复，只出报告不动代码。**

核心价值

• 有依据，不拍脑袋。 方法论蒸馏自 12 本经典软件工程著作（Fowler《重构》、McConnell《代码大全》、Ousterhout《软件设计哲学》、Evans《领域驱动设计》等），每条发现都锚定到具体书籍原则或坏味道。
• 铁律（Iron Law）防灌水。 每条发现必须走 症状 → 根源 → 后果 → 修复（Symptom → Source → Consequence → Remedy），缺「后果」或「修复」的发现一律视为噪声，不会报出来。
• 默认只读、先诊断后修复。 只出审查报告，不动代码；除非你明确要求 --fix（按 Remedy 修）。
• 健康分（Health Score）可追踪。 每次审查给出 0–100 扣分指数（刻意定义成单次扣分指数，而非绝对评级），支持跨次趋势比较。
• 按需加载，不臃肿。 按模式（Quick / PR / 架构 / 测试 / 发布）只读需要的参考文件，避免把整套方法论塞进上下文。
• 跨智能体 + 零依赖。 纯文件技能，Cursor / Codex / Claude Code / 通用 Agent 均可用；不引入任何运行时依赖。

核心优势

维度	yotta-code-quality	说明
方法论	12 本经典 SE 著作 + 坏味道	每条发现可溯源，非经验主义空谈
发现结构	Iron Law 四段式	强制带「后果 + 修复」，避免无效吐槽