Auth Module Architecture
Developmentauth-module-architectureAuth Module Architecture is an Agent Skill for development published in the TencentBlueKing/bk-ci repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
处理 BK-CI Auth 模块时使用,例如 RBAC 权限校验、用户组与资源管理、IAM 集成、授权迁移和 OAuth2 认证。当用户要改权限平台实现而不是单次权限模型变更时优先使用。
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/TencentBlueKing/bk-ci/blob/HEAD/ai/skills/auth-module-architecture/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/auth-module-architecture, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
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