AR

artifactory-module-architecture

Architecture and management guide for BK-CI artifact storage and lifecycle.

Install

mkdir -p .claude/skills/artifactory-module-architecture && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/1794" && unzip -o skill.zip -d .claude/skills/artifactory-module-architecture && rm skill.zip

Installs to .claude/skills/artifactory-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 制品上传下载、制品元数据、BkRepo 或磁盘后端存储、文件任务和清理链路时使用。当用户提到构建产物、制品归档、下载令牌、报告文件、BkRepo 集成或制品清理时优先使用。
95 charsno explicit “when” trigger
Intermediate

Key capabilities

  • Upload and download build artifacts
  • Manage file metadata and file tasks
  • Switch or troubleshoot BkRepo and disk storage backends
  • Handle report files and custom directory paths
  • Troubleshoot post-build artifact processing

How it works

The skill directs users to relevant documentation based on the problem's main line, such as storage models or BkRepo integration, and provides troubleshooting steps for common issues like missing files or incorrect paths.

Inputs & outputs

You give it
A problem description related to artifact storage, management, or retrieval in BK-CI.
You get back
Guidance on diagnosing and resolving issues related to artifact storage models, BkRepo/Disk backends, metadata, tasks, and extensions.

When to use artifactory-module-architecture

  • Configuring artifact storage backends
  • Implementing artifact cleanup strategies
  • Managing artifact metadata

About this skill

Artifactory 模块架构

适用场景

  • 上传、下载、归档构建产物
  • 管理文件元数据、文件任务和下载令牌
  • 切换或排查 BkRepo / 磁盘存储后端
  • 处理报告文件、自定义目录和流水线产物路径
  • 排查构建完成后的制品后处理

不适用场景

  • 只是商店组件发布问题,不涉及制品存储
  • 只是普通文件路径拼接,不涉及制品语义和存储后端
  • 只是流水线执行问题,不涉及产物归档或下载

快速指导

  1. 先判断问题属于哪条主线:
    • 存储模型与路径:看 reference/1-artifact-storage.md
    • BkRepo、任务与扩展:看 reference/2-bkrepo-task-extension.md
  2. Artifactory 负责“文件和制品如何被存储与访问”,不是执行引擎本身。
  3. 如果问题表现为上传成功但文件找不到,先区分是:
    • 元数据没落库
    • 后端没存成功
    • 路径规则错了
    • 下载令牌或权限错了
  4. 存储后端切换或双实现问题,优先确认实际走的是 BkRepo 还是本地磁盘实现。

高信号规则

  • PROJECT_CODE / PROJECT_ID 通常仍按项目英文标识理解
  • 文件元数据、文件任务和真实后端存储不是同一层
  • BkRepo 与 Disk 是两套后端实现,排查时要先确认命中的实现类
  • 构建完成后的异步处理也会影响制品最终可见性

关键陷阱

  • 只看文件存储后端,不看元数据和任务状态
  • 路径规则变了却没同步影响下载、报告或自定义目录逻辑
  • 只验证上传接口成功,不验证后续查询、下载和清理链路
  • 把商店归档和普通流水线制品归档混成同一问题

延伸阅读

  • 存储基础:reference/1-artifact-storage.md
  • BkRepo 与任务:reference/2-bkrepo-task-extension.md
  • 涉及项目语义时:再看 project-module-architecture
  • 涉及商店归档时:再看 store-module-architecture

When not to use it

  • When the issue is only about store component publishing
  • When the issue is only about general file path concatenation
  • When the issue is only about pipeline execution

How it compares

This skill offers a structured diagnostic approach for artifact management issues, contrasting with a manual investigation that might overlook specific backend implementations or metadata states.

Compared to similar skills

artifactory-module-architecture side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
artifactory-module-architecture (this skill)43moNo flagsIntermediate
deployment-pipeline-design62moReviewAdvanced
cloudflare-deploy36moReviewIntermediate
deployment-engineer44moNo flagsAdvanced

Try saying

Example prompts that trigger this skill in your AI assistant.

More by TencentBlueKing

View all by TencentBlueKing

project-module-architecture

TencentBlueKing

Project 项目管理模块架构指南,涵盖项目 CRUD、成员管理、项目配置、标签管理、项目迁移。当用户开发项目管理功能、处理项目成员、配置项目属性或实现项目相关逻辑时使用。

612

microservice-infrastructure

TencentBlueKing

微服务基础设施指南,涵盖条件配置、事件驱动架构、服务间通信、国际化与日志等微服务架构的核心基础设施。当用户实现服务间调用、配置多环境、实现异步通信、处理国际化或规范日志输出时使用。

411

frontend-vue-development

TencentBlueKing

前端 Vue 开发规范,涵盖 Vue 2/3 组件开发、Vuex 状态管理、路由配置、组件通信、样式规范、国际化。当用户进行前端开发、编写 Vue 组件、处理状态管理或实现页面交互时使用。

38

unit-testing

TencentBlueKing

单元测试编写指南,涵盖 JUnit5/MockK 使用、测试命名规范、Mock 技巧、测试覆盖率要求、TDD 实践。当用户编写单元测试、Mock 依赖、提高测试覆盖率或进行测试驱动开发时使用。

319

worker-module-architecture

TencentBlueKing

Worker 构建执行器模块架构指南,涵盖插件执行引擎、任务分发、日志上报、制品上传、Worker 生命周期。当用户开发 Worker 功能、实现插件执行、处理任务分发或优化执行器性能时使用。

37

agent-module-architecture

TencentBlueKing

Agent 构建机模块架构指南(Go 语言),涵盖 Agent 启动流程、心跳机制、任务领取执行、升级更新、与 Dispatch 交互。当用户开发 Agent 功能、修改心跳逻辑、处理任务执行或实现 Agent 升级时使用。

23

You might also like

deployment-pipeline-design

wshobson

Design multi-stage CI/CD pipelines with approval gates, security checks, and deployment orchestration. Use when architecting deployment workflows, setting up continuous delivery, or implementing GitOps practices.

670

cloudflare-deploy

davila7

Deploy applications and infrastructure to Cloudflare using Workers, Pages, and related platform services. Use when the user asks to deploy, host, publish, or set up a project on Cloudflare.

342

deployment-engineer

sickn33

Expert deployment engineer specializing in modern CI/CD pipelines, GitOps workflows, and advanced deployment automation. Masters GitHub Actions, ArgoCD/Flux, progressive delivery, container security, and platform engineering. Handles zero-downtime deployments, security scanning, and developer experience optimization. Use PROACTIVELY for CI/CD design, GitOps implementation, or deployment automation.

418

genkit-infra-expert

jeremylongshore

Execute use when deploying Genkit applications to production with Terraform. Trigger with phrases like "deploy genkit terraform", "provision genkit infrastructure", "firebase functions terraform", "cloud run deployment", or "genkit production infrastructure". Provisions Firebase Functions, Cloud Run services, GKE clusters, monitoring dashboards, and CI/CD for AI workflows.

15

managing-deployment-rollbacks

jeremylongshore

Deploy use when you need to work with deployment and CI/CD. This skill provides deployment automation and orchestration with comprehensive guidance and automation. Trigger with phrases like "deploy application", "create pipeline", or "automate deployment".

11

railway-deploy

davila7

Deploy code to Railway using "railway up". Use when user wants to push code, says "railway up", "deploy", "ship", or "push". For initial setup or creating services, use railway-new skill. For Docker images, use railway-environment skill.

10

Search skills

Search the agent skills registry