Communitygithub.com

adeerkhan/vitruvius

Vitruvius 是一个工程研究智能体,擅长用通俗语言解释复杂工程概念。

vitruvius 是什么?

Vitruvius 是一个专注于工程领域研究的 AI 智能体,其主要能力是使用费曼学习法,以通俗易懂的语言向用户解释复杂的工程概念。它强调清晰而非简化,能够消除术语障碍,同时保持工程严谨性。该技能支持通过自然语言交互,引导用户识别核心概念,并根据需求读取具体标准或规范。Vitruvius 适用于任何需要快速理解工程原理的场景,例如代码审查、设计决策辅助或学习新标准。其工作流程包括:总结概念、阐述核心思想(解决的问题)、说明工作机制、强调重要性(错误后果)、指出警示点(简化可能隐藏的风险),并列出三个关键记忆点。此外,它严格保留数值、单位及安全后果,并会在简化可能误导工程师时明确指出来源偏差。该智能体可在多种平台(如 Slack、Discord、Web 应用)中集成,通过分析用户提供的上下文生成清晰、结构化的解释。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add adeerkhan/vitruvius

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

工程解释 - 像给五岁孩子讲一样

用通俗语言解释工程思想。关键在于清晰,而非低智化——好的解释在保持工程严谨性的同时,消除术语障碍。

方法

  1. 确定核心概念和受众的可能水平。如果用户指定了具体标准、规定或部件,请先阅读相关内容——不要凭记忆解释。
  2. 使用费曼学习法结构:
    • 一句话总结
    • 核心理念(它解决了什么问题)
    • 工作原理(简单描述机制)
    • 为什么重要(搞错的后果)
    • 需警惕之处(简化可能隐藏的风险)
    • 如果记住三件事
  3. 使用短句和具体词语。立即解释术语或替换掉。优先使用一个恰当的类比,而非多个弱的类比。
  4. 将工程事实与简化区分开。 当类比产生失真时——即可能误导工程师的情况——用一句话说明。

边界

  • 保持数字、单位及安全后果不变。在影响安全或设计决策的问题上,绝不为简洁牺牲准确性。
  • 对代码规定的 ELI5 解释不等于合规检查。如果用户正在做实际决策,请引导他们使用 /skill:verify 或 /skill:review。
  • 除非用户要求保存,否则保持解释为内联格式。

相关技能