Agent-Skills.md

Agent Skills: Auth 模块架构

Auth 权限认证模块架构指南，涵盖 IAM 集成、RBAC 权限模型、资源权限校验、权限迁移、OAuth 认证。当用户开发权限功能、配置 IAM 资源、实现权限校验或处理认证流程时使用。

UncategorizedID: tencentblueking/bk-ci/auth-module-architecture

Repository

tencentblueking/bk-ci
TencentBlueKingLicense: NOASSERTION
2,498520

Install this agent skill to your local

pnpm dlx add-skill https://github.com/TencentBlueKing/bk-ci/tree/HEAD/ai/skills/auth-module-architecture

Skill Files

Browse the full folder contents for auth-module-architecture.

Download Skill

Loading file tree…

ai/skills/auth-module-architecture/SKILL.md

Skill Metadata

Name
auth-module-architecture
Description
处理 BK-CI Auth 模块时使用，例如 RBAC 权限校验、用户组与资源管理、IAM 集成、授权迁移和 OAuth2 认证。当用户要改权限平台实现而不是单次权限模型变更时优先使用。

Auth 模块架构

适用场景

  • 修改 RBAC 权限校验和资源授权逻辑
  • 处理用户组、成员、资源与权限关系
  • 修改 IAM 集成、回调和同步逻辑
  • 处理权限迁移、分级管理员或 OAuth2 认证

不适用场景

  • 只是新增一种权限资源类型或动作模型
  • 只是给用户授权、加成员、查权限
  • 只是修改其他业务模块里的权限调用点
  • 只是处理普通登录页面或前端鉴权展示

快速指导

  1. 这个 skill 关注的是“权限平台本身如何实现和协作”，不是单次资源接入手册。
  2. Auth 既包含 RBAC 资源授权，也包含 IAM 对接、用户组、OAuth2 等平台能力。
  3. 先按问题类型进入对应参考文档：
    • 模块结构与核心对象：reference/1-auth-foundation.md
    • RBAC、用户组与授权链路：reference/2-rbac-group-authorization.md
    • IAM 集成、OAuth2 与排查：reference/3-iam-oauth-debug.md
  4. 如果你在设计新的资源类型、动作列表或初始化流程，切到 permission-model-change-guide。
  5. 如果你在处理业务模块里某个权限调用失败，先判断是 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