SkillsAdd

smithery/tencentblueking

project-module-architecture

处理 BK-CI 项目创建、项目属性、成员权限、项目标签、项目分片和项目资源边界时使用。当用户提到项目管理、projectId 含义、项目?

Installation

$ npx skills add smithery/tencentblueking --skill project-module-architecture
View on skills.sh ↗ Website ↗

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

flutter-apply-architecture-best-practices Similar name
flutter/agent-plugins

Architects a Flutter application using the recommended layered approach (UI, Logic, Data). Use …

34.4K installs
architecture-blueprint-generator Similar name
github/awesome-copilot

Comprehensive project architecture blueprint generator that analyzes codebases to create detail…

12K installs
clickhouse-architecture-advisor Similar name
clickhouse/agent-skills

MUST USE when designing ClickHouse architectures, selecting between ingestion or modeling patte…

7.9K installs
architecture Similar name
anthropics/knowledge-work-plugins

Create or evaluate an architecture decision record (ADR). Use when choosing between technologie…

5.9K installs
gtm-partnership-architecture Similar name
github/awesome-copilot

Build and scale partner ecosystems that drive revenue and platform adoption. Use when building …

1.6K installs
azure-architecture-autopilot Similar name
github/awesome-copilot

Design Azure infrastructure using natural language, or analyze existing Azure resources to auto…

1.5K installs

Also in this package

Other skills from smithery/tencentblueking · top by installs.

npx skills add smithery/tencentblueking
yaml-pipeline-transfer 0 worker-module-architecture 0 utility-components 0 unit-testing 0 supporting-modules-architecture 0 store-module-architecture 0 repository-module-architecture 0 process-module-architecture 0 pipeline-variable-management 0 pipeline-template-module 0

Browse all from smithery/tencentblueking

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,267 B
  • docs SUMMARY.md 270 B

History

  1. First recorded snapshot · 0 installs

SKILL.md

Project 模块架构

适用场景

  • 创建、更新或迁移项目
  • 处理项目属性、标签、渠道、审批状态
  • 排查成员、权限、项目资源边界
  • 判断其他模块里 projectId 的真实含义
  • 处理项目分片、路由、项目级基础配置

不适用场景

  • 只是某个流水线、代码库或制品本身的业务逻辑
  • 只是普通权限模型设计，不涉及项目这个资源域
  • 只是数据库脚本设计，不涉及项目模块语义

快速指导

  1. 先确认问题属于哪条主线：

- 项目基础心智：看 reference/1-project-foundation.md - 项目属性、权限、分片与扩展：看 reference/2-project-operations.md

  1. BK-CI 里绝大多数业务接口说的 projectId，实际都更接近 TPROJECT.englishname，不是数据库里的 UUID 主键字段。
  2. Project 是基础模块，很多问题看起来发生在别的模块，但根源是项目属性、项目启停状态、项目边界或项目权限没对齐。
  3. 只要改项目字段、项目属性或项目路由逻辑，就要同时考虑对其他模块的影响。

高信号规则

  • 项目是 BK-CI 资源隔离的基础边界
  • 其他模块依赖 Project，但不应该绕过它自行定义项目语义
  • 项目属性常常决定后续流水线、代码库、权限和 PAC 行为
  • 项目分片和路由属于基础设施能力，不是普通业务字段

关键陷阱

  • 把 TPROJECT.PROJECTID 和业务里的 projectId 混用
  • 只改项目表，不同步看项目属性和下游依赖模块
  • 把项目问题误判为权限问题，或把权限问题误判为项目不存在
  • 忽略项目分片、渠道和审批状态对整体行为的影响

延伸阅读

  • 项目基础：reference/1-project-foundation.md
  • 项目属性与分片：reference/2-project-operations.md
  • 涉及全局模块协作时：再看 00-bkci-global-architecture
  • 涉及权限实现时：再看 auth-module-architecture