磨刀不误砍柴工，良好的工具可以有效提高效力。本文介绍基于Obsidian和GPT打造架构知识库的思路，为架构师提供整理、分享、沉淀架构知识的平台。原文: Solution Architecture Automation With Obsidian and GPT^[1]

chatgpt中文版 http://chatgpt.guige.xyz 

本文介绍的ArchVault是一个旨在帮助架构师将想法转化为设计的工具，是ChatGPT和软件架构的延伸。

我在GitHub创建了一个项目^[2]，方便读者尝试这些技术。

前置条件: 最好对Obsidian有基本的了解，这有篇入门介绍: Obsession with Obsidian^[3]

ArchVault概述

ArchVault的架构基于Nick Milo和ForteLabs的概念，专注于组织Obsidian Vault和构建第二大脑的最好方式，其目的是搜集知识并有效利用GPT AI引擎，以纯文本情势访问Vault中的知识，并包括在GPT查询中。

Atlas

ArchVault的第一部份是Atlas，其概念来自Nick Milo的LYT Vault培训课程^[4]。其主体为内容地图(MoC，Maps of Content)，即存储在全部Vault中的知识内容。MoC通过动态更新Dataview插件，自动展现MoC中被正确标记或链接的内容。

Inbox

基于ForteLabs^[5]开发的CODE技术，Inbox文件夹是新笔记的默许位置。在移动到更适合的地点之前，可以在Inbox中对笔记进行细化。

CODE代表:

• Capture(捕获): 保存有价值的信息
• Organise(整理): 为可操作的用处而贮存
• Distil(蒸馏): 提取精华
• Express(展现): 展现你的作品

PARA目录

PARA系统^[6]是Tiago Forte的"构建第二大脑(BASB, Building a Second Brain)^[7]"方法论的一部份，用于帮助个人有效获得、组织和访问知识和想法，将信息组织成四类高度组织化、易于搜索的数字系统。

PARA代表:

• P: Projects(项目) —— 需要一系列行动的多步骤任务或结果
• A: Areas(区域) —— 多个项目使用的知识所在区域，例如内部模式或解决方案构建块
• R: References(参考资料) —— 完成项目或支稳重点领域所需的材料，如文章、书籍、联系人、网站等
• A: Archives(归档) —— 已完成的项目、参考资料或其他信息，以备将来参考，但当前其实不需要

标准文件夹

体系架构实践有指点标准和原则，例如TOGAF标准信息库(SIB, Standards Information Base)^[8]。在ArchVault中包括这些标准从而帮助GPT取得更准确的响应，并可用于训练像Microsoft Azure Open AI Service^[9]这样的模型。

全景文件夹

图表可以反应技术环境中的逻辑和物理关系，这是有价值的优势。全景文件夹是存储图表和画布文件的适合位置。我们很喜欢图表和模型！

日志文件夹

决策(Decisions)、假定(Assumptions)、问题(Issues)和风险(Risk)日志(DAIR日志)跟踪并记录与决策进程相关的关键元素。DAIR日志包括四个主要组件: 决策、假定、问题和风险。日志在全部决策进程中不断更新，帮助利益相关者和同行了解关键因素，并在实行后评估流程会不会成功。

需求

TOGAF是企业级架构框架，为组织提供通用语言、方法和工具。基于需求的方法^[10]是TOGAF框架的关键方面，强调在设计体系架构之前需要了解组织的业务需求和目标，包括辨认业务需求，定义、分析和肯定优先级，开发体系架构，验证并实现架构。通过坚持这类方法，组织可以构建合适其需求并与业务目标保持一致的体系架构。

数据存储

数据存储库是用于构建软件利用程序的各种数据存储技术或数据库的集合，可以专门用于处理特定数据类型或针对某些利用进行优化。通常包括关系型数据库和非关系型数据库和特殊数据存储技术，如图形数据库、键值存储和文档数据库。每种数据库类型都有其独特的优势和劣势，需要基于利用需求加以选择。

数据存储库为开发人员提供了一系列存储和管理数据的选项，使他们能够根据自己的需要选择最适合的技术。通过访问各种数据存储，开发人员可以选择为其利用程序提供最好性能、可伸缩性和数据管理功能的存储。

任务

任务可以并且应当在Vault中的任何位置基于任何缘由或目的创建，并且需要被跟踪。任务文件夹包括主任务文件，支持将全部Vault中生成的任务合并到一起。

