用途:该技能面向需要编写 Anypoint API Governance 规则集(Validation Profile)的场景,覆盖创建、编写、生成、修改、更新、修复与校验。规则集是首行为 #%Validation Profile 1.0 的 YAML 文件,针对领域模型声明校验规则,每条规则指定目标类、约束属性并分配 violation、warning 或 info 严重级别。
主要能力与用法:技能通过 anypoint-cli-v4 的 governance:ruleset 系列命令工作。开始前须先安装最新治理插件:anypoint-cli-v4 plugins:install mulesoft-anypoint-cli-governance-plugin@latest(要求 1.0.20 及以上,每次启动都执行)。随后解析用户意图,用 governance:ruleset:resolve <term> 解析领域术语;用 governance:ruleset:domains 选择领域;用 governance:ruleset:classes --domain <domain-name> 列出可定位类;用 governance:ruleset:properties <prefix.ClassName> 查属性及类型;用 governance:ruleset:constraints --type <propertyType> 查询适合 scalar、node、scalarArray、nodeArray 的约束。写好后用 governance:ruleset:validate-authoring <path> 校验,通过后再用 governance:ruleset:simplify <path> 简化并复验。
限制与规则:不得猜测类名、属性名或约束兼容性,必须查 CLI;别名仅用于编写期,绝不能写入 YAML,需用规范 targetClass 与路径;单个规则集只能针对一个 specKind,不可混合 api-spec 与 mcp;每条规则必须分配严重级别;node/nodeArray 不得用 pattern 或 in;nodeArray 用 atLeast/atMost,scalarArray 用 containsSome 或用 in 限制全部值;属性路径用 / 分隔,备选路径用 | 并加括号;条件用 if:/then:,逻辑组合用 and:/or:/not:/xone:,Rego 仅作跨资源检查的最后手段。默认前缀无需重复声明,非默认前缀必须声明。修改已有规则集后需重新校验,且校验须零错误才能交付用户。