Agent Skills
返回列表
代码细节错误诊断

代码细节错误诊断

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_68eef956/code-detail-error-diagnosis

技能介绍

痛点:那些肉眼难辨的“细节杀手”

在编写 Java、Scala、Python 或 Linux 运维脚本时,你是否遇到过代码逻辑清晰,却反复抛出 SyntaxError 或 command not found 的尴尬场景?这类问题往往源于空格缺失、大小写错误、中英文标点混用或括号不匹配等“细节杀手”。肉眼排查不仅耗时,还容易遗漏隐藏在长串代码中的微小瑕疵。

核心机制:分类扫描与交叉验证

该 Skill 不参与业务逻辑审查,而是专职充当代码的“显微镜”。其工作流程分为四个关键步骤:

  • 解析与分类:识别输入的代码片段或命令,并加载内置的错误模式库。
  • 五维细节扫描:按照空格 (SP)、大小写 (CC)、括号 (BR)、符号 (SY)和混淆 (CF) 五大分类进行逐行排查,精准定位如 int[]data 或 if x = 5 这类典型错误。
  • 交叉验证:结合用户提供的报错信息进行比对,确保诊断结果有据可依,绝不编造错误原因。
  • 报告输出:生成包含行号定位的结构化报告,并输出仅修改细节的修正后代码。

适用边界与注意点

本工具严格遵循“仅改细节,不动逻辑”的原则。它非常适合提交前的自查或基础语法排错,但无法解决算法设计缺陷、复杂并发问题、环境依赖缺失(如 ModuleNotFoundError)或内存溢出等运行时深层故障。对于涉及重构或业务逻辑优化的需求,仍需依赖开发者的人工介入。

使用场景

  • 写完Spark的Scala代码提交作业时频繁报错,需要快速排查是否是因为大小写写错或漏写了分号。
  • 执行Linux运维命令时提示找不到文件或参数错误,需要定位是否是因为命令与参数间漏了空格。
  • Python脚本运行抛出SyntaxError,需要逐行检查控制结构末尾是否漏了冒号或Tab与空格混用。

适合人员

  • 计算机专业学生:写完Java或Scala期末作业后,提交前需要自查空格和括号等细节以免编译失败。
  • 初中级大数据开发工程师:编写PySpark任务遇到运行报错时,需要快速定位缩进或符号混用问题。
  • 运维实习生:在服务器上执行复杂的Linux管道命令时,需要排查因中英文标点或参数顺序导致的错误。