tacbench-gunpack-structure-analyzer

name	tacbench-gunpack-structure-analyzer
description	Analyze TACZ gunpack folders or zip packs for Tacbench. Use when work involves scanning gunpack structure, building a resource graph, tracing references, finding hidden entries, alias relationships, orphan files, missing language keys, or compatibility anomalies in Tacbench sample packs.

Tacbench Gunpack Structure Analyzer

适用于 Tacbench 的枪包结构分析工作。

Use this skill when

• 需要读 tacz/ 样本目录或第三方枪包。
• 需要分析 folder + zip 枪包结构。
• 需要输出资源图、引用关系、异常项或兼容性结论。
• 需要为 schema、validator、编辑器页面提供真实样本依据。

Read first

• AGENTS.md
• Tacbench V1 plan
• Workbench ADR
• ../../../tacz/ 下的真实样本

Workflow

1. 先确认输入根目录、是否包含文件夹包和 zip 包。
2. 识别每个包的 gunpack.meta.json、assets/{namespace}/gunpack_info.json、data/*、assets/*。
3. 按 index / data / display / recipes / tacz_tags / recipe_filters / lang / client scripts / gameplay scripts / assets 分类。
4. 建立资源节点与引用边，重点看 display、data、ammo、script、model、texture、animation、state_machine。
5. 额外标记：
   • hidden 条目
   • 共享 data/display
   • 未被引用的孤儿文件
   • 缺失语言键
   • 外部 namespace 依赖
   • 默认包覆盖风险
6. 输出结论时优先给 Tacbench 可消费的结构化结果，而不是只做口头描述。

Output expectations

• 列出包清单、namespace、包类型。
• 列出主要资源类型规模和异常项。
• 指出引用链路和断链位置。
• 明确哪些结论来自样本，哪些来自推断。
• 如果准备修改代码，说明这些发现将落到哪个 packages/* 模块。

Guardrails

• 保留未知字段和未知文件，不把“看不懂”误报成错误。
• 不把 melee 强塞进 gun 核心世界观；它在 Tacbench 中是插件模块。
• 不要假设 JSON 是严格 JSON；默认按 JSONC 看待。
• 如果需要 TACZ 源码佐证，再读 references/tacz-src/，不要反过来让源码主导 Tacbench 架构。