Skills

Create Technical Diagrams

创建、编辑、诊断并验收说明对象组成、连接、流程、状态、时序、接口或因果机制的技术图解与工程文档。用于说明/培训图、系统与网络拓扑、流程与...

Install

npx skills add EverMind-AI/Raven --skill create-technical-diagrams -g -a claude-code -y
Repository
EverMind-AI/Raven6k
Category
Engineering
Updated
3d ago
License
Apache-2.0
Context cost
Mediumabout 1,774 tokens
Runs scripts
No, instructions only

What it does

创建、编辑、诊断并验收说明对象组成、连接、流程、状态、时序、接口或因果机制的技术图解与工程文档。用于说明/培训图、系统与网络拓扑、流程与 SFC、电气/仪控图、机械剖面、科学机制图及其可编辑原生源;按用途与 assurance 区分说明、培训、维护和受控工程声明,不用于以数值规律为主的数据图、保留真实地理位置的地图、产品工作台或参数仿真。

创建技术图解与工程文档

领域职责与接口

本 Skill 拥有技术关系、任务子型、用途风险、领域 gate、claim ceiling、失败返回和专业签审门;工作 状态、authority/tool/review/promotion、通用渲染与证据治理沿用 $visual-artifact-design。

先按本文件路由。需要子型模型、专业语法和检查项时读取领域模式与检查;需要选择工具时只读取相关的工具能力档案。工具名称、文件扩展名、成功导出和漂亮 PDF 都不能证明领域正确。

路由子型与用途等级

按读者要完成的判断选择一个主子型;其他视图必须回指同一对象或接口,不把异构语义硬叠在一页。

主子型必须保真的关系常见原生能力
说明/培训图对象、主关系、方向、边界、抽象声明结构化 diagram、矢量说明、文档发布
系统/网络组件、端口、接口、分区、依赖、冗余或信任边界graph/diagram 或 MBSE 模型
流程/SFC/时序步骤或状态、事件、守卫、动作、分支、失败与恢复BPMN、SFC/PLC 或文本图模型
电气/仪控/工艺设备、端子、导体/管线、信号、回路、代号与跨页引用ECAD/EDA、P&ID/仪控模型
机械/系统剖面方位、剖切、装配、接口、尺寸/公差及来源参数化 CAD 与关联工程图
科学机制实体、过程、条件、因果方向、反馈、证据与不确定性结构化模型加技术矢量图

用 claim scope 选择最高用途等级,不用画面外观推断:

等级允许的最高领域声明额外前提
L0 说明草案内部概念、说明或培训候选;不可操作事实/假设分开,限制可见
L1 复核培训指定受众的培训或技术说明合格领域 reviewer 覆盖相应 claims
L2 维护辅助指定配置的维护、调试或故障定位辅助as-configured/as-built 来源、原生 ID/端口、现场或维护复核
L3 受控工程工程、施工、安全或合规范围内的受控文件设计依据、适用标准、计算/危害证据、授权校核与发布流程

SELF_REVIEW_ONLY 最高停在 L0;它可以支持当前 build 的限定技术/协议 internal-positive,但不能证明视觉独立通过、领域外部正确、现场有效或 L1, L3。externally-validated 只覆盖独立且角色合格的 reviewer 对同一 build_hash 明确通过的 claims。

领域契约

在进入 gate 前记录:

  • operation_mode: Create | Edit | Diagnose | Audit、主子型、读者任务、最终消费者、目标媒介、目标用途等级和误用后果;
  • positive_for 候选、明确非目标、not_evidence_for 与 excluded_claims;
  • 必须准确、允许抽象、未知/假设、适用标准族及辖区/组织 profile;
  • 需要共享的对象、端口、关系、状态、单位、方向、来源和稳定 ID;
  • 授权 workspace 与写入边界,工具、符号库、字体、素材和第三方数据的来源、版本与许可;
  • 需要的专业角色,以及哪些 claims 必须由谁独立复核。

缺失资料若会改变连接、顺序、尺寸、保护、因果或发布用途,保持未知并降级、等待或停止;不得用整洁布局补造事实。

操作、媒介与验证合同

Read the whole SKILL.md on GitHub

More in Engineering