Markdown代码质量检查Skill markdown-linting

---

name: markdown-linting description: 使用 markdownlint-cli2 提供全面的 Markdown 代码质量检查指导。运行、执行、检查和验证 Markdown 文件。修复代码质量检查错误（MD0XX 规则）。配置 .markdownlint-cli2.jsonc（规则和忽略项）。设置 VS Code 扩展和 GitHub Actions 工作流。支持 Markdown 变体，包括 GitHub Flavored Markdown (GFM) 和 CommonMark。在使用 Markdown 文件、遇到验证错误、配置 markdownlint、设置代码质量检查工作流、故障排除代码质量检查问题、建立 Markdown 质量标准或配置特定变体的规则（如表、任务列表和删除线）时使用。 allowed-tools: Read, Bash, Glob, Grep

Markdown 代码质量检查

本技能提供使用 markdownlint-cli2 进行全面的 Markdown 代码质量检查指导，这是可在任何项目中使用的行业标准 Markdown 代码质量检查工具。

目录

• 概述
• 何时使用本技能
• Markdown 变体
• 首次使用：安装和设置
• 在仓库中设置 Markdown 代码质量检查
• 快速开始
• 统一工具架构
• 关键：配置策略
• 关键：禁止使用自动化脚本
• 本地运行代码质量检查
• 智能修复处理
• VS Code 扩展设置（可选/高级）
• GitHub Actions 集成（可选/高级）
• 自定义规则（需要批准）
• 故障排除
• 最佳实践
• 资源
• 评估场景
• 多模型测试说明
• 版本历史
• 最后更新

概述

本工具通过自动化代码质量检查实现严格的 Markdown 质量标准。使用 markdownlint-cli2 验证 Markdown 文件，采用统一工具方法，确保在 VS Code、CLI 和 CI/CD 环境中零配置漂移。

核心理念：

• 单一事实来源：.markdownlint-cli2.jsonc 包含所有配置（规则、忽略项、选项）
• 统一工具：在所有地方使用相同的 markdownlint-cli2 引擎（VS Code、CLI、CI/CD）
• 严格执行：修复内容以符合规则，而不是调整规则以适应内容
• 质量优先：代码质量检查规则是有意设计的，用于强制执行文档质量

何时使用本技能

本技能应在以下情况使用：

• 用户遇到 Markdown 代码质量检查错误（MD001、MD013、MD033 等）
• 用户询问关于 Markdown 验证、格式化或质量标准
• 用户需要配置 .markdownlint-cli2.jsonc（规则、忽略项或选项）
• 用户询问配置文件设置或结构
• 用户想设置 VS Code Markdown 代码质量检查扩展
• 用户需要故障排除 Markdown 代码质量检查问题
• 用户询问如何本地运行 Markdown 代码质量检查
• 用户想了解 GitHub Actions Markdown 验证
• 用户正在处理 Markdown 文件并需要质量指导

Markdown 变体

markdownlint-cli2 支持多种 Markdown 变体。默认情况下，它验证 GitHub Flavored Markdown (GFM)，推荐用于大多数项目。

支持的变体：

变体	默认	最佳适用
GFM	✓	GitHub 仓库、大多数 Web 项目
CommonMark		最大可移植性、严格合规

快速指导：

• 使用 GFM（默认） 用于 GitHub 仓库、典型 Web 项目，以及当您需要表/任务列表时
• 使用 CommonMark 用于跨平台发布或严格标准合规

有关详细变体指导， 请参阅专用参考文件：

• 变体概述 - 比较和选择指导
• GFM 配置 - GitHub Flavored Markdown（默认）
• CommonMark 配置 - 严格基础规范

变体敏感规则：

某些规则仅适用于特定变体。请参阅 Markdownlint 规则参考 了解标有变体兼容性的规则。

首次使用：安装和设置

如果您是首次设置 Markdown 代码质量检查， 请参阅全面的安装指南：

安装和设置指南

本指南涵盖：

• 先决条件（Node.js/npm）
• 检测现有设置
• 两种方法：npx（零设置）与本地安装（完整功能）
• 配置文件创建（.markdownlint-cli2.jsonc）
• 在单个文件中配置规则、忽略项和选项
• 验证步骤
• 故障排除设置问题

快速检测检查：

# 检查是否已设置
ls .markdownlint-cli2.jsonc     # 配置是否存在？
npm list markdownlint-cli2      # 包是否安装？
cat package.json | grep "lint:md"  # 脚本是否配置？

