mcpField
R
repository-module-architecture

repository-module-architecture

github.com/tencentblueking开发2.5k45 次安装2 天前更新
代码仓库

关于 repository-module-architecture

面向代码库接入与管理的开发技能，涵盖仓库类型、认证、Webhook 和 PAC。帮助区分仓库资源管理与 Git 操作及流水线模型职责。

主要功能

  1. 01仓库类型与资源管理
  2. 02认证方式与 OAuth、SSH、Token
  3. 03Webhook 配置与排查
  4. 04PAC 仓库上下文与提交记录
  5. 05按主题查阅架构参考

适用场景

  1. 01判断仓库类型对应的服务实现
  2. 02排查仓库认证或 Webhook 问题
  3. 03厘清 PAC 开关与 YAML 转换职责

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/tencentblueking/bk-ci --skill repository-module-architecture

安装后在 Claude Code 中输入/repository-module-architecture确认已加载。

附带文件reference/1-repository-foundation.mdreference/2-webhook-pac-auth.md

详细介绍

来自项目 README

Repository 模块架构

适用场景

  • 接入或管理代码库
  • 处理仓库认证、OAuth、SSH、Token
  • 配置或排查 Webhook
  • 处理 PAC 代码库与提交记录
  • 判断某种代码库类型应该落在哪套服务实现

不适用场景

  • 只是普通 Git 命令使用问题
  • 只是 PAC 的 YAML 转换问题，不涉及代码库接入
  • 只是权限模型定义，不涉及仓库资源本身

快速指导

  1. 先判断问题属于哪条主线：
    • 仓库基础与类型差异：看 reference/1-repository-foundation.md
    • Webhook、PAC、认证与排查：看 reference/2-webhook-pac-auth.md
  2. Repository 模块的核心不是“执行 Git 操作”，而是“管理仓库资源、认证方式、Webhook 和平台接入语义”。
  3. 只要改仓库类型、认证逻辑或 PAC 开关，就要同时看仓库明细表、认证方式和 Webhook 行为。
  4. PAC 问题如果已经进入 YAML 解析或模板展开层，接下来切到 yaml-pipeline-transfer。

高信号规则

  • Repository 负责仓库资源接入与管理，不负责流水线模型本身
  • 不同仓库类型在认证、字段和 API 能力上都不完全一致
  • PROJECT_ID 仍然要按项目英文标识理解
  • PAC 是仓库侧开关和上下文来源，不等于 YAML 转换实现本身

关键陷阱

  • 把代码库类型差异当成一套统一逻辑硬处理
  • 只看主表，不看各仓库类型的明细表
  • 把 Webhook 问题误判为仓库保存问题，或反过来
  • PAC 开关开了就默认一切 YAML / 触发都能工作

延伸阅读

  • 仓库基础：reference/1-repository-foundation.md
  • Webhook 与 PAC：reference/2-webhook-pac-auth.md
  • 涉及 YAML/PAC 转换时：再看 yaml-pipeline-transfer
  • 涉及项目语义时：再看 project-module-architecture

评论

支持 Markdown