pi-commit-lint
一个可配置的提交信息格式校验工具。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pi-commit-lint。 它的用途是：一个可配置的提交信息格式校验工具。 完整的 Skill 内容见：https://321skill.com/skills/pi-commit-lint/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'帮我校验这条Git提交信息是否符合Conventional Commits规范："fix: 修复用户中心头像上传失败的问题"'，它会按照预设的提交格式规则校验内容，若符合规范则返回通过提示，若不符合则指明具体问题并给出修改建议。
对AI说：'帮我批量校验当前项目最近20条Git提交记录，排查所有不符合规范的提交信息'，它会扫描指定范围的提交历史，逐条校验格式合规性，整理输出不合规条目及对应的整改提示。
对AI说：'帮我把pi-commit-lint集成到这个项目的commit-msg hook里，用默认的Conventional Commits校验规则就行'，它会自动生成对应的配置文件和Git Hook脚本，完成提交时自动校验的接入配置。
介绍
在团队协作开发中，杂乱无章的 Git 提交信息会严重影响代码历史的可读性和自动化工具（如生成变更日志）的运行。pi-commit-lint 正是为了解决这一问题而生，它能够根据团队自定义的规则，自动校验每一次提交信息是否符合业界广泛采用的 Conventional Commits 规范，确保提交历史的清晰与一致。
使用方式非常便捷，开发者可以将其集成到项目的 Git Hook（如 commit-msg hook）中，在每次提交时自动触发检查；也可以通过命令行工具手动对单条或批量提交信息进行校验。它支持通过配置文件灵活定义校验规则，包括提交类型、作用域、标题长度等，以适应不同项目的需求。
这个工具主要面向采用 Git 进行版本控制、且希望提升提交信息规范性的开发团队或个人。无论是开源项目维护者，还是企业内部的中大型项目团队，都可以通过引入此工具来统一提交风格，降低沟通成本。
建议在项目初期或制定代码规范时引入此工具，并通过团队文档明确约定具体的提交格式规则。注意，它主要进行格式校验，不涉及代码逻辑或功能正确性的检查，因此应与代码审查等流程配合使用。
核心特点
核心区别在于其高度可配置性，允许团队深度定制校验规则，而非强制使用一套固定的规范；同时，它设计为轻量级的校验工具，易于集成到现有的 Git 工作流中，对开发过程侵入性小。
注意事项
不适合仅需简单格式提醒、或项目历史已极其混乱且不打算重构提交信息的场景。
常见问题
如何集成到 Husky 钩子中？
在 Husky 的 commit-msg 钩子脚本中调用 npx pi-commit-lint 命令即可。
支持校验合并提交（merge commit）吗？
通常默认配置会跳过合并提交，但可以通过规则配置来控制。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pi-commit-lint/raw/index.md 读取 pi-commit-lint 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pi-commit-lint/raw/index.md（查看排版版本）