homebrew-github-publish

name	homebrew-github-publish
description	Homebrew Tap GitHub 发布助手 - 自动更新 Casks 和 Formulas 版本并发布到 GitHub Tap 仓库。支持首次发布引导（版本差异触发策略）、手动版本输入、自动版本检测、sha256 校验和计算、多架构支持（arm64/x64）。触发词：首次发布 Homebrew、创建新 Homebrew Cask、更新 Homebrew Cask、发布到 Homebrew Tap、更新 Formula 版本、创建 Homebrew 包。

Homebrew Tap GitHub 发布助手

协助将软件版本更新到 Homebrew Tap 仓库，自动化版本检测、sha256 校验和计算和 GitHub 发布流程。

Reference Documents

Document	Content
references/initial-publish-guide.md	⭐ 首次发布引导（版本差异触发策略）
references/cask-template.md	Cask 模板语法与结构（含 postflight xattr）
references/formula-template.md	Formula 模板语法与结构
references/font-template.md	Font Cask 模板与命名规范
references/workflow-template.md	GitHub Actions workflow 模板
references/version-detection.md	版本检测策略
references/best-practices.md	最佳实践与常见问题
references/real-world-examples.md	真实项目示例（含 GitHub Action 实例）

---

类型分类与目录规则

三种类型自动判断

类型特征	目录	安装位置	判断依据
Formula	Formula/	/opt/homebrew/bin	CLI 工具、命令行程序、库、服务
Cask (App)	Casks/	/Applications	GUI 应用、.dmg/.pkg/.zip 分发
Cask (Font)	Casks/	~/Library/Fonts	字体文件（.ttf/.otf），命名必须以 font- 开头

⚠️ 关键判断点

询问用户：

「请确认软件类型：
- CLI 命令行工具 → Formula (Formula/ 目录)
- GUI 桌面应用 → Cask (Casks/ 目录)
- 字体文件 → Cask Font (Casks/ 目录，命名 font-{name}.rb)

该软件属于哪种类型？」

Font 特殊规则

⚠️ 重要: 字体包有特殊命名和仓库要求：

1. 命名规范: font-{字体名称}.rb（必须以 font- 开头）

   • ✅ font-fira-code.rb
   • ✅ font-source-code-pro.rb
   • ❌ FiraCode.rb（错误格式）
   • ❌ font_fira_code.rb（错误格式）

2. 仓库要求: 字体必须放在独立的 homebrew-fonts Tap（官方要求）

   • 如果用户要发布字体，提示创建独立的 homebrew-fonts 仓库

3. 安装位置: ~/Library/Fonts

类型判断决策表

上游发布文件格式	推荐类型	说明
.dmg / .pkg / .zip (含 .app)	Cask (App)	macOS GUI 应用
.ttf / .otf / .zip (含字体)	Cask (Font)	字体，命名 font-xxx.rb
二进制可执行文件	Formula	CLI 工具
源码压缩包	Formula	需编译的项目
tar.gz / zip (仅二进制)	Formula	预编译 CLI

---

Homebrew Tap 标准布局

homebrew-tap/
├── Casks/                    # macOS 应用包定义
│   ├── app1.rb
│   ├── app2.rb
│   └── ...
├── Formula/                  # 命令行工具定义
│   ├── tool1.rb
│   ├── tool2.rb
│   └── ...
└── .github/
    └── workflows/
        ├── update-app1-version.yml
        ├── update-tool1-version.yml
        └── ...

---

核心功能

1. 版本检测

手动版本输入: 用户指定版本号 自动版本检测: 从 GitHub Releases API 获取最新版本

# GitHub API 获取最新版本
curl -s https://api.github.com/repos/{owner}/{repo}/releases/latest | jq -r '.tag_name' | sed 's/^v//'

2. sha256 校验和计算

⚠️ 重要: sha256 在 GitHub Actions workflow 运行时自动计算和更新，Cask/Formula 文件中不需要预先填写真实的 sha256

workflow 会:

1. 下载发布文件
2. 计算 sha256
3. 使用 sed 命令更新 Cask/Formula 文件中的 sha256

# Workflow 中计算 sha256
sha256sum /tmp/file.dmg | awk '{print $1'}

# Workflow 中更新 Cask 文件
sed -i '/on_arm do/,/end/{s/sha256 ".*"/sha256 "${{ steps.checksums.outputs.arm64_sha256 }}"/}' Casks/{name}.rb

