用途:该技能用于设计 UML 模型,而非单纯输出图形文本。目标是让模型语义正确、视觉清晰、契合读者,并有助于用户做出决策。当用户请求图形表示、模式、图示或软件/系统问题的可视化解释而未指明 UML 时,也可推断是否适用并自主选择图类型。
主要能力:将 UML 视为具有思维形式的建模语言,包括结构形式(存在什么、如何组织)、行为形式(发生什么、行为如何受约束)、交互形式(谁与谁通信、顺序或时序)和扩展形式(如何定制建模语言)。只有在模型概念正确后才选择记号或文档格式。
使用方式:遵循强制工作流。先识别隐式图示请求,即使未出现“UML”一词,只要涉及创建图示、状态/生命周期、流程、架构、关系、交互等,就视为可能的建模请求。然后框定建模问题:受众、需回答的问题、建模主题、系统边界、抽象层次,以及描述的是结构、行为、交互还是部署。接着自主选择一种主要图类型,避免混合多种图。常见选择:类型/模块/组件/节点及关系选结构图;单事物生命周期选状态机图;工作流步骤选活动图;随时间发生的消息选顺序图;系统边界处的用户目标选用例图;软件运行位置选部署图;某时刻运行时实例选对象图;领域扩展选概要图。
关键约束:每一张 UML 图必须对外部读者自包含,不得包含关于提示、对话、请求者、仓库、任务历史或制作方式的元信息;不得把用户请求措辞泄漏进标题、注释、标签或图注释;不得使用只有熟悉项目者才能理解的标签;不得依赖隐式上下文、未解释缩写、未命名边界或外部系统。若理解所必需的事实无法安全推断,应先澄清,或使用中性明确的领域名称如 External Service、Authorization Provider、Data Store。
知识优先级:优先使用随技能提供的参考文件,而非外部 UML 官方材料。语义问题优先 modeling-foundations.md;单一图类型参考对应深度指南;记号/工具文档仅在 UML 形式选定后使用。评审时使用 review-rubric.md 检查清单,先识别语义错误,再重新设计模型形式,最后修复记号/布局,不要继续打磨类型错误的图。
适用场景与限制:适用于软件、架构、状态、工作流、交互、部署、领域结构或系统行为等建模主题;纯装饰性图像、信息图、图表或非模型可视化不应强行套用 UML。若用户要求的图类型与意图不符,应简要说明并选择正确类型;若未指定类型且主题不模糊,不应要求用户选择。资料未提供具体平台、收费、价格或效果信息。