architecture-paradigm-layered
强制分层架构的代码生成与审查技能
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：architecture-paradigm-layered。 它的用途是：强制分层架构的代码生成与审查技能 完整的 Skill 内容见：https://321skill.com/skills/architecture-paradigm-layered-x-2/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'请用分层架构生成用户注册模块，包含Controller、Service、Repository三层，要求Controller只做参数校验，Service处理业务逻辑，Repository操作数据库。' AI会生成结构清晰的代码，自动将数据库查询放在Repository层，并在Controller中调用Service而非直接访问Repository，同时给出每层的职责注释。
介绍
解决什么问题
在多人协作的后端项目中，分层架构（如Controller-Service-Repository）的边界常常被打破，出现跨层直接调用、业务逻辑泄漏到Controller层、数据访问层混入业务逻辑等问题。这些混乱会显著增加代码维护成本、降低可测试性，并让新成员难以快速理解项目结构。本技能通过强约束规则，确保AI生成的每一行代码都严格遵循n-tier分层边界，从源头杜绝架构腐化。
怎么用
安装本技能后，在AI编码助手的对话中，你只需描述需求（如“创建一个用户注册接口，分三层实现”），AI会自动识别层间职责，生成符合分层规范的代码。同时，对于已有的代码，你可以通过审查指令让AI检查是否存在跨层违规调用，并给出重构建议。技能内置了常见的层间通信规则（如Service层不可直接调用Repository层之外的持久化模块），并支持自定义扩展。
适合谁
主要面向后端开发者、全栈开发者以及从事智能体开发（需编写后端服务）的工程师。如果你正在维护一个采用分层架构的中大型项目，或者希望从零开始建立一套严格的架构规范，这个技能将极大提升你的代码质量和团队协作效率。
使用建议或注意事项
建议在项目初期就引入本技能，结合团队的分层约定（如是否允许Service层之间互相调用）进行配置。对于快速原型或小型项目，强制分层可能增加不必要的复杂度，此时可暂时禁用或选择宽松模式。另外，该技能主要约束代码结构，不会替代业务逻辑的正确性，仍需开发者进行功能测试。
核心特点
与普通代码生成技能不同，本技能不仅生成代码，还会在生成过程中自动检查并阻止跨层直接调用（如Controller直接操作数据库），确保每一层职责单一且边界清晰。
注意事项
不适合快速原型或小型项目，可能因过度设计而拖慢开发节奏；对于已有大量违规代码的遗留项目，需要配合重构步骤逐步迁移。
常见问题
这个技能支持哪些分层模式？
默认支持三层架构（Controller-Service-Repository），也支持通过配置文件扩展为四层（如增加Domain层）或适配DDD分层模式。
如果我的项目已经有跨层调用，能自动修复吗？
可以识别出违规调用并给出重构建议，但不会自动修改代码，需要你确认后执行。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/architecture-paradigm-layered-x-2/raw/index.md 读取 architecture-paradigm-layered 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/architecture-paradigm-layered-x-2/raw/index.md（查看排版版本）