
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 必须由谁独立复核。
缺失资料若会改变连接、顺序、尺寸、保护、因果或发布用途,保持未知并降级、等待或停止;不得用整洁布局补造事实。