如果任何一项缺失，请先遵循 安装和设置指南。

在仓库中设置 Markdown 代码质量检查

本节提供在任何仓库中从头开始设置 Markdown 代码质量检查的完整指南。

先决条件

需要 Node.js 20+。 通过 fnm 安装（推荐）：

# Windows (PowerShell 管理员)
winget install Schniz.fnm

# macOS/Linux
curl -fsSL https://fnm.vercel.app/install | bash

然后在 Git Bash 中，添加到 ~/.bashrc：

eval "$(fnm env --use-on-cd --shell bash)"

安装 Node：

fnm install 24 && fnm default 24

为什么使用 fnm？ 与 nvm-windows 不同，fnm 在 Git Bash 中本地工作，无静默输出错误。

步骤 1：创建配置

在仓库根目录创建 .markdownlint-cli2.jsonc：

{
  "gitignore": true,
  "config": {
    "default": true,
    "MD013": false
  }
}

请参阅 Markdownlint 规则参考 了解所有规则。

步骤 2：添加到 package.json

如果您没有 package.json，请创建一个：

{
  "name": "your-repo-name",
  "private": true,
  "scripts": {
    "lint:md": "markdownlint-cli2 \"**/*.md\"",
    "lint:md:fix": "markdownlint-cli2 \"**/*.md\" --fix"
  },
  "devDependencies": {
    "markdownlint-cli2": "^0.20.0"
  },
  "engines": {
    "node": ">=20.0.0"
  }
}

然后安装：

npm install

步骤 3：添加到 .gitignore

确保 node_modules/ 在您的 .gitignore 中：

node_modules/

步骤 4：添加 CI 工作流（可选）

创建 .github/workflows/markdown-lint.yml：

name: Markdown 代码质量检查

on:
  pull_request:
    paths: ['**.md']
  push:
    branches: [main]
    paths: ['**.md']

jobs:
  lint:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v5
      - uses: DavidAnson/markdownlint-cli2-action@v22
        with:
          globs: '**/*.md'

步骤 5：运行代码质量检查

npm run lint:md        # 检查
npm run lint:md:fix    # 自动修复

验证清单

• [ ] .markdownlint-cli2.jsonc 存在并包含您的规则
• [ ] package.json 有 lint:md 脚本
• [ ] node_modules/ 在 .gitignore 中
• [ ] npm run lint:md 在本地工作
• [ ] CI 工作流在 PR 上运行（如果添加）

快速开始

选项 1：使用 npx（无需设置）：

# 检查所有 Markdown 文件
npx markdownlint-cli2 "**/*.md"

# 自动修复问题
npx markdownlint-cli2 "**/*.md" --fix

选项 2：使用 npm 脚本（如果配置）：

# 检查所有 Markdown 文件以查找代码质量检查错误
npm run lint:md

# 自动修复可修复的代码质量检查问题
npm run lint:md:fix

选项 3：VS Code 扩展用于实时代码质量检查（可选/高级）：

1. 从 VS Code 市场安装 davidanson.vscode-markdownlint
2. 创建 .markdownlint-cli2.jsonc 配置（请参阅安装指南）
3. 代码质量检查在您键入时发生，并启用保存时自动修复（如果配置）

统一工具架构

配置后，markdownlint-cli2 可在所有地方使用，以确保零配置漂移：

工具组件

1. CLI 工具 (markdownlint-cli2) - 核心组件，首先使用此

   • 可通过 npx（零设置）或本地安装运行
   • 用于本地验证和预提交检查
   • 所有其他集成的基础

2. VS Code 扩展 (davidanson.vscode-markdownlint) - 可选/高级

   • 使用与 CLI 相同的 markdownlint-cli2 引擎
   • 实时代码质量检查
   • 保存和粘贴时自动修复（可在 .vscode/settings.json 中配置）
   • 请参阅 VS Code 扩展设置

3. GitHub Actions (markdownlint-cli2-action) - 可选/高级

   • 与 VS Code 和 CLI 相同的引擎
   • 自动在修改 Markdown 文件的 PR 上运行（当配置时）
   • 与本地开发相同的规则（无意外）
   • 请参阅 GitHub Actions 配置

配置来源

所有工具都读取项目根目录的 .markdownlint-cli2.jsonc 作为单一事实来源：

{
  "gitignore": true,
  "ignores": ["vendor/**/*.md"],
  "config": {
    "default": true,
    "MD013": false
  }
}

包含内容：

