zig-project-structure

用途：管理 Zig 项目结构全流程，分为项目生成与规范检查两部分。生成侧提供四种模板：基础可执行项目（build.zig + build.zig.zon + src/main.zig）、库项目（src/root.zig 作为公共 API 入口）、大型多模块分层项目（单根 build.zig，各模块独立 src/root.zig，通过 addImport 显式声明依赖，静态库链接）、带第三方依赖项目（在 build.zig.zon 的 dependencies 中声明 url 与 hash）。检查侧从四个维度验证：目录结构（build.zig 必需、src/ 必需、zig-out/ 与 .zig-cache/ 应写入 .gitignore）、文件命名（类型文件 TitleCase.zig，命名空间文件 snake_case.zig，入口固定为 main.zig/root.zig）、构建配置（必须使用 root_module = b.createModule(...)，root_source_file 已移除；build.zig.zon 需含 name、version、minimum_zig_version、paths）、目录命名（snake_case，避免 utils/、misc/ 等模糊命名）。输出为错误/警告/信息三级合规报告。使用方式：创建时确认项目名称、exe/lib 类型、目标 Zig 版本与是否需要依赖；检查时项目根目录需含 build.zig 或 build.zig.zon，检查为静态分析，不要求运行 zig build。前置要求：已安装 Zig 编译器（推荐 ≥ 0.16.0），创建前运行 zig version 确认版本。限制：不用于编写项目逻辑代码、代码风格审查或游戏图形开发；仅检查 .zig 文件，README、LICENSE 不受命名约束；本技能不收集、存储或传输任何用户数据，全部在本地完成。具体命令与模板代码以资料为准。