架構或流程繪圖工具

平常工作的時候多少都會製作架構圖或者流程圖,以下提供幾款好用的工具。

diagrams.net

官網: diagrams.net
home-dia1

這款應該算是蠻泛用的,可以線上編輯也可以下載應用程式離線使用。
操作方式蠻直覺的,不過提供的圖案都相對比較基本一點就是。

PlantUML

官網: PlantUML
b0W6nPw8lg

這款比較特殊一些,是使用文本的方式來進行繪圖,也因為使用文本所以可以加入版控跟著專案走。
撰寫的方式也不算太難,Visual Studio Code 也有相對應的 套件 可以使用,算是蠻方便的。

Excalidraw

官網: Excalidraw
Untitled-2022-09-26-1053

這款則是只提供純線上編輯,提供的工具也都只有基本的樣式,但一般的架構也夠用了,尤其手繪的風格相當好看。


參考:

Read more

GitHub SDD Tools: spec-kit

GitHub SDD Tools: spec-kit

最近很夯 SDD,然後 GitHub 也出了工具 spec-kit 來幫助開發者撰寫 SDD 文件。 這個工具可以讓你直接用自然語言來描述你的需求,然後自動生成 SDD 文件。 spec-kit 支援來幾乎現在市面上所有的 AI Coding 工具,而且一直持續在更新。 以下是目前(0.0.79)版本可用的指令以及指令的用處: * 核心指令: 指令 用途 /speckit.constitution 建立或更新專案管理原則和開發指南 /speckit.specify 建立需求和使用者故事 /speckit.plan 建立實施計劃 /speckit.tasks 生成 Task /speckit.implement 執行 Task * 選擇性指令: 指令 用途 /speckit.clarify 釐清不明確的規格,

By Mars
Debug Story

Debug Story

Ref: * 寫程式不是輸出,是內化 * Vibe Story:用敘事智能為程式碼注入生命,簡化維護 這篇主要是想紀錄一下看了Ruddy 老師的文章後想做的事情,雖然通篇的重點不是在我想做的這件事,但因為Ruddy 老師的這篇文章讓我覺得以後在排除 Bug 的時候應該要做這件事才對。 以下的內容是擷取 Ruddy 老師的內容(部分修改) 1. 記錄搜尋路徑與嘗試過的假設 => 我以為是 state 沒清,但發現是 effect 未執行 2. 為錯誤進行分類,然後標註成概念 => 這是 mutable state 的副作用問題 3. 寫一段描述該段程式的情境與原則 => Vibe Story 該段程式的情境與原則可以參考一下的要點撰寫: * 場景(Context):描述程式碼的背景與需求。 * 目標(Goal):說明功能目的。 * 挑戰與迭代(Challenges &

By Mars