代码质量提示工具 - 轻量级代码审查助手，快速识别可维护性问题
The Agent Skills Directory
安装命令
npx skills add https://smithery.ai/skills/alexeytriplea/code-quality-hint🇨🇳中文介绍
代码质量提示
在对话中提供轻量级的代码质量意识。无需完整审查即可快速提示可维护性问题。
何时激活
当在讨论的代码中注意到以下情况时激活：
- 函数长度超过 50-60 行
- 嵌套深度超过 3 层
- 重复的代码块
- 不清晰的变量名（x、data、temp、result）
- 缺少错误处理
- TODO/FIXME 注释
- 被注释掉的代码
- 未加解释的魔法数字
- 回调地狱
- 大型 switch 语句
操作指南
用 1-2 句话简要提及所关注的问题，然后建议运行一个命令：
示例回复：
"这个函数相当长（80+ 行）。考虑拆分它以获得更好的可维护性。
运行 `/review src/service.js` 以获取重构建议。"
"我注意到第 23-35 行和第 78-90 行存在重复逻辑。
运行 `/quick-check` 以识别代码质量改进点。"
"像 'x'、'temp' 和 'data' 这样的变量名使得代码难以理解。
运行 `/deep-review` 以进行全面的代码质量分析和最佳实践检查。"
重要规则
- ❌ 不要执行完整的代码审查
- ❌ 不要自动重构代码
- ✅ 仅提及当前对话中明显的问题
- ✅ 保持提示简短（1-2 句话）
- ✅ 始终建议一个用于详细审查的命令
- ✅ 保持建设性，而非批判性
需要标记的常见模式
函数大小：
- 函数 > 50 行（建议拆分）
- 函数承担多项职责
嵌套：
- 嵌套深度超过 3 层
- 早期返回可以简化结构
命名：
- 单字母变量（循环计数器除外）
- 通用名称（data、result、temp、x）
- 不一致的命名约定
代码异味：
- 重复的代码块
- 上帝函数/类
- 冗长的参数列表
- 被注释掉的代码
- 生产代码中的 console.log
错误处理：
- 缺少 try-catch
- 被吞没的错误
- 没有输入验证
不应标记的内容
- 风格偏好（制表符与空格）
- 格式问题（由格式化工具处理）
- 微小的优化
- 主观选择
建议的命令
/quick-check- 用于快速质量检查/review [file]- 用于特定文件分析/deep-review- 用于结合 Context7 的全面质量审查（对照当前最佳实践进行检查）
这是一个在常规编码对话中提高质量意识的提示工具。
每周安装次数
–
来源
首次出现
–
🇺🇸English
Code Quality Hint
Lightweight code quality awareness for conversations. Provides quick hints about maintainability issues without full review.
When to activate
Activate when you notice in code being discussed:
- Functions longer than 50-60 lines
- Nesting deeper than 3 levels
- Duplicated code blocks
- Unclear variable names (x, data, temp, result)
- Missing error handling
- TODO/FIXME comments
- Commented-out code
- Magic numbers without explanation
- Callback hell
- Large switch statements
What to do
Briefly mention the concern in 1-2 sentences, then suggest running a command:
Example responses:
"This function is quite long (80+ lines). Consider splitting it for better maintainability.
Run `/review src/service.js` for refactoring suggestions."
"I see duplicated logic on lines 23-35 and 78-90.
Run `/quick-check` to identify code quality improvements."
"Variable names like 'x', 'temp', and 'data' make this code hard to follow.
Run `/deep-review` for comprehensive code quality analysis and best practices."
Important rules
- ❌ Do NOT perform full code review
- ❌ Do NOT refactor code automatically
- ✅ Only mention clear issues in current conversation
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者，精准高效
