project-module-architecture について
BK-CI の Project モジュールを理解し、変更する開発者向けのスキルです。プロジェクト属性、権限、リソース境界、ルーティングを扱い、`projectId` の業務上の意味と他モジュールへの影響を示します。
主な機能
- 01プロジェクトの作成・更新・移行
- 02プロジェクト属性と承認状態の扱い
- 03メンバー・権限・リソース境界の調査
- 04projectId の意味の判定
- 05プロジェクトのシャーディングとルーティング分析
活用シーン
- 01プロジェクト属性や有効状態の変更
- 02メンバー構成や権限の問題調査
- 03他モジュールでの projectId の意味の確認
- 04プロジェクト項目変更による下流への影響評価
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/project-module-architectureを入力して読み込まれたか確認します。
同梱ファイルreference/1-project-foundation.mdreference/2-project-operations.md
詳細
プロジェクトの README よりProject 模块架构
适用场景
- 创建、更新或迁移项目
- 处理项目属性、标签、渠道、审批状态
- 排查成员、权限、项目资源边界
- 判断其他模块里
projectId的真实含义 - 处理项目分片、路由、项目级基础配置
不适用场景
- 只是某个流水线、代码库或制品本身的业务逻辑
- 只是普通权限模型设计，不涉及项目这个资源域
- 只是数据库脚本设计，不涉及项目模块语义
快速指导
- 先确认问题属于哪条主线：
- 项目基础心智：看
reference/1-project-foundation.md - 项目属性、权限、分片与扩展：看
reference/2-project-operations.md
- 项目基础心智：看
- BK-CI 里绝大多数业务接口说的
projectId，实际都更接近T_PROJECT.english_name，不是数据库里的 UUID 主键字段。 Project是基础模块，很多问题看起来发生在别的模块，但根源是项目属性、项目启停状态、项目边界或项目权限没对齐。- 只要改项目字段、项目属性或项目路由逻辑，就要同时考虑对其他模块的影响。
高信号规则
- 项目是 BK-CI 资源隔离的基础边界
- 其他模块依赖
Project，但不应该绕过它自行定义项目语义 - 项目属性常常决定后续流水线、代码库、权限和 PAC 行为
- 项目分片和路由属于基础设施能力，不是普通业务字段
关键陷阱
- 把
T_PROJECT.PROJECT_ID和业务里的projectId混用 - 只改项目表，不同步看项目属性和下游依赖模块
- 把项目问题误判为权限问题，或把权限问题误判为项目不存在
- 忽略项目分片、渠道和审批状态对整体行为的影响
延伸阅读
- 项目基础：
reference/1-project-foundation.md - 项目属性与分片：
reference/2-project-operations.md - 涉及全局模块协作时：再看
00-bkci-global-architecture - 涉及权限实现时：再看
auth-module-architecture
コメント
Markdown 対応