project-module-architecture
Architectural support for managing projects, member permissions, and configuration in the BK-CI system.
Install
mkdir -p .claude/skills/project-module-architecture && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/2104" && unzip -o skill.zip -d .claude/skills/project-module-architecture && rm skill.zipInstalls to .claude/skills/project-module-architecture
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
处理 BK-CI 项目创建、项目属性、成员权限、项目标签、项目分片和项目资源边界时使用。当用户提到项目管理、projectId 含义、项目配置、成员管理或项目迁移时优先使用。Key capabilities
- →Create, update, or migrate projects
- →Handle project attributes, tags, channels, and approval statuses
- →Troubleshoot members, permissions, and project resource boundaries
- →Determine the meaning of `projectId` in other modules
- →Manage project sharding, routing, and project-level configurations
How it works
This skill provides guidance on managing project entities, including their creation, modification, and migration, by detailing how to handle attributes, permissions, and routing within the BK-CI system.
Inputs & outputs
When to use project-module-architecture
- →Configure project attributes
- →Manage project member permissions
- →Resolve project-level routing issues
About this skill
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
When not to use it
- →When the task involves only pipeline, code repository, or artifact business logic
- →When the task is only about general permission model design, not involving the project resource domain
- →When the task is only about database script design, not involving project module semantics
Limitations
- →Does not apply to business logic solely for pipelines, code repositories, or artifacts
- →Does not apply to general permission model design unrelated to the project resource domain
- →Does not apply to database script design that lacks project module semantics
How it compares
This skill clarifies the distinction between `projectId` and database UUIDs, which prevents common misinterpretations that can occur in generic project management.
Compared to similar skills
project-module-architecture side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| project-module-architecture (this skill) | 6 | 3mo | No flags | Intermediate |
| architect-review | 109 | 4mo | No flags | Advanced |
| solid-principles | 57 | 9mo | No flags | Intermediate |
| codex | 32 | 2mo | Review | Advanced |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by TencentBlueKing
View all by TencentBlueKing →You might also like
architect-review
sickn33
Master software architect specializing in modern architecture patterns, clean architecture, microservices, event-driven systems, and DDD. Reviews system designs and code changes for architectural integrity, scalability, and maintainability. Use PROACTIVELY for architectural decisions.
solid-principles
SmidigStorm
Enforce SOLID principles (Single Responsibility, Open/Closed, Liskov Substitution, Interface Segregation, Dependency Inversion) in object-oriented design. Use when writing or reviewing classes and modules.
codex
Lucklyric
Invoke Codex CLI for complex coding tasks requiring high reasoning capabilities. This skill should be invoked when users explicitly mention "Codex", request complex implementation challenges, advanced reasoning, or need high-reasoning model assistance. Automatically triggers on codex-related requests and supports session continuation for iterative development.
error-handling-patterns
wshobson
Master error handling patterns across languages including exceptions, Result types, error propagation, and graceful degradation to build resilient applications. Use when implementing error handling, designing APIs, or improving application reliability.
deepwiki-rs
sopaco
AI-powered Rust documentation generation engine for comprehensive codebase analysis, C4 architecture diagrams, and automated technical documentation. Use when Claude needs to analyze source code, understand software architecture, generate technical specs, or create professional documentation from any programming language.
senior-fullstack
davila7
Comprehensive fullstack development skill for building complete web applications with React, Next.js, Node.js, GraphQL, and PostgreSQL. Includes project scaffolding, code quality analysis, architecture patterns, and complete tech stack guidance. Use when building new projects, analyzing code quality, implementing design patterns, or setting up development workflows.