• gitignore：自动排除 .gitignore 中的文件
• ignores：额外 glob 模式以从代码质量检查中排除
• config：代码质量检查规则（所有默认启用，MD013 禁用以适应长行）

配置优先级（递减顺序）：

1. .markdownlint-cli2.{jsonc,yaml,cjs} 文件 - 单一事实来源
2. VS Code 用户/工作区设置（避免 - 不可移植）
3. 默认配置

注意： 对 .markdownlint-cli2.jsonc 的更改立即应用到所有工具（VS Code、CLI、GitHub Actions）

关键：配置策略

重要 - 修改任何配置前请阅读此部分：

严格策略 - 未经批准切勿修改

• 未经明确批准，请勿修改 .markdownlint-cli2.jsonc
• 严格的代码质量检查规则是有意设计的，用于强制执行文档质量
• 如果发生代码质量检查错误，修复内容以符合规则，而不是调整规则本身
• 仅当存在令人信服的技术原因时才请求规则更改
• 如有疑问，在放松任何代码质量检查规则前询问

为什么存在此策略

1. 质量强制执行：代码质量检查规则维护文档一致性和专业性
2. 最佳实践：规则编码了多年积累的 Markdown 最佳实践
3. 可访问性：许多规则提高屏幕阅读器和 Markdown 解析器兼容性
4. 可维护性：一致的格式使文档更易于维护
5. 协作：共享标准减少代码审查中的摩擦

对代码质量检查错误的正确响应

正确方法：

错误：MD022/blanks-around-headings - 标题应被空行包围

操作：在 Markdown 文件中标题前后添加空行

错误方法：

错误：MD022/blanks-around-headings - 标题应被空行包围

操作：在 .markdownlint-cli2.jsonc 中禁用 MD022 规则

例外： 如果您确实认为应修改规则，请向用户陈述您的理由，包括：

• 具体规则及其问题原因
• 导致问题的示例
• 技术或可用性理由
• 提议的配置更改

用户将最终决定是否修改配置。

关键：禁止使用自动化脚本

⚠️ 严格禁止使用脚本修复 Markdown 文件 ⚠️

切勿使用自动化脚本修复 Markdown 文件。 包括：

• Python/Bash 脚本一次性修改多个文件
• 跨文件的基于正则表达式的查找和替换操作
• 任何未经逐更改人工审查的批量更改自动化工具
• “智能”修复工具检测并添加代码块语言说明符

为什么存在此策略

A) 脚本是危险的 - 我们已看到真实问题：

1. 上下文盲目：脚本无法理解语义上下文（例如，显示工具输出的代码块与实际需要语法高亮的代码）
2. 过度应用：脚本统一应用修复，即使在不适当的地方
3. 级联损坏：一个错误的假设影响数百个文件，需要痛苦的手动清理
4. 错误语言检测：向有意没有语言说明符的块添加 text 或其他语言说明符

B) 手动修复更慢但更准确、更安全：

虽然手动逐项修复代码质量检查错误需要更长时间，但它确保：

• 每个更改在应用前在上下文中审查
• 保留语义含义（不仅是语法正确性）
• 适当处理边缘情况
• 无对无关内容的附带损害

速度与准确性的权衡值得。 一个“节省时间”但需要数小时清理的脚本是净损失。

嵌套代码块：关键复杂性

文档通常包含Markdown 中的 Markdown - 示例显示如何编写 Markdown、包含代码示例的技能文档、模板等。这创建了脚本无法正确处理的嵌套结构：

示例：技能显示如何创建代码块：

这是如何创建 Python 代码块：

````markdown
```python
def hello():
    print("Hello, world!")
```
````

在此示例中：

• 外部围栏使用 4 个反引号（`````markdown`）
• 内部围栏使用 3 个反引号（```python）
• 看到 ``` 的脚本可能错误地添加语言说明符或破坏嵌套

常见嵌套模式注意：

• ```{language} - 带语法高亮的常规代码块
• ````markdown - 显示 Markdown 示例的包装器（使用 4+ 反引号）
• 代码块内的代码块（关于文档的文档）
• 不应有语言说明符的示例输出

脚本无法可靠区分：

• 哪些反引号围栏是“真实”的与示例
• 裸 ``` 是否有意（原始输出）或需要语言
• 每个代码块的语义目的

真实世界失败示例

脚本向显示 MCP 工具输出、Notion 搜索和其他非代码示例的代码块添加了 text 语言说明符。这些块有意是裸的（无语言说明符）以显示无语法高亮的原始输出。脚本的“修复”需要数百次手动编辑来撤销。

