pi-conventions
通过结构与命名策略强制统一代码规范
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pi-conventions。 它的用途是：通过结构与命名策略强制统一代码规范 详细介绍见：https://321skill.com/skills/pi-conventions/ 请根据该页面的说明完成安装。
使用示例
“检查当前项目的 src/components 目录下所有文件是否遵循我们的 kebab-case 命名约定。”，它会调用 pi-conventions 扫描该目录，并列出所有不符合命名规则的文件。或者，在配置好提交钩子后，当你尝试提交一个名为 `MyComponent.tsx` 的文件时，它会自动拦截并提示应改为 `my-component.tsx`。
介绍
pi-conventions 是一个用于在代码库中强制执行统一约定的 Pi 包。它主要解决团队协作中因代码结构、文件命名、变量命名等不一致而导致的代码混乱、可读性差和维护成本高的问题。通过预定义或自定义的策略，它能自动检查并约束代码的组织和命名方式，确保项目遵循既定的规范。
使用 pi-conventions 通常需要将其作为开发依赖项安装到项目中。开发者可以配置具体的规则，例如指定目录结构、文件命名模式（如使用 kebab-case）、禁止特定的命名前缀等。在开发流程中，它可以集成到构建或提交钩子中，自动对代码进行扫描和校验，发现违规时给出提示或阻止提交。
这个工具非常适合需要长期维护的中大型项目团队、对代码整洁度有较高要求的开源项目维护者，以及希望在新项目中快速建立并自动化执行编码规范的开发者。它尤其能帮助团队新成员快速适应项目规范，减少代码审查中关于格式和命名的争论。
建议在项目初期就引入 pi-conventions，并与团队成员共同商定规则集。注意，它主要关注结构和命名层面的约定，不涉及代码逻辑或风格（如缩进、分号），因此通常需要与 ESLint、Prettier 等工具配合使用。对于已有大量历史代码的项目，建议逐步启用规则，避免一次性引入导致大量报错。
核心特点
与 ESLint 等主要检查代码语法和风格的 linter 不同，pi-conventions 专注于代码库的宏观结构和文件/目录命名约定，填补了项目级架构规范自动化的空白。它通过 Pi 平台集成，能更直接地与 AI 辅助开发流程结合，实现声明式的规范管理。
注意事项
不适合用于检查代码内部的逻辑错误、代码风格细节（如缩进、空格）或运行时性能问题。
常见问题
pi-conventions 和 ESLint 有什么区别？
ESLint 主要检查代码语法和风格，pi-conventions 则强制项目结构和文件/目录命名规范，两者互补。
如何自定义命名规则？
在项目配置文件中定义策略，例如指定文件必须采用 kebab-case 或禁止特定前缀。