OBS Skill - Open Build Service 专家技能
技能描述 | Skill Description
名称 | Name: obs 版本 | Version: 1.0.0 作者 | Author: OBS Agent 领域 | Domain: Open Build Service (OBS) 包管理和分发
这是一个全面的 OBS (Open Build Service) 管理技能，提供完整的 API 封装，支持项目、包、仓库、构建、提交请求等所有核心功能。
This is a comprehensive OBS (Open Build Service) management skill with full API coverage, supporting projects, packages, repositories, builds, submit requests, and all core functionalities.
功能列表 | Features
1. 项目管理 | Project Management
- 创建/删除项目 | Create/Delete projects
- 获取项目元数据 | Get project metadata
- 更新项目配置 | Update project configuration
- 列出项目下的包 | List packages in project
- 设置项目访问控制 | Set project access control
2. 包管理 | Package Management
- 创建/删除包 | Create/Delete packages
- 获取包信息 | Get package information
- 上传包文件 (spec, tarball 等) | Upload package files (spec, tarball, etc.)
- 下载包源码 | Download package sources
- 查看包历史 | View package history
- 锁定/解锁包 | Lock/Unlock packages
3. 仓库管理 | Repository Management
- 添加/删除仓库 | Add/Remove repositories
- 配置仓库路径 | Configure repository paths
- 设置仓库架构 | Set repository architectures
- 管理仓库依赖 | Manage repository dependencies
4. 构建管理 | Build Management
- 触发重建 | Trigger rebuild
- 查看构建状态 | View build status
- 获取构建日志 | Get build logs
- 停止构建 | Stop builds
- 查看构建结果 | View build results
5. 提交请求 | Submit Requests
- 创建提交请求 | Create submit requests
- 查看提交请求状态 | View submit request status
- 接受/拒绝提交请求 | Accept/Reject submit requests
- 撤销提交请求 | Revoke submit requests
- 列出待处理请求 | List pending requests
6. 文件操作 | File Operations
- 读取文件内容 | Read file content
- 上传/更新文件 | Upload/Update files
- 删除文件 | Delete files
- 列出目录内容 | List directory contents
- 文件版本历史 | File version history
7. 用户和组 | Users and Groups
- 获取用户信息 | Get user information
- 获取组信息 | Get group information
- 管理项目权限 | Manage project permissions
- 添加/移除维护者 | Add/Remove maintainers
8. 搜索和发现 | Search and Discovery
- 搜索项目 | Search projects
- 搜索包 | Search packages
- 查看依赖关系 | View dependencies
- 查看反向依赖 | View reverse dependencies
配置 | Configuration
环境变量 | Environment Variables
# OBS API 地址 | OBS API URL
OBS_APIURL=https://api.opensuse.org
# 用户名 | Username
OBS_USERNAME=your_username
# API Token (在 OBS Web UI: Profile -> Settings -> API Tokens 创建)
# API Token (create via OBS Web UI: Profile -> Settings -> API Tokens)
OBS_TOKEN=your_api_tokenosc 配置文件 | osc Config File
或者使用 osc 配置文件 ~/.config/osc/oscrc:
Or use osc config file ~/.config/osc/oscrc:
[general]
apiurl = https://api.opensuse.org
[https://api.opensuse.org]
user = your_username
pass = your_token使用示例 | Usage Examples
项目操作 | Project Operations
创建项目 | Create Project
# 创建新项目
# Create a new project
obs project create \
--name "home:username:myproject" \
--title "My Project" \
--description "Project description here"获取项目信息 | Get Project Info
# 获取项目元数据
# Get project metadata
obs project get --name "home:username:myproject"列出项目下的包 | List Packages in Project
# 列出所有包
# List all packages
obs package list --project "home:username:myproject"包操作 | Package Operations
创建包 | Create Package
# 创建新包
# Create a new package
obs package create \
--project "home:username:myproject" \
--name "mypackage"上传包文件 | Upload Package Files
# 上传 spec 文件和源码
# Upload spec file and sources
obs file upload \
--project "home:username:myproject" \
--package "mypackage" \
--file "./mypackage.spec" \
--file "./mypackage-1.0.tar.gz"下载包源码 | Download Package Sources
# 下载包源码到本地
# Download package sources to local
obs package checkout \
--project "home:username:myproject" \
--package "mypackage" \
--output "./mypackage"构建操作 | Build Operations
触发重建 | Trigger Rebuild
# 重建包
# Rebuild package
obs build rebuild \
--project "home:username:myproject" \
--package "mypackage" \
--repository "openSUSE_Tumbleweed" \
--arch "x86_64"查看构建状态 | View Build Status
# 查看构建结果
# View build results
obs build status \
--project "home:username:myproject" \
--package "mypackage"获取构建日志 | Get Build Logs
# 获取构建日志
# Get build logs
obs build log \
--project "home:username:myproject" \
--package "mypackage" \
--repository "openSUSE_Tumbleweed" \
--arch "x86_64"提交请求 | Submit Requests
创建提交请求 | Create Submit Request
# 创建提交请求到 Factory
# Create submit request to Factory
obs request create \
--source-project "home:username:myproject" \
--source-package "mypackage" \
--target-project "openSUSE:Factory" \
--target-package "mypackage" \
--description "Update to version 1.0"查看提交请求 | View Submit Request
# 查看请求状态
# View request status
obs request get --id 123456接受/拒绝请求 | Accept/Reject Request
# 接受请求
# Accept request
obs request accept --id 123456
# 拒绝请求
# Reject request
obs request reject --id 123456文件操作 | File Operations
读取文件 | Read File
# 读取 spec 文件内容
# Read spec file content
obs file get \
--project "home:username:myproject" \
--package "mypackage" \
--file "mypackage.spec"更新文件 | Update File
# 更新文件内容
# Update file content
obs file update \
--project "home:username:myproject" \
--package "mypackage" \
--file "mypackage.spec" \
--content "./updated.spec" \
--message "Update spec file"列出文件 | List Files
# 列出包中的所有文件
# List all files in package
obs file list \
--project "home:username:myproject" \
--package "mypackage"搜索 | Search
搜索项目 | Search Projects
# 搜索项目
# Search projects
obs search projects --query "myproject"搜索包 | Search Packages
# 搜索包
# Search packages
obs search packages --query "mypackage"API 参考 | API Reference
基础命令 | Base Commands
# 查看所有可用命令
# View all available commands
obs --help
# 查看特定命令的帮助
# View help for specific command
obs <command> --help命令结构 | Command Structure
obs <resource> <action> [options]
# 资源类型 | Resource types:
# - project (项目)
# - package (包)
# - build (构建)
# - request (请求)
# - file (文件)
# - repository (仓库)
# - search (搜索)
# - user (用户)
# - group (组)
# 操作类型 | Action types:
# - get (获取)
# - list (列表)
# - create (创建)
# - update (更新)
# - delete (删除)
# - rebuild (重建)
# - checkout (检出)
# - commit (提交)最佳实践 | Best Practices
1. 认证安全 | Authentication Security
- 使用 API Token 而非密码 | Use API Token instead of password
- 不要将凭证提交到版本控制 | Do not commit credentials to version control
- 定期轮换 Token | Rotate tokens regularly
2. 项目命名 | Project Naming
- 个人项目使用
home:username:projectname格式 - Personal projects use
home:username:projectnameformat - 官方项目遵循 OBS 命名规范
- Official projects follow OBS naming conventions
3. 提交请求 | Submit Requests
- 在提交前确保包在本地构建成功
- Ensure package builds locally before submitting
- 提供清晰的更新说明
- Provide clear update descriptions
- 先提交到 Factory，再同步到 Leap
- Submit to Factory first, then sync to Leap
4. 错误处理 | Error Handling
- 检查 API 响应状态码 | Check API response status codes
- 记录详细的错误日志 | Log detailed error messages
- 实现重试机制 | Implement retry mechanisms
故障排除 | Troubleshooting
常见问题 | Common Issues
认证失败 | Authentication Failed
# 检查凭证配置
# Check credential configuration
obs auth test
# 重新配置凭证
# Reconfigure credentials
obs auth configure构建失败 | Build Failed
# 查看构建日志
# View build logs
obs build log \
--project "home:username:myproject" \
--package "mypackage" \
--repository "openSUSE_Tumbleweed" \
--arch "x86_64" \
--last-failed权限错误 | Permission Error
# 检查项目权限
# Check project permissions
obs project meta \
--name "home:username:myproject" \
--show-access扩展开发 | Extension Development
添加新命令 | Add New Commands
在 scripts/ 目录中创建新的脚本文件：
Create new script files in the scripts/ directory:
#!/bin/bash
# scripts/custom-command.sh
source "$(dirname "$0")/obs-lib.sh"
obs_custom_command() {
local project="$1"
local package="$2"
# 实现自定义逻辑
# Implement custom logic
obs_api_call "GET" "/source/$project/$package"
}
obs_custom_command "$@"使用 OBS API 库 | Using OBS API Library
source references/obs-lib.sh
# API 调用示例
# API call examples
obs_api_call "GET" "/source/$project"
obs_api_call "PUT" "/source/$project/$package/$file" --data "@file.txt"
obs_api_call "DELETE" "/source/$project/$package/$file"参考资料 | References
- OBS API 文档 | OBS API Docs
- OBS 官方文档 | OBS Official Docs
- osc 命令参考 | osc Command Reference
- openSUSE 打包指南 | openSUSE Packaging Guide
许可证 | License
MIT License - 与 OpenClaw AgentSkills 规范兼容 MIT License - Compatible with OpenClaw AgentSkills specification
更新日志 | Changelog
v1.0.0 (2026-03-22)
- 初始版本，完整的 OBS API 支持
- Initial release with full OBS API coverage
- 支持项目、包、构建、请求、文件操作
- Support for projects, packages, builds, requests, file operations
- 中英文双语文档
- Bilingual documentation (Chinese/English)