用途:为 MSW 项目端到端编写 .behaviourtree 行为树文件,从收集需求到生成并校验 JSON。
主要能力:读取项目规范 .behaviourDocs/bt-spec.md 作为数据来源;生成文件包装与 UUID;构建 RootNode→Nodes 图;填充 Blackboard 变量与节点属性(nodeProperties);按固定图规则校验并写出文件。
使用方式:先读取 <ProjectRoot>/.behaviourDocs/bt-spec.md;若缺失则先调用 msw-behaviourtree-spec-builder(手动可执行其 scripts/build-spec.cjs 并设置 --projectRoot)。随后收集用户输入(name、保存路径、树形状、自定义节点、Blackboard 变量、节点属性),用 node -e "console.log(require('node:crypto').randomUUID())" 生成 UUID,解析 definitionId,构建 Blackboard 与 nodeProperties,装配 Nodes,最后写文件并用 node -e "JSON.parse(require('node:fs').readFileSync(process.argv[1],'utf8'))" "<path>" 校验。
限制:所有自定义节点必须已存在于 bt-spec.md,不得凭空发明 UUID;类型字符串须逐字复制且版本号与 CoreVersion 一致;不得写 probability、空数组或旧式字符串坐标;Decorator 同一 Action 的多装饰器必须链式而非扁平;Decorator 不写 nodePosition。具体脚本参数、字段细节以资料所列规则为准,未提供的信息暂未说明。