SuperAPI AI 工具集

homebrew-formula-authoring

通用与其它

查看项目

更新于 10-15 20:27

技能介绍

用途:创作与维护 Homebrew formula,即从源码构建的开源软件(CLI 工具、库),跨 macOS 与 Linux。若为闭源/二进制 .app,应改用 cask 技能。

主要能力与规则:遵循官方 Formula Cookbook、可接受 formula 与包接受政策;保持 formula 最小化;不得为 homebrew-core 手写 bottle do 块;源码须在最新 3 个 macOS 版本(Apple Silicon 与 Intel)及 x86_64 Linux 上可复现构建。本地测试需设 HOMEBREW_NO_INSTALL_FROM_API=1 以读取本地工作副本。

使用方式:先用 brew create --rust <url>(亦可 --go --cmake --meson --autotools --node --python --ruby 等)生成骨架,再补全 desc、homepage、url、sha256、license、def install 与 test do。依赖用 depends_on,构建工具需显式声明为 :build。Python 用 virtualenv_install_with_resources,资源由 brew update-python-resources <formula> 生成。校验按顺序执行:HOMEBREW_NO_INSTALL_FROM_API=1 brew install --build-from-source --verbose --debug <formula>、brew test <formula>、brew style --fix <formula>、HOMEBREW_NO_INSTALL_FROM_API=1 brew audit --new --formula <formula>、brew livecheck <formula>。audit 无输出即通过。

限制与前置条件:需开源且使用 DFSG 许可、已有稳定 tag、具备足够关注度(如 ≥30 forks 或 ≥30 watchers 或 ≥75 stars,自荐门槛更高)、不是重复项或 fork;不得默认 GUI/.app、X11、自更新或繁重手工安装步骤。是否被接受部分由维护者裁量,个人 tap 可作为完整验证载体。提交 PR 须逐条公式一个提交,并在 issue 或 PR 中披露所用 AI/LLM 工具与模型。