SuperAPI AI 工具集

homebrew-cask-authoring

设计与创作

查看项目

更新于 10-15 20:27

技能介绍

用途:面向为 Homebrew Cask 提交或维护 cask 的场景,补充 cops 与 audit 管不到的判断规则:资格、命名、清理路径、测试与 PR 行为。规则与 brew style/brew audit 冲突时以工具为准。提交 PR 前需先获取 homebrew-cask 的代理政策:gh api repos/Homebrew/homebrew-cask/contents/AGENTS.md -H 'Accept: application/vnd.github.raw'。

主要能力与要点:cask 保持最小,仅写正确安装、卸载与清理所需 stanza;不要写 url ..., verified:;单系统 cask 需顶层 depends_on :macos 或 :linux,跨平台 cask 无顶层 OS 依赖,OS 专属 artifact 放入 on_macos 或 on_linux。新 cask 需过资格预检:可关注度门槛、仓库与主页域名至少 30 天、macOS 产物须签名并公证、Rosetta 规则、正确仓库归属、查重历史 PR、优先提供 Linux AppImage、预发布需在 audit_exceptions/github_prerelease_allowlist.json 中加 token。

流程:用 brew generate-cask-token "<App Name>.app" 取 token 并人工判断,与用户确认;用 brew create --cask <url> --set-name <token> 起草,desc 写实、无营销词、少于 80 字符;用 lipo -archs 检查架构并加 arch 约束;uninstall 对 pkg 与 installer 必填,必要时补 quit、signal、launchctl;zap 可选但评审通常期望,用 brew generate-zap <token> 生成并人工筛掉噪声;livecheck 仅在默认检查失效时添加;跨平台需注意 arch、os、sha256 与 app_image target 不含版本。

校验:运行 brew style --fix <token>、brew audit --cask --online --os=all --arch=all <token>、brew audit --cask --new <token>、brew lgtm --online,并用 HOMEBREW_NO_INSTALL_FROM_API=1 brew install --cask <token> 与 brew uninstall --cask <token>,按 token 而非文件路径操作;zap 须在应用运行并登录后验证。

限制:需本地 homebrew/cask 检出;brew lgtm 对比本地 main,应先 git fetch origin && git rebase origin/main。PR 一 cask 一提交、保持最小 diff,遵循 AI 披露要求,去除 AI trailer。资料未提供具体费率、平台支持范围或效果承诺。