pragmatic-clean-code-reviewer
一个遵循《代码整洁之道》等经典原则的、可严格分级的代码审查助手。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pragmatic-clean-code-reviewer。 它的用途是：一个遵循《代码整洁之道》等经典原则的、可严格分级的代码审查助手。 完整的 Skill 内容见：https://321skill.com/skills/pragmatic-clean-code-reviewer/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘请帮我审查一下这段用户登录模块的代码。’ 它会首先引导你完成项目定位问卷，例如询问代码是内部使用还是对外发布、期望标准等。确定严格等级（如L3）后，它会基于《代码整洁之道》等原则，系统检查函数的单一职责、命名清晰度、异常处理、依赖关系等，并给出分级的改进建议。
介绍
这个 Skill 旨在解决开发者在代码审查、重构和架构审计时缺乏统一、客观标准的问题。它并非简单的代码格式化工具，而是专注于逻辑、设计和最佳实践的深度分析。
使用方式非常结构化。在开始审查前，它会通过一个包含“使用者”、“期望标准”和“关键性”的问卷，将项目定位到从 L1（实验级）到 L5（核心级）五个严格等级之一。不同等级对应不同的审查深度和容忍度，确保审查建议与项目实际需求相匹配。
它非常适合所有需要进行代码质量把控的开发者，无论是个人项目维护者、团队技术负责人，还是开源项目的贡献者。尤其适合在准备合并 PR、重构遗留代码或进行架构决策时，需要一个系统化、可重复的审查流程的场景。
与同类代码审查工具相比，其核心区别在于引入了“项目定位”和“严格度分级”机制。它不是一刀切地给出建议，而是根据项目的受众、目标和关键性动态调整审查的严格程度，使得建议更具上下文相关性和实用性，避免了过度审查或审查不足的问题。
核心特点
核心区别在于其独特的“3+4+2问卷系统”和五级严格度（L1-L5）校准机制，能根据项目具体场景（如个人实验、团队内部工具、对外开源核心库）动态调整审查标准，使建议更贴合实际，而非僵化地套用单一规则。
注意事项
不适合用于审查非代码类文本（如文档、注释的文学性），或期望其直接执行代码格式化、自动修复的场景。
常见问题
这个 Skill 和普通的代码格式化工具（如 Prettier）有什么区别？
它不处理代码格式，而是专注于逻辑设计、架构和代码气味（Code Smell），遵循 Clean Code、SOLID 等原则进行深度审查。
如果我不知道怎么回答定位问卷怎么办？
可以直接说“直接审查”或跳过，Skill 会默认使用 L3（团队标准）级别进行审查，并在报告中注明。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pragmatic-clean-code-reviewer/raw/index.md 读取 pragmatic-clean-code-reviewer 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pragmatic-clean-code-reviewer/raw/index.md（查看排版版本）