SuperAPI AI 工具集

archi-mcp-modeling

智能体与模型

查看项目

更新于 10-16 08:49

技能介绍

用途:通过本地 Archi MCP 服务器建模和演进 ArchiMate 架构内容,按任务路由加载参考文件、显式选择工具并安全处理异步变更。适用场景包括创建或更新 ArchiMate 元素与关系、根据需求或模式构建架构视图、做策略→能力→应用→技术的映射、建模微服务/集成/云/迁移路线图、审计模型质量(孤立、重复、错误关系);Archi 服务器常规管理(健康、关闭、配置)仅可参考工具目录。

前提:Archi 5.7+ 且 jArchi 1.11+ 中已打开模型;Archi API 服务器运行中(archi_get_health 返回 healthy);Archi 编辑器中至少打开一个视图(用于撤销)。

用法要点:先读 reference/01-task-routing.md,按需加载 10-mcp-tool-catalog.md、20-modeling-playbook.md、30-operation-recipes.md、40-quality-gates.md,不要一次性全部加载。执行约定:先读后写;优先用 upsert(createOrGetElement/createOrGetRelationship 搭配 onDuplicate: reuse,可加 idempotencyKey);异步调用 archi_apply_model_changes 返回 operationId 后,须用 archi_wait_for_operation 等待再执行依赖操作,archi_populate_view 同为异步;为每个新建元素/关系分配 tempId 并使用解析后的 ID;addConnectionToView 须用视觉对象 ID 而非概念 ID;变更批次建议 ≤8;moveViewObject 用 width/height,createNote 用 content;创建视图时除非确知支持的 key,否则省略 viewpoint;删除操作须用户明确意图;需求不清须先询问;createOrGetRelationship 的 onDuplicate 只支持 error 或 reuse,rename 对关系无效。

完成标准:元素使用语义正确的 ArchiMate 类型,关系方向与具体性正确,无当前会话产生的孤立或幽灵项,视图通过 archi_validate_view 且无阻断性违规,并给出变更摘要;仅在明确要求时保存模型。该技能为活文档,发现新情况应更新对应参考文件。ArchiMate 最佳实践、JArchi 映射、关系矩阵、OpenAPI 规范等外部参考暂未提供具体内容。