用途:在 MSW 项目中端到端编写 .behaviourtree 行为树文件,并维护项目专属编写规范 <ProjectRoot>/.behaviourDocs/bt-spec.md。固定图规则与骨架放在技能 references/ 中,项目规范由本地脚本生成。
主要能力:扫描项目中与 ActionNode/DecoratorNode/CompositeNode 配对的 .codeblock 与 .mlua,提取 definitionId、btNodeType、可见属性名及按 CoreVersion 标记的序列化类型字符串,生成 bt-spec.md;据此组装行为树 JSON,包括 Blackboard 变量、节点属性、UUID、nodePosition,并按清单校验。
使用方式:先运行 node "scripts/build-spec.cjs" --projectRoot "<MSW project root>" 生成或刷新规范(需 Node.js,纯标准库;可省略 --projectRoot,或用 --outputPath、--coreVersion 覆盖;缺少 Environment/config 且未传 --coreVersion 会报错)。随后读取 bt-spec.md,参考 references/skeleton-minimal.json、skeleton-full.json、node-catalog.md 及项目已有 .behaviourtree,收集名称、保存路径、树形、自定义节点、Blackboard 变量与节点属性,生成 UUID,解析 definitionId,构建 Blackboard 与 nodeProperties,组装 Nodes 并写入校验。
适用场景:MSW 行为树的新建、修改与规范同步,尤其是节点增删改名、属性变更或 CoreVersion 升级后。
限制:自定义节点必须已存在于 bt-spec.md,否则应停止询问,不得臆造 UUID;不得写入 probability;Decorator 用单个 decoChildNodes 且不写 nodePosition;空集合字段省略;Blackboard 与运行时 SetRootNode 替换根节点不兼容。资料未提供具体收费、平台与效果信息。