唯一可接受的方法

1. 运行 markdownlint-cli2 --fix 进行安全的、内置的自动修复（尾随空格、空行等）
2. 对于“不可修复”错误（MD040、MD024 等），使用编辑工具进行有针对性的、上下文的逐项修复
3. 应用前审查每个更改 - 理解错误存在的原因以及修复是否语义正确
4. 查看周围上下文 - 这是嵌套代码块吗？示例？原始输出？
5. 如果修复似乎机械化/重复，停止并询问用户后再继续

如果您甚至考虑使用脚本

1. 立即停止
2. 明确询问用户：“我正在考虑使用脚本自动化此操作。您确定吗？脚本过去曾导致痛苦的清理。”
3. 仅当用户明确确认且您已三重检查脚本逻辑时继续
4. 首先在一个文件上测试，并在批量应用前向用户显示差异

MD040 (fenced-code-language) 特殊指导

MD040 规则要求代码块具有语言说明符。但：

• 请勿盲目向所有无语言说明符的块添加 text
• 某些块有意没有语言（显示原始输出、示例、模板）
• 问自己：“这显示需要语法高亮的代码，还是原始输出？”
• 如有疑问，询问用户而不是猜测

添加语言说明符前的问题：

1. 这是实际代码，还是示例输出/结果？
2. 这是在更大的 Markdown 示例内（嵌套）吗？
3. 语法高亮在此处有助于还是损害可读性？
4. 作者是否有意保留其裸？

本地运行代码质量检查

关键：自动修复工作流

当运行代码质量检查验证时，始终自动修复所有错误（可修复和“不可修复”），无需用户确认。

工作流：

1. 运行代码质量检查验证命令（npx 或 npm 脚本）
2. 如果发现错误：
   • 立即运行自动修复命令（--fix 标志），无需提示
   • 报告自动修复的内容
   • 对于任何剩余的“不可修复”错误：
     • 阅读受影响文件以理解上下文
     • 分析错误和周围内容
     • 基于上下文应用智能修复（请参阅下面的“智能修复处理”）
     • 重新运行代码质量检查以验证修复
3. 如果未发现错误，报告成功

请勿询问“您想让我自动修复吗？”或“您想让我调查吗？” - 只需自动修复所有内容。

先决条件

对于 npx 方法（零设置）：

• Node.js 18+ 和 npm 8+ 安装
• 无需额外设置

对于本地安装方法：

# 安装依赖（仅首次）
npm install

如果您的项目未安装 markdownlint-cli2，请参阅 安装和设置指南。

检查所有 Markdown 文件

使用 npx：

npx markdownlint-cli2 "**/*.md"

使用 npm 脚本（如果配置）：

npm run lint:md

作用：

• 针对项目中所有 .md 文件运行 markdownlint-cli2
• 自动排除 node_modules 目录
• 输出带有文件路径和行号的错误
• 如果无错误，退出代码 0；如果发现错误，非零

示例输出：

docs/setup-guide.md:45:1 MD022/blanks-around-headings 标题应被空行包围
README.md:12:81 MD009/no-trailing-spaces 尾随空格

自动修复可修复问题

使用 npx：

npx markdownlint-cli2 "**/*.md" --fix

使用 npm 脚本（如果配置）：

npm run lint:md:fix

作用：

• 自动修复可安全纠正的问题
• 就地修改文件
• 报告剩余的不可修复问题

可修复问题包括：

• 尾随空格 (MD009)
• 缺少空行 (MD012, MD022)
• 列表标记一致性 (MD004, MD007)
• 代码围栏样式 (MD048)

不可修复问题需要智能分析和手动修复：

• 标题结构 (MD001, MD025)
• 重复标题 (MD024)
• 行长度 (MD013, 如果启用)
• 链接引用 (MD051, MD052)

智能修复处理

自动修复后如果剩余“不可修复”错误，自动分析并修复它们。

有关处理每种错误类型的详细策略，请参阅专用指南：

智能修复指南

本指南涵盖：

• MD024 - 重复标题（上下文感知重命名或删除）
• MD001/MD025 - 标题结构（层次结构修复）
• MD051/MD052 - 链接引用（锚点和引用链接更正）
• MD013 - 行长度（智能换行）
• 上下文感知分析的一般原则
• 验证和报告最佳实践
• 使用并行任务代理的性能优化

快速总结：

