用途
commitlint 是一个针对提交信息（commit message）的校验工具，本技能是面向 commitlint 的参考型技能，用于指导如何查阅和使用 commitlint 的官方文档与 API。它本身不是 commitlint 的安装包，而是一套按主题组织好的文档导航与参考结构，帮助使用者根据具体任务快速找到 commitlint 的相关说明。
主要能力（覆盖的文档主题）
根据提供的资料，该技能包含以下内容范围：
- guides（指南）：涉及安装、初始设置、Husky 集成、Git 钩子配置、CI 环境（如 GitHub Actions）中的 commitlint 设置、AI 代理（Claude Code、Copilot、Cursor）集成，以及交互式提交信息生成（prompt-cli）。
- reference（参考）：涵盖 CLI 选项、配置文件格式与全部选项、规则列表、规则设置（Level / Applicable / Value）、插件创建与注册、cz-commitlint prompt 设置。
- api（Node.js API）：@commitlint/lint、load、read、format，以及 lint 结果的格式化与输出。
- concepts（概念）：Conventional Commits 格式与 scope 处理、共享配置（shareable config）的创建与分发。
- support（支持）：错误解决与常见问题排查、版本升级、validate-commit-msg 迁移。
- samples（示例）：典型用法与配置示例。
- scripts（脚本）：安装、CLI 命令与校验命令相关说明。
此外，技能还涉及 rules 规则设置、plugins 插件、shareable-config 共享配置、@commitlint/config-conventional，以及与 Husky / lefthook / simple-git-hooks 等钩子工具的配合。
使用方式
技能以目录结构组织文档，使用者按以下步骤探索：
- 根据任务在映射表中确定所属类别（guides、reference、api、concepts、support、samples、scripts）。
- 查阅该类别目录下的 README.md 以定位目标页面。
- 读取该页面的 .md 文件获取详细信息。
目录结构如下：
- skills/commitlint/
- SKILL.md
- references/
- guides/（README.md、ai-agents.md、ci-setup.md、getting-started.md、local-setup.md、use-prompt.md）
- reference/（README.md、cli.md、community-projects.md、configuration.md、examples.md、plugins.md、prompt.md、rules.md、rules-configuration.md）
- api/（README.md、format.md、lint.md、load.md、read.md）
- concepts/（README.md、commit-conventions.md、shareable-config.md）
- support/（README.md、releases.md、troubleshooting.md、upgrade.md）
- samples/（README.md、getting-started.md、local-setup-husky.md、custom-rules.md、shareable-config.md、ci-github-actions.md、configuration-formats.md、validate-issue-reference.md）
- scripts/（README.md、install.md、setup.md、cli.md、validate.md、prompt.md）
任务与类别的映射关系包括：安装/初始设置/Husky 集成/Git 钩子设置对应 guides；CI 环境配置对应 guides；AI 代理集成对应 guides；交互式提交信息生成对应 guides；CLI 选项/配置文件格式对应 reference；规则列表与规则设置对应 reference；插件创建与注册对应 reference；cz-commitlint prompt 设置对应 reference；Node.js API 对应 api；lint 结果格式化对应 api；Conventional Commits 格式与 scope 对应 concepts；共享配置对应 concepts；错误与排查对应 support；版本升级与迁移对应 support；典型用法示例对应 samples；安装与 CLI 命令对应 scripts。
适用场景
- 需要为代码仓库规范化提交信息、统一提交历史格式。
- 需要在本地 Git 钩子（Husky、lefthook、simple-git-hooks 等）中校验提交信息。
- 需要在 CI 流程中校验提交信息。
- 需要编写或分发 commitlint 共享配置、自定义规则或插件。
- 需要以编程方式（Node.js API）调用 commitlint。
- 需要将 commitlint 与 AI 代理配合使用，或使用 prompt-cli 交互式生成提交信息。
限制
资料未提供该技能的具体版本号、依赖要求、安装命令的具体内容、具体规则取值示例的实际代码，也未提供收费、价格或平台限制等信息。使用者需按上述探索步骤实际读取对应文档文件才能获取完整细节。