除上面介绍的部份，ArchVault还提供了其他特性和资源来增强解决方案和软件体系架构实践。结合这些组件可以创建全面的体系架构环境，增进知识管理和决策。

模板

ArchVault中的模板对保持一致性和简化新内容的创建相当重要。常见笔记类型(如项目大纲、会议笔记和决策记录)的预定义模板可确保在Vault中统一组织信息。另外，可以对模板进行定制和调剂，以满足特定体系架构需求。

插件

Obsidian支持扩大功能和改良用户体验的各种插件，ArchVault包括以下插件:

1. Auto Note Mover: 该插件可以根据特定规则或条件自动移动或重新组织笔记，帮助笔记保持整洁和结构良好，在笔记愈来愈多时特别有用。
2. DataView: DataView是一个功能强大的插件，允许以结构化和有组织的方式查询、过滤和显示笔记中的信息。使用这个插件，就能够根据元数据、标签或笔记中的内容创建表、列表和其他自定义视图。
3. Editing Toolbar: Editing Toolbar插件为Obsidian的Markdown编辑器添加了可定制的工具栏。此工具栏提供了对常见格式选项的快速访问，例如粗体、斜体、标题、列表等，从而更容易对笔记格式化，而无需记住Markdown语法。
4. Text Generator: 这个插件帮助生成基于预定义模板或人工智能文本生成引擎的文本或内容。可以通过提供建议或填充占位符来帮助用户快速创建草稿、大纲或新笔记。
5. Natural Language Dates: Natural Language Dates插件使用户能够以更容易于人类浏览的格式解析和输入日期，例如"下周一"或"两周后"，帮助用户更容易管理日期(特别是在处理截止日期或安排日程时)。
6. Tag Wrangler: Tag Wrangler是一个可以帮助管理和组织笔记中标签的插件，提供了标签重命名、标签合并和标签自动完成等功能，使标签系统在全部Vault中保持一致和有组织。
7. Obsidian Tasks: Obsidian Tasks是一个任务管理插件，允许创建、管理和跟踪笔记中的任务。使用此插件，可以创建具有截止日期、优先级和完成状态的任务，并可以在专用任务窗格或平常笔记中查看。

通过利用这些插件，架构师可以进一步提高生产力，并确保对知识和任务的有效管理。

协作

ArchVault确保全部团队能够高效工作，并通过增进协作来分享有价值的见解和专业知识。ArchVault不但是为个人架构师设计的，也是为团队合作项目设计的。Vault可以设置为与GitHub等云存储服务同步，允许多个用户贡献和访问知识库。

与GPT AI集成

ArchVault的主要目标之一是通过与GPT AI集成来提高架构师的生产力，允许架构师利用AI的气力来解决复杂问题并做出更明智的决策。GPT AI引擎可以访问存储在Vault中的知识、生成建议、回答问题，并根据可用信息提供见解。

为了实现与GPT AI的无缝集成，可使用以下策略:

1. 结构化数据: 确保存储在ArchVault中的数据具有良好的结构和组织，使GPT AI更容易访问和理解信息，从而产生更准确和相关的建议。
2. GPT提示: 创建并组合针对特定架构任务或问题定制的GPT提示。GPT AI可以通过提供精确、简洁的提示，生成更有针对性、更有价值的响应。
3. 延续学习: 当GPT AI生成响应时，评估建议的准确性和有用性。GPT AI可以通过提供反馈和改进提示来学习和改进，成为架构师愈来愈有价值的工具。
4. 自定义模型: 斟酌为更高级的用例使用根据组织的特定体系架构知识和标准进行培训的自定义GPT模型，为组织提供更准确、更相关的建议。

结论

通过与GPT AI结合，ArchVault为架构师提供了丰富的环境来管理知识、做出明智的决策、改进解决方案和软件架构实践。通过利用本文和本系列后续文章中概述的工具、技术和原则，架构师可以发掘AI和Obsidian的潜力，帮助他们将想法变成现实。

你好，我是俞凡，在Motorola做过研发，现在在Mavenir做技术工作，对通讯、网络、后端架构、云原生、DevOps、CICD、区块链、AI等技术始终保持着浓厚的兴趣，平时喜欢浏览、思考，相信延续学习、毕生成长，欢迎一起交换学习。