用途:处理 BK-CI 项目创建、项目属性、成员权限、项目标签、项目分片、项目资源边界与项目迁移等语义问题;也可用于判断其他模块中 projectId 的真实含义。适用场景包括创建、更新或迁移项目,处理项目属性、标签、渠道、审批状态,排查成员、权限与项目资源边界,以及处理项目分片、路由和项目级基础配置。
主要能力:该技能按两条主线组织知识,项目基础心智见 reference/1-project-foundation.md,项目属性、权限、分片与扩展见 reference/2-project-operations.md。高信号规则指出:项目是 BK-CI 资源隔离的基础边界;其他模块依赖 Project,但不应绕过它自行定义项目语义;项目属性常决定流水线、代码库、权限与 PAC 行为;项目分片和路由属于基础设施能力,不是普通业务字段。
使用要点:BK-CI 中绝大多数业务接口所说的 projectId,实际更接近 T_PROJECT.english_name,而非数据库 UUID 主键字段。只要修改项目字段、项目属性或项目路由逻辑,就需同时考虑对其他模块的影响。需要全局模块协作时再看 00-bkci-global-architecture,涉及权限实现时再看 auth-module-architecture。
限制:不适用于单个流水线、代码库或制品本身的业务逻辑,普通权限模型设计(不涉及项目资源域),以及不涉及项目模块语义的数据库脚本设计。注意避免混用 T_PROJECT.PROJECT_ID 与业务 projectId、只改项目表而不同步下游依赖、把项目问题误判为权限问题或反之,以及忽略项目分片、渠道和审批状态的影响。具体安装方式、收费与平台信息暂未提供。