⚠️ 具体 sed 替换示例:

场景	sed 命令	说明
更新版本号	sed -i 's/version ".*"/version "1.2.3"/' Casks/myapp.rb	替换 version 行
更新 arm64 sha256	sed -i '/on_arm do/,/end/{s/sha256 ".*"/sha256 "abc123"/}'	在 on_arm 块内替换
更新 x64 sha256	sed -i '/on_intel do/,/end/{s/sha256 ".*"/sha256 "def456"/}'	在 on_intel 块内替换
更新单架构 sha256	sed -i 's/sha256 ".*"/sha256 "abc123"/' Casks/myapp.rb	直接替换
更新 URL 中版本	`sed -i 's	/v[0-9.]*-/

完整 workflow 更新示例:

- name: Update cask file
  run: |
    # 更新版本号
    sed -i "s/version \".*\"/version \"${{ steps.version_check.outputs.new_version }}\"/" Casks/myapp.rb
    
    # 更新 arm64 sha256（在 on_arm do 到 end 之间）
    sed -i '/on_arm do/,/end/{s/sha256 ".*"/sha256 "${{ steps.checksums.outputs.arm64_sha256 }}"/}' Casks/myapp.rb
    
    # 更新 x64 sha256（在 on_intel do 到 end 之间）
    sed -i '/on_intel do/,/end/{s/sha256 ".*"/sha256 "${{ steps.checksums.outputs.x64_sha256 }}"/}' Casks/myapp.rb

3. 多架构支持

• arm64 (Apple Silicon): on_arm do
• x64 (Intel): on_intel do

---

Cask 模板

基本 Cask 结构

⚠️ sha256 使用占位符，workflow 运行时会自动更新

cask "{name}" do
  version "{version}"  # workflow 会更新

  on_arm do
    sha256 "PLACEHOLDER"  # workflow 运行时自动计算并替换
    url "https://github.com/{owner}/{repo}/releases/download/v#{version}/{file}-#{version}-mac-arm64.dmg"
  end

  on_intel do
    sha256 "PLACEHOLDER"  # workflow 运行时自动计算并替换
    url "https://github.com/{owner}/{repo}/releases/download/v#{version}/{file}-#{version}-mac-x64.dmg"
  end

  name "{app_name}"
  desc "{description}"
  homepage "https://github.com/{owner}/{repo}"

  livecheck do
    url :url
    strategy :github_latest
  end

  app "{app_name}.app"
end

Cask + postflight xattr 处理

⚠️ macOS Gatekeeper 问题: 从 GitHub Releases 下载的应用可能被 macOS 标记为"已损坏"，需要清除 quarantine 属性：

cask "{name}" do
  version "{version}"
  sha256 "PLACEHOLDER"

  url "https://github.com/{owner}/{repo}/releases/download/v#{version}/{file}.tar.gz"

  name "{app_name}"
  desc "{description}"
  homepage "https://github.com/{owner}/{repo}"

  depends_on macos: ">= :big_sur"  # 可选：macOS 版本限制

  app "{app_name}.app"

  # ✅ 清除 quarantine 属性，解决"已损坏"问题
  postflight do
    system_command "/usr/bin/xattr",
                   args: ["-cr", "#{appdir}/{app_name}.app"],
                   sudo: false
  end

  # 卸载后清理
  zap trash: [
    "~/.{app_name}",
    "~/Library/Application Support/{app_id}",
    "~/Library/Caches/{app_id}",
    "~/Library/Preferences/{app_id}.plist",
    "~/Library/Saved Application State/{app_id}.savedState",
  ]
end

何时需要 postflight xattr:

• 从 GitHub Releases 下载的未签名应用
• macOS 报告"已损坏，无法打开"错误
• 用户需要手动运行 xattr -cr 才能打开

⚠️ 检查点: 询问用户是否需要 xattr 处理：

「上游应用是否已签名？
- 已签名（有 Apple Developer 签名） → 不需要 postflight
- 未签名（GitHub Releases 直接发布） → 需要添加 postflight xattr

是否需要添加 xattr 处理？」

单架构 Cask

⚠️ sha256 使用占位符

cask "{name}" do
  version "{version}"
  sha256 "PLACEHOLDER"  # workflow 自动更新

  url "https://github.com/{owner}/{repo}/releases/download/v#{version}/{file}-#{version}.dmg"

  name "{app_name}"
  desc "{description}"
  homepage "https://github.com/{owner}/{repo}"

  app "{app_name}.app"
end

---

Formula 模板

基本 Formula 结构

⚠️ sha256 使用占位符，workflow 运行时自动计算和更新

class {ClassName} < Formula
  desc "{description}"
  homepage "{homepage}"
  version "{version}"
  license "{license}"

  on_macos do
    if Hardware::CPU.arm?
      url "{arm64_url}"
      sha256 "PLACEHOLDER"  # workflow 自动更新

      def install
        bin.install "{binary}" => "{name}"
      end
    end

    if Hardware::CPU.intel?
      url "{x64_url}"
      sha256 "PLACEHOLDER"  # workflow 自动更新

      def install
        bin.install "{binary}" => "{name}"
      end
    end
  end

  def caveats
    <<~EOS
      {name} has been installed!
      ...
    EOS
  end

  test do
    system "#{bin}/{name}", "--version"
  end
end

---

Font Cask 模板

⚠️ Font 特殊规则

1. 命名: 必须以 font- 开头，如 font-fira-code.rb
2. 仓库: 字体需要独立的 homebrew-fonts Tap
3. 安装: 使用 font 指令而非 app

单个字体文件

cask "font-{name}" do  # ✅ 必须以 font- 开头
  version "{version}"
  sha256 "PLACEHOLDER"

  url "https://github.com/{owner}/{repo}/releases/download/v#{version}/{font}.ttf"

  name "{font_name}"
  desc "{description}"
  homepage "https://github.com/{owner}/{repo}"

  livecheck do
    url :url
    strategy :github_latest
  end

  font "{font}.ttf"  # ✅ 使用 font 指令
end

字体家族（多个字重）

cask "font-{name}-family" do
  version "{version}"
  sha256 "PLACEHOLDER"

  url "https://github.com/{owner}/{repo}/releases/download/v#{version}/{family}.zip"

  name "{font_name} Family"
  desc "{description}"
  homepage "https://github.com/{owner}/{repo}"

  # 安装多个字重
  font "{family}-Thin.ttf"
  font "{family}-Light.ttf"
  font "{family}-Regular.ttf"
  font "{family}-Medium.ttf"
  font "{family}-Bold.ttf"
  font "{family}-Italic.ttf"
end

字体在子目录中

cask "font-{name}" do
  version "{version}"
  sha256 "PLACEHOLDER"

  url "https://github.com/{owner}/{repo}/releases/download/v#{version}/fonts.zip"

  name "{font_name}"
  homepage "https://github.com/{owner}/{repo}"

  # 字体在 ZIP 的子目录
  font "fonts/ttf/{font}-Regular.ttf"
  font "fonts/ttf/{font}-Bold.ttf"
  font "fonts/otf/{font}-Regular.otf"
end

---

GitHub Actions Workflow

标准 Workflow 模板

name: Update {AppName} Version

on:
  workflow_dispatch:
    inputs:
      version:
        description: "Version number (e.g., 1.0.0). Leave empty to auto-detect."
        required: false
        type: string
  schedule:
    - cron: "0 */12 * * *"

jobs:
  update-cask:
    runs-on: ubuntu-latest
    permissions:
      contents: write

    steps:
      - name: Checkout repository
        uses: actions/checkout@v6

      - name: Get latest version
        id: version_check
        run: |
          CURRENT_VERSION=$(grep 'version "' Casks/{name}.rb | sed 's/.*version "\(.*\)".*/\1/')
          if [ -n "${{ inputs.version }}" ]; then
            NEW_VERSION="${{ inputs.version }}"
          else
            NEW_VERSION=$(curl -s https://api.github.com/repos/{owner}/{repo}/releases/latest | jq -r '.tag_name' | sed 's/^v//')
          fi
          echo "current_version=$CURRENT_VERSION" >> $GITHUB_OUTPUT
          echo "new_version=$NEW_VERSION" >> $GITHUB_OUTPUT
          echo "should_update=$([[ '$CURRENT_VERSION' != '$NEW_VERSION' ]] && echo true || echo false)" >> $GITHUB_OUTPUT

      - name: Download files and calculate checksums
        if: steps.version_check.outputs.should_update == 'true'
        run: |
          # Download arm64 file
          curl -f -L -o /tmp/{name}-arm64.dmg "https://github.com/{owner}/{repo}/releases/download/v${{ steps.version_check.outputs.new_version }}/{file}-v${{ steps.version_check.outputs.new_version }}-mac-arm64.dmg"
          # Download x64 file
          curl -f -L -o /tmp/{name}-x64.dmg "https://github.com/{owner}/{repo}/releases/download/v${{ steps.version_check.outputs.new_version }}/{file}-v${{ steps.version_check.outputs.new_version }}-mac-x64.dmg"
          # Calculate checksums
          ARM64_SHA256=$(sha256sum /tmp/{name}-arm64.dmg | awk '{print $1}')
          X64_SHA256=$(sha256sum /tmp/{name}-x64.dmg | awk '{print $1}')
          echo "arm64_sha256=$ARM64_SHA256" >> $GITHUB_OUTPUT
          echo "x64_sha256=$X64_SHA256" >> $GITHUB_OUTPUT

      - name: Update cask file
        if: steps.version_check.outputs.should_update == 'true'
        run: |
          sed -i "s/version \".*\"/version \"${{ steps.version_check.outputs.new_version }}\"/" Casks/{name}.rb
          sed -i '/on_arm do/,/end/{s/sha256 ".*"/sha256 "${{ steps.checksums.outputs.arm64_sha256 }}"/}' Casks/{name}.rb
          sed -i '/on_intel do/,/end/{s/sha256 ".*"/sha256 "${{ steps.checksums.outputs.x64_sha256 }}"/}' Casks/{name}.rb

      - name: Commit and push changes
        if: steps.version_check.outputs.should_update == 'true'
        run: |
          git config user.name "github-actions[bot]"
          git config user.email "github-actions[bot]@users.noreply.github.com"
          git add Casks/{name}.rb
          git commit -m "chore: update {AppName} to version ${{ steps.version_check.outputs.new_version }}"
          git push

---

工作流程

Phase 0: 首次发布检测与引导 ⭐ 新增

输入: 用户请求（创建新 Cask 或 Formula） 输出: 发布方式选择 + 初始版本号策略 + 软件类型确认

Step 0.1: 检测包状态

⚠️ 关键检查点: 确定是否首次发布

# 在 Tap 仓库中检查文件是否存在
ls Casks/{name}.rb Formula/{name}.rb

# 或使用 git 检查
git ls-files Casks/{name}.rb Formula/{name}.rb

状态	处理方式
文件不存在	进入首次发布引导流程
文件已存在	跳过 Phase 0，进入正常更新流程（Phase 1）

Step 0.2: 引导用户选择发布方式

⚠️ 必须询问用户:

询问用户：
「检测到该 Cask/Formula 尚未在 Homebrew Tap 发布，属于首次发布。

有两种方式完成首次发布：

【方案 A】GitHub 自动发布（推荐）
- 自动获取最新版本，设置初始版本号（patch version 回退）
- GitHub Action 检测版本变化后自动更新发布
- sha256 checksum 由 workflow 自动计算
- 简单快捷，无需手动操作

【方案 B】传统手动发布
- 手动创建 Cask/Formula 文件
- 手动计算 sha256 checksum
- 手动运行 brew audit 验证
- 手动提交推送
- 需要熟悉 Homebrew 规范

是否选择 GitHub 自动发布？」

Step 0.3: 确认软件类型

⚠️ 首次发布必须确认类型:

询问用户：
「请确认软件类型：
- CLI 命令行工具 → Formula (Formula/ 目录)
- GUI 桌面应用 → Cask (Casks/ 目录)
- 字体文件 → Cask Font (Casks/ 目录，命名 font-{name}.rb)

该软件属于哪种类型？」

Step 0.4: 确定初始版本号（方案 A）

获取最新版本并计算初始版本:

# 获取上游最新版本
LATEST_VERSION=$(curl -s https://api.github.com/repos/{owner}/{repo}/releases/latest | jq -r '.tag_name' | sed 's/^v//')

# 计算 patch version 回退（版本格式 X.Y.Z）
# 示例：1.2.5 → 1.2.4
INITIAL_VERSION=$(echo "$LATEST_VERSION" | awk -F. '{print $1"."$2"."$3-1}')

版本回退策略:

版本格式	最新版本	初始版本	算法
X.Y.Z	1.2.5	1.2.4	$3-1
YYYY.MM.DD	2024.01.15	2024.01.14	最后部分 -1
vX.Y.Z	v1.2.5	1.2.4	去掉 v 前缀后 -1
单数字	5	4	直接 -1

无法获取版本号时:

询问用户：
「无法自动获取上游版本号。

请手动输入初始版本号：
- 如果知道最新版本：输入最新版本减一
- 如果不确定：输入一个明显低于预期的版本（如 0.0.1）

初始版本号：」

Step 0.5: 确认架构支持

⚠️ 优先自动检测，再询问用户:

# 自动检测架构支持
curl -s https://api.github.com/repos/{owner}/{repo}/releases/latest | jq -r '.assets[].name' | grep -E 'mac|darwin' | sort -u

# 输出示例分析：
# App-1.0.0-mac-arm64.dmg   → 有 arm64 文件
# App-1.0.0-mac-x64.dmg     → 有 x64 文件
# App-1.0.0_universal.dmg   → Universal 单文件
# 只有 arm64 或只有 x64    → 单架构

架构自动判断规则:

Release 文件命名	检测结果	模板选择
*-arm64.* + *-x64.*	双架构	on_arm do / on_intel do
*_universal.* 或 *_macos.*	Universal	单文件，无需架构区分
仅 *-arm64.*	仅 arm64	单架构，直接 sha256
仅 *-x64.* 或 *-amd64.*	仅 x64	单架构，直接 sha256

如无法自动检测，询问用户:

询问用户（Cask）：
「无法自动检测架构支持，请确认：
- arm64 + x64 → 双架构模板（on_arm/on_intel）
- 仅 arm64 → 单架构
- universal → 单文件（无需架构区分）

支持哪些架构？」

Step 0.6: 生成初始 Cask/Formula

使用初始版本号生成文件:

• version 使用初始版本号（低于最新）
• sha256 使用 PLACEHOLDER（workflow 自动计算）
• 提交后用户触发 workflow，自动发布最新版本

首次发布完成标志:

1. 提交初始 Cask/Formula 到 GitHub
2. 用户手动触发 workflow 或等待定时触发
3. Workflow 检测版本变化，自动更新 checksum 并发布

⚠️ 检查点: 详细流程请参阅 references/initial-publish-guide.md

---

Phase 1: 信息收集

输入: 用户请求（创建/更新 Cask 或 Formula） 输出: 上游仓库信息确认清单

Step 1.1: 确认上游仓库信息

⚠️ 检查点: 在创建之前，必须确认以下信息：

必需信息	说明	用户确认方式
GitHub owner/repo	上游仓库地址	用户提供或从 URL 提取
发布文件格式	dmg、zip、tar.gz 等	分析 GitHub Releases
架构支持	arm64/x64 或 universal	分析发布文件命名
应用名称	用于 cask/formula 名称	用户确认

询问用户：
「请确认以下信息：
- GitHub 仓库: {owner}/{repo}
- 发布文件格式: {format}
- 架构支持: {archs}
- Cask/Formula 名称: {name}

是否正确？」

Step 1.2: 分析发布文件命名规则

从 GitHub Releases 分析文件命名：

• App-{version}-mac-arm64.dmg → arm64 架构
• App-{version}-mac-x64.dmg → x64 架构
• App-{version}_universal.dmg → Universal（单文件）

---

Phase 2: 文件生成

输入: Phase 1 确认的信息 输出: Cask/Formula 文件 + GitHub Workflow

Step 2.1: 生成 Cask 或 Formula

根据架构支持选择模板：

• 双架构: 使用 on_arm do / on_intel do
• 单架构: 直接 sha256 + url
• Universal: 单文件，无架构区分

⚠️ 检查点: sha256 使用 PLACEHOLDER 占位符，确认用户理解：

询问用户：
「Cask/Formula 中的 sha256 使用 PLACEHOLDER 占位符，
GitHub Actions workflow 运行时会自动下载文件并计算真实 sha256。
是否继续？」

Step 2.2: 生成 GitHub Workflow

生成自动更新 workflow，包含：

• workflow_dispatch: 手动触发 + 版本输入
• schedule: 定时检查（推荐每12小时）
• checksum 自动计算步骤

---

Phase 3: 验证与发布

输入: Phase 2 生成的文件 输出: 验证结果 + 发布到 GitHub

Step 3.1: 本地验证（可选）

# 验证 Cask
brew audit --cask {name}
brew style --cask {name}

# 验证 Formula
brew audit {formula}

⚠️ 检查点: 验证失败时询问用户：

如果 brew audit 报错：
「验证发现问题：{error}
是否继续提交，或先修复问题？」

Step 3.2: 提交到仓库

git add Casks/{name}.rb Formula/{name}.rb .github/workflows/update-{name}-version.yml
git commit -m "feat: add {name} Homebrew Cask/Formula with auto-update workflow"
git push

---

边界条件与错误处理

异常情况	处理方式	Fallback
GitHub API 不可达	提示用户手动输入版本	使用用户指定版本
发布文件不存在	检查文件命名规则	询问用户确认 URL 格式
sha256 计算失败	文件下载失败	检查 curl 错误并提示
brew audit 报错	显示具体错误	用户选择修复或跳过
版本格式不规范	处理 v 前缀等	sed 's/^v//'
多架构文件缺失	只有单架构	询问用户是否降级为单架构
文件大小异常	验证下载文件大小	文件小于预期提示重试
livecheck 检测失败	无法自动检测版本	用户手动输入版本号
Cask 已存在但用户请求首次发布	提示已存在，进入更新流程	确认用户意图
字体命名冲突	检查 AUR/Homebrew 是否已有同名	建议使用不同命名

---

决策速查表

场景	决策
首次发布检测	必须检查: 检查文件是否存在于 Tap 仓库
首次发布方式	必须询问: 方案 A（GitHub 自动）或方案 B（手动）
初始版本号	自动计算: patch version 回退（最新版本 -1）
版本号无法获取	询问用户: 手动输入初始版本号
软件类型判断	必须询问: CLI/GUI/Font？
架构支持	必须询问: arm64/x64/universal？
用户未提供架构信息	询问: 「该应用支持哪些架构？arm64/x64/universal？」
用户未提供文件格式	分析: 从 GitHub Releases 页面获取文件列表
sha256 是否预填	使用 PLACEHOLDER: workflow 自动计算
是否需要 livecheck	推荐添加: 自动版本检测
定时更新频率	推荐: 每12小时 (0 */12 * * *)
应用是否签名	询问: 未签名需添加 postflight xattr
字体命名	必须: font-{name}.rb 格式
字体仓库	推荐: 独立 homebrew-fonts Tap

---

常用命令

本地验证

# 验证 Cask
brew audit --cask {name}
brew style --cask {name}

# 验证 Formula
brew audit {formula}
brew style {formula}

# 本地安装测试
brew install --cask {name}
brew install {formula}

版本检测

# 获取最新版本
curl -s https://api.github.com/repos/{owner}/{repo}/releases/latest | jq -r '.tag_name' | sed 's/^v//'

# 检查版本格式
echo "v1.2.3" | sed 's/^v//'  # 输出: 1.2.3

---

最佳实践

✅ 推荐做法

1. 使用 livecheck: 配置自动版本检测
2. 多架构支持: 为 arm64 和 x64 分别提供 sha256
3. 定时更新: 设置 schedule 自动检查版本
4. 手动触发: 提供 workflow_dispatch 支持手动指定版本
5. 校验和验证: 确保下载文件大小合理后再计算 sha256

❌ 避免的做法

1. 硬编码版本: 不使用 livecheck
2. 单架构支持: 只支持 Intel Mac
3. 跳过验证: 不运行 brew audit
4. 忽略错误: curl 失败不检查
5. 手动 sha256: 不自动计算校验和

---

触发场景

使用此技能的场景:

• 「帮我更新 Homebrew Tap 中的 xxx 版本」
• 「创建一个新的 Homebrew Cask」
• 「添加一个 Homebrew Formula」
• 「发布 xxx 到我的 Homebrew Tap」
• 「更新 xxx 的 sha256 校验和」
• 「为 xxx 创建自动更新 workflow」

---

输入要求

创建/更新 Cask 或 Formula 时，请提供:

1. 上游仓库信息: GitHub owner/repo
2. 应用名称: 用于 cask/formula 名称
3. 发布文件格式: dmg、zip、tar.gz 等
4. 架构支持: 是否需要多架构
5. 版本号: 手动指定或自动检测

---

输出格式

技能将生成:

1. Cask/Formula 文件: .rb 文件
2. GitHub Workflow: .github/workflows/update-xxx-version.yml
3. 更新说明: commit message 格式
4. 验证结果: brew audit 输出

详见各 reference 文档获取完整模板和示例。