@cuzfrog/module-gates
通过强制代码模块边界，控制代码库的熵增。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@cuzfrog/module-gates。 它的用途是：通过强制代码模块边界，控制代码库的熵增。 完整的 Skill 内容见：https://321skill.com/skills/cuzfrog-module-gates/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请为订单服务模块添加一个查询用户历史订单的功能。”，AI在生成代码时会自动遵循你预设的模块边界规则，只从允许的模块（如用户模块、数据库模块）导入依赖，而不会错误地引入支付模块的内部类，从而保持架构的整洁。或者，当你试图让AI在两个被规则禁止直接通信的模块间建立调用时，AI会提示你违反了模块边界，并建议通过桥接或调整设计来解决。
介绍
这个Skill旨在解决大型或协作项目中，代码模块间依赖关系混乱、边界模糊导致的“熵增”问题，即代码结构随时间推移变得难以理解和维护。它通过定义和强制执行模块间的访问规则，防止模块间产生不必要或混乱的耦合，从而保持代码库的清晰度和可维护性。
使用方式主要是通过配置规则来声明哪些模块可以相互调用，哪些需要隔离。它提供了与Pi和Claude Code集成的桥梁，使得你可以在这些AI编码助手中直接应用这些边界规则，例如在生成或修改代码时，AI会遵循预设的模块访问约束，避免引入违规的依赖。
它非常适合负责系统架构设计、核心模块开发或进行大型代码库重构的开发者。特别是当团队规模扩大、代码历史较长、或需要引入新成员时，此工具能有效保障架构意图不被破坏。
建议在项目初期或重构阶段引入，并与团队就模块划分达成共识后配置规则。注意，它主要提供的是“约束”而非“重构”能力，对于已经高度耦合的历史代码，需要先进行一定的解耦重构才能充分发挥其价值。
核心特点
与同类代码质量工具（如ESLint插件）专注于代码风格或简单依赖引入检查不同，本Skill专注于在AI辅助编码（Pi, Claude Code）的实时上下文中，主动强制执行架构层面的模块访问规则，从源头防止架构腐化。
注意事项
不适合用于小型、快速迭代的原型项目，或模块边界尚未清晰定义的早期探索阶段。
常见问题
module-gates 和 ESLint 的 no-restricted-imports 规则有什么区别？
ESLint是静态检查，在代码编写后报告问题；module-gates与AI编码助手深度集成，能在代码生成和编写过程中实时引导和约束，更主动地防止违规依赖的产生。
这个工具能帮我重构已有代码的模块依赖吗？
不能直接重构。它的核心作用是“防护”，确保新的代码变更符合模块边界。重构已有依赖需要借助其他重构工具或手动完成。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/cuzfrog-module-gates/raw/index.md 读取 @cuzfrog/module-gates 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/cuzfrog-module-gates/raw/index.md（查看排版版本）