用途:脚手架化一个生产可用的 Zig 命令行应用,零外部依赖,产出约 1MB 的单一静态二进制,可从任意平台交叉编译到 macOS、Linux 和 Windows,并通过 curl | sh(Windows 用 install.ps1)分发给 AI 编码代理。
主要能力:生成 build.zig、build.zig.zon、src/main.zig(命令路由与参数解析)、src/help.zig(面向 AI 代理可读的完整帮助文本)、各子命令实现、justfile(build/test/dist/release)、install.sh、install.ps1、.gitignore 和 CLAUDE.md。按需生成配置模块(~/.{{APP_NAME}}.json)与 configure 命令;按需生成 HTTP API 客户端,并可用 openapi2zig 从 OpenAPI 规范生成类型与客户端。
使用方式:先确认 zig version 为 0.15.x 或更高,收集应用名、描述、初始子命令、是否需要配置与 API 客户端(含 base URL)。依次执行 mkdir -p <app-name>/src/commands、cd <app-name>、zig init、rm src/root.zig,再按模板替换占位符生成文件。首次 zig build 会因指纹错误失败并给出正确值,更新 build.zig.zon 后重试。验证命令:zig build、zig build test、zig build run -- --help。交叉编译用 just dist。
限制与注意:生成的 OpenAPI 代码在 Zig 0.15.2 上无法直接编译,需手动修复函数名、扁平化嵌套类型、更新旧 API 调用、补充 Bearer 认证、响应处理与 base URL。Zig 0.15.2+ 需使用 std.fs.File.stdout()、非托管 ArrayList、std.json.fmt、std.http.Client.fetch() 等模式;循环中表格行需堆分配;main 签名为 pub fn main() !void;CLI 建议用 std.heap.page_allocator。新增命令必须同步更新 main.zig、help.zig 和命令实现三个文件。其他细节暂未提供。