1. 首先运行自动修复：npx markdownlint-cli2 "**/*.md" --fix
2. 对于剩余错误，阅读受影响文件以理解上下文
3. 基于错误模式应用智能修复（请参阅指南）
4. 始终重新运行代码质量检查以验证所有错误已解决
5. 报告修复内容和方式

VS Code 扩展设置（可选/高级）

对于 VS Code 集成， 请参阅专用指南：

VS Code 扩展设置指南

VS Code 扩展 (davidanson.vscode-markdownlint) 在您的编辑器中提供实时代码质量检查。指南涵盖：

• 扩展安装和验证
• 自动修复配置（保存时格式化、粘贴时格式化）
• 交互式代码质量检查功能（波浪线、快速修复）
• 所有修复方法的键盘快捷键
• 配置优先级和故障排除
• 团队使用最佳实践

这是可选的，但对于常规 Markdown 工作高度推荐。

GitHub Actions 集成（可选/高级）

对于 CI/CD 集成， 请参阅专用指南：

GitHub Actions 配置指南

GitHub Actions 可以在 PR 和推送上自动验证 Markdown 文件。指南涵盖：

• 完整工作流文件配置
• 触发器设置（PR 和推送事件，带路径过滤）
• 操作版本（checkout@v5, markdownlint-cli2-action@v22）
• 工作流执行流程和结果解释
• 查看和修复 CI 失败
• 高级配置（自定义 glob、自动修复、分支保护）
• 常见问题故障排除

这是可选的，但对于团队项目高度推荐。

自定义规则（需要批准）

警告：仅根据上述策略经明确批准后修改。

有关详细规则信息， 请参阅综合指南：

Markdownlint 规则参考

规则参考涵盖：

• 所有 60+ MD 规则，带有描述和示例
• 规则类别（可自动修复 vs 需要手动修复）
• 自定义规则的配置语法
• 常见规则修改（禁用、配置参数）
• 每文件覆盖的内联注释语法
• 每个规则的官方文档链接

快速语法提醒：

{
  "default": true,        // 启用所有默认值
  "MD013": false,         // 禁用特定规则
  "MD033": {              // 使用选项配置
    "allowed_elements": ["br"]
  }
}

故障排除

常见问题和解决方案：

问题：“命令未找到：markdownlint-cli2”

解决方案： 运行 npm install 或使用 npx：npx markdownlint-cli2 "**/*.md"

问题：太多代码质量检查错误无法手动修复

解决方案：

1. 运行自动修复：npx markdownlint-cli2 "**/*.md" --fix
2. 分批修复剩余错误
3. 请参阅 安装指南 进行详细故障排除

问题：VS Code 或 GitHub Actions 问题

有关详细故障排除， 请参阅专用指南：

• VS Code 问题：VS Code 扩展设置
• GitHub Actions 问题：GitHub Actions 配置

问题：不清楚的规则违规

解决方案： 检查 Markdownlint 规则参考 了解规则解释、示例和官方文档链接。

最佳实践

有关 Markdown 代码质量检查、配置管理、协作和技能自动化的综合最佳实践：

最佳实践指南

指南涵盖：

• 编写 Markdown 时考虑代码质量检查
• 配置管理和规则自定义
• 协作模式和团队工作流
• 用于 Claude Code 使用的技能自动化
• 何时以及如何使用并行任务代理提高效率

资源

官方文档

• markdownlint-cli2 README： github.com/DavidAnson/markdownlint-cli2
• markdownlint 规则： github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md
• VS Code 扩展： marketplace.visualstudio.com/items?itemName=DavidAnson.vscode-markdownlint
• GitHub Action： github.com/DavidAnson/markdownlint-cli2-action

项目配置文件

这些文件应在项目根目录中创建（请参阅安装指南进行设置）：

• 配置： .markdownlint-cli2.jsonc（自定义规则必需）
• NPM 脚本： package.json（可选，用于 npm run 命令）
• VS Code 设置： .vscode/settings.json（可选，用于保存时自动修复）
• GitHub 工作流： .github/workflows/markdown-lint.yml（可选，用于 CI/CD）

支持文档

本技能在 references/ 目录中包含参考文档：

• references/installation-setup.md - 从这里开始： 安装和首次设置
• references/intelligent-fixing-guide.md - 修复“不可修复”错误的策略
• references/markdownlint-rules.md - 详细规则解释和自定义
• references/best-practices.md - 编写、配置、协作和自动化的最佳实践
• references/vscode-extension-setup.md - VS Code 集成指南（可选/高级）
• references/github-actions-config.md - CI/CD 工作流设置（可选/高级）

