Agent Skills
返回列表
💻

CSpell 代码库拼写检查 CLI

开发编程 更新于 2026.08.29

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3c6cb52e/cspell-codebase-spell-checking-cli

技能介绍

解决的核心问题

代码库中的源代码、配置文件、文档常因拼写错误引入噪音——这些错误可能在代码审查时被忽略,或在CI输出中干扰排查效率,甚至影响文档准确性。尤其当团队协作或代理自动化处理代码时,零散的拼写错误会逐渐累积成隐性成本。

核心能力与工作逻辑

该技能基于cspell构建,专为开发场景优化:

  • 覆盖源代码、配置文件(如YAML、JSON)、文档(Markdown、TXT)等多类文本文件;
  • 内置适配开发场景的词典,减少专业术语、代码标识符的误判;
  • 支持忽略机制,可通过配置排除特定目录、文件或内容模式(如代码注释中的变量名);
  • 扫描后输出拼写错误的位置、错误词及修正建议,直接定位问题点。

使用时只需指定目标路径,工具会递归扫描并按规则匹配词典,最终生成结构化的错误报告,方便在CI流程中集成或本地手动修复。

适用边界与注意点

  • 需根据项目实际术语调整词典,避免通用词典对领域专有词的误判;
  • 忽略规则配置不当可能导致漏检或误检,建议结合项目目录结构调整忽略策略;
  • 仅处理文本类文件,二进制文件、图片等非文本内容不在检查范围内。

使用场景

  • 代码提交前扫描仓库中的源代码与注释,定位拼写错误并逐一修正,避免问题进入代码审查
  • 在 CI 流水线中加入拼写检查步骤,拦截提交中引入的拼写错误,减少构建日志噪音
  • 整理项目文档时检查 Markdown 文件的拼写,修正文档中的错误词汇
  • 维护含多个配置文件的项目时,统一检查 YAML/JSON 中的键名与注释拼写

适合人员

  • 后端工程师:希望提交前发现注释和文档中的拼写错误,避免在评审中被指出低级问题
  • 前端开发者:维护多个配置文件时需要确保键名和注释拼写无误
  • 技术文档作者:撰写 API 文档时需要检查英文单词拼写
  • CI 流水线维护者:需要在构建阶段集成拼写检查,防止错误进入主分支