用途:该技能面向 Domo Code Engine 的包更新与版本工作流,覆盖更新已有包代码、在已有包 ID 上创建新版本、处理包与 app manifest 之间的映射漂移,以及校验数据类型契约的稳定性。若要处理 app 运行时调用代码,应改用 ~/.agents/skills/code-engine/SKILL.md。
主要能力:首选执行路径为 community-domo-cli,命令示例:community-domo-cli --instance <instance> code-engine update-version <package_id> <version> --body-file payload.json。备用接口为 POST /api/codeengine/v2/packages,在请求体中设置 id 与 version 以实现版本化更新。更新模型:创建新包用 POST /api/codeengine/v2/packages;为已有包创建新版本也用同一端点在请求体中带上 id、version(如 1.0.1)及 code/manifest 负载;更新已有版本用 PUT /api/codeengine/v2/packages/{id}/versions/{version}。若因目标版本已部署或不可变而更新失败,可创建新版本再更新该新版本。创建新版本时建议直接携带完整 code+manifest 负载,后续变更再用 PUT,并始终输出产生的 packageId 与 version 供下游 manifest 同步。
契约与漂移:发布前需比较现有函数别名与拟议别名、参数名称/类型/可空性、输出形状与类型,标记破坏性变更(如删除必填参数、不兼容类型变更);如破坏性变更是有意为之,需在输出中附明确迁移说明。更新后需比对 manifest.json 的 packagesMapping 与返回的包 ID/版本,发现漂移时同步 packageId、version 及参数/输出契约,除非用户要求重命名,否则保持映射别名稳定。
发布安全限制:硬性规则是除非用户明确说出“release”,否则绝不调用任何 Code Engine 发布端点;不得从上下文推断发布,不得把“finish”“publish”“make it work”当作发布,若认为需要发布应先停下并请求明确批准。
适用场景与检查清单:适用于包版本更新、契约演进与清单同步。检查项包括:正确选择更新路径(已有版本 vs 版本化)、校验输入/输出数据类型契约、清晰标记破坏性变更、检查并同步 manifest packagesMapping 漂移、输出包含更新后的包 ID/版本与契约摘要。缺失信息暂未提供。