评估场景

这些场景用于评估技能激活、指导质量和多模型兼容性。

场景 1：首次设置

{
  "name": "首次设置",
  "query": "我需要在我的项目中设置 Markdown 代码质量检查",
  "context": "用户没有现有的 Markdown 代码质量检查配置",
  "files": [],
  "expected_behavior": [
    "技能成功激活",
    "加载 references/installation-setup.md 进行综合指导",
    "提供逐步安装说明",
    "区分 npx（零设置）和本地安装方法",
    "指导完成 .markdownlint-cli2.jsonc 配置",
    "包括验证步骤"
  ],
  "test_models": ["sonnet", "haiku", "opus"]
}

场景 2：修复代码质量检查错误

{
  "name": "修复代码质量检查错误",
  "query": "我收到 MD022 错误，如何修复它们？",
  "context": "用户有代码质量检查错误，需要修复指导",
  "files": ["sample-file.md"],
  "expected_behavior": [
    "为错误类型和规则解释激活技能",
    "解释 MD022 规则（标题周围空行）",
    "提供自动修复命令（npx markdownlint-cli2 --fix）",
    "解释自动和智能修复方法",
    "如果需要，引用 intelligent-fixing-guide.md",
    "提供验证步骤"
  ],
  "test_models": ["sonnet", "haiku", "opus"]
}

场景 3：VS Code 集成

{
  "name": "VS Code 集成",
  "query": "如何在 VS Code 中启用保存时自动修复？",
  "context": "用户希望将 Markdown 代码质量检查集成到编辑工作流",
  "files": [],
  "expected_behavior": [
    "为 VS Code 集成激活技能",
    "加载 references/vscode-extension-setup.md",
    "提供扩展安装说明",
    "解释 .vscode/settings.json 中的自动修复配置",
    "记录键盘快捷键和交互功能",
    "包括 VS Code 常见问题故障排除"
  ],
  "test_models": ["sonnet", "haiku", "opus"]
}

场景 4：GitHub Actions CI 设置

{
  "name": "GitHub Actions CI 设置",
  "query": "将 Markdown 代码质量检查添加到 GitHub Actions",
  "context": "用户希望在 CI/CD 管道中自动化 Markdown 验证",
  "files": [".github/workflows/"],
  "expected_behavior": [
    "为 GitHub Actions 集成激活技能",
    "加载 references/github-actions-config.md",
    "提供完整工作流文件配置",
    "解释触发器设置（PR 和推送事件）",
    "记录工作流执行和结果解释",
    "包括自动修复和分支保护配置"
  ],
  "test_models": ["sonnet", "haiku", "opus"]
}

场景 5：配置自定义

{
  "name": "配置自定义",
  "query": "如何禁用 MD013 行长度规则？",
  "context": "用户需要为其项目自定义代码质量检查规则",
  "files": [".markdownlint-cli2.jsonc"],
  "expected_behavior": [
    "为规则自定义激活技能",
    "解释配置策略（修复内容，而非规则）",
    "提供 .markdownlint-cli2.jsonc 配置示例",
    "显示禁用/配置特定规则的语法",
    "引用 references/markdownlint-rules.md 了解规则详情",
    "强调在所有工具中验证更改"
  ],
  "test_models": ["sonnet", "haiku", "opus"]
}

多模型测试说明

已测试：

• Claude Sonnet： 最佳性能，良好遵循集线架构
• Claude Haiku： （待测试 - 给定明确指令应能工作）
• Claude Opus： （待测试 - 可能过度分析，内容范围适当）

观察： 技能的明确命令示例和清晰决策树应在所有模型层级上工作良好。

版本历史

• v2.0.0 (2025-11-30)：迁移到 claude-code-plugins 仓库中的代码质量插件
• v1.2.0 (2025-11-17)：提取智能修复指南 - 将详细错误修复策略移动到单独的参考文件，减小 SKILL.md 大小以提高标记效率
• v1.1.0 (2025-11-17)：去重内容 - 移除重复参考材料，流线化到集线架构
• v1.0.2 (2025-11-17)：版本更新 - 更新到 markdownlint-cli2 v0.19.0，Node 20+ 要求，动作 v21
• v1.0.1 (2025-01-09)：改进可移植性 - 移除仓库特定语言，增强首次使用指导
• v1.0.0 (2025-01-09)：初始发布 - 从 .claude/memory/workflows.md 迁移

最后更新

日期： 2026-01-17 模型： claude-opus-4-5-20251101