SKILL.md
Auth 模块架构
适用场景
- 修改 RBAC 权限校验和资源授权逻辑
- 处理用户组、成员、资源与权限关系
- 修改 IAM 集成、回调和同步逻辑
- 处理权限迁移、分级管理员或 OAuth2 认证
不适用场景
- 只是新增一种权限资源类型或动作模型
- 只是给用户授权、加成员、查权限
- 只是修改其他业务模块里的权限调用点
- 只是处理普通登录页面或前端鉴权展示
快速指导
- 这个 skill 关注的是“权限平台本身如何实现和协作”，不是单次资源接入手册。
- Auth 既包含 RBAC 资源授权，也包含 IAM 对接、用户组、OAuth2 等平台能力。
- 先按问题类型进入对应参考文档：
- 模块结构与核心对象：reference/1-auth-foundation.md - RBAC、用户组与授权链路：reference/2-rbac-group-authorization.md - IAM 集成、OAuth2 与排查：reference/3-iam-oauth-debug.md
- 如果你在设计新的资源类型、动作列表或初始化流程，切到
permission-model-change-guide。 - 如果你在处理业务模块里某个权限调用失败，先判断是 Auth 平台问题还是业务侧传参问题。
高信号规则
- Auth 的核心是资源、动作、用户组、成员和授权关系
- IAM 集成和本地 RBAC 数据是一条完整权限链，不应分开孤立看
- 用户组配置、权限校验和资源同步往往会一起影响结果
- 权限平台改动要优先考虑兼容性、缓存刷新和历史数据
关键陷阱
- 把权限模型变更和 Auth 平台实现混为一谈
- 只改校验逻辑，不看用户组、资源数据和同步链路
- OAuth2、回调、权限校验共用上下文时，忽略边界差异
- 权限问题排查只看接口返回，不看组、资源和动作三元关系
延伸阅读
- 模块结构与核心对象：
reference/1-auth-foundation.md - RBAC、用户组与授权链路：
reference/2-rbac-group-authorization.md - IAM 集成、OAuth2 与排查：
reference/3-iam-oauth-debug.md - 如果你在做权限模型接入：再看
permission-model-change-guide