SuperAPI AI 工具集

codeguard-markdown

编程与开发

查看项目

更新于 10-15 21:48

技能介绍

用途:把 Markdown 项目的“看起来没问题”变成可重复的工具证据,用于 lint、格式检查、自动修复和提交前质量验证,也用于处理 npx --no-install markdownlint-cli2 相关失败。

主要能力:识别 .md、.markdown 工作区;执行 npx --no-install markdownlint-cli2 并保留退出码、作用域和工具版本;区分格式、静态规则、配置、依赖与环境类失败;用 markdownlint-cli2 --fix 处理可逆问题并复扫;把本地结果与 CI、构建、测试证据分层汇报。

使用方式:先确认仓库根或模块根及项目配置,探测工具 npx --no-install markdownlint-cli2 --version,再只读检查 npx --no-install markdownlint-cli2,按失败类型处理,仅对可安全修复项执行 markdownlint-cli2 --fix,随后复跑同一 lint 命令并运行项目已有测试与构建。工具准备命令为 npm install -g markdownlint-cli2。

适用场景:用户要求检查或修复 Markdown 规范;AI 修改 .md 后需提交前验证;CI 出现相关失败;需判断问题能否自动修复。

限制:不把 formatter 通过当作编译、测试或安全审计通过;不静默安装工具、升级依赖或修改团队规则;不用 suppress、ignore 或调高阈值掩盖问题;缺少工具或配置时不得声称通过,应标为 UNVERIFIED。不适用于语言语法学习、依赖漏洞与安全审计等任务。本技能不收集、上传或存储用户代码和凭据,默认只读本地配置并运行本地工具,不联网安装依赖;自动修复前先检查 diff,破坏性或大范围修改需用户明确确认。