AgentSkillsCN

package-release

为发布打包voxtype。从二进制文件创建deb和rpm包。适用于构建发行版包时使用。

SKILL.md
--- frontmatter
name: package-release
description: Package voxtype for release. Creates deb and rpm packages from binaries. Use when building distribution packages.
user-invocable: true
allowed-tools:
  - Bash
  - Read
  - Glob

Package Release

Build distribution packages (deb, rpm) for voxtype releases.

Prerequisites

  • •fpm - Install with gem install fpm
  • •rpmbuild - Install with sudo dnf install rpm-build or sudo pacman -S rpm-tools
  • •Pre-built binaries in releases/${VERSION}/

Quick Package

If binaries already exist:

bash
./scripts/package.sh --skip-build ${VERSION}

Full Build + Package

Build binaries and create packages:

bash
./scripts/package.sh ${VERSION}

Options

FlagDescription
--skip-buildUse existing binaries, don't rebuild
--deb-onlyBuild only Debian package
--rpm-onlyBuild only RPM package
--no-validateSkip package validation
--release NSet package release number (default: 1)
--arch ARCHTarget architecture: x86_64 or aarch64

Output

Packages are created in releases/${VERSION}/:

  • •voxtype_${VERSION}-1_amd64.deb
  • •voxtype-${VERSION}-1.x86_64.rpm

Validation

The script automatically:

  1. •Validates binaries for CPU instruction contamination
  2. •Checks deb package structure for duplicate fields
  3. •Verifies required control file fields

Workflow

  1. •Build binaries (Docker for AVX2/Vulkan, local for AVX-512)
  2. •Verify binary versions match expected version
  3. •Run ./scripts/package.sh --skip-build ${VERSION}
  4. •Test package installation in a VM or container

Common Issues

Binary not found:

code
Error: Binary not found: releases/0.4.14/voxtype-0.4.14-linux-x86_64-avx2

Build binaries first or check the version number.

fpm not found:

bash
gem install fpm

Validation failed: Check the specific error. Usually means Docker cache is stale.