security

安全性技能總覽

security 技能能做什麼

security 技能會使用帶有 AWS security stencil 的 PlantUML，建立安全架構圖，涵蓋身分驗證、加密、防火牆、合規性與威脅偵測。它是為了讓需要快速把安全設計轉成圖的人而設計，輸出能清楚到可供審查、稽核或文件使用。

最適合的使用情境

當你的工作重點是說明 IAM 流程、零信任邊界、加密管線、合規監控，或偵測到回應的處理路徑時，就很適合用這個 security 技能。它特別適合 Security Audit、架構審查，以及需要精準安全模型、而不是泛用雲端圖的文件。

為什麼值得安裝

它最大的價值在於 stencil 驅動的工作流程：這個技能會引導你使用安全專用圖示、信任邊界與有方向性的資料流，讓圖更容易閱讀，也更不容易標錯。當你需要在多張安全圖之間維持一致性時，它會比單純靠提示詞更合適。

如何使用 security 技能

安裝並先打開正確的檔案

使用 npx skills add markdown-viewer/skills --skill security 安裝 security 技能。接著先讀 SKILL.md，再看最相關的範例，例如 examples/iam-authn.md、examples/zero-trust.md、examples/compliance-audit.md 和 examples/threat-detection.md。這些檔案會比你整個 repo 到處翻找更快呈現它預期的模式。

給這個技能一個完整的安全目標

好的輸入描述的是安全工作本身，而不只是圖的標題。舉例來說，與其說「畫安全架構」，不如要求「為員工與外包人員繪製一個零信任存取流程，包含 SSO、STS role assumption、網路邊界檢查與稽核記錄」。這個技能在你提供角色、信任邊界、安全控制與希望讀者理解的結果時，表現最好。

用它能跟得上的工作流程

一個好的 security 使用流程是：先定義安全目標，再列出信任區域，接著選擇身分與保護元件，最後用正確的流向把它們串起來。如果你是在畫 Security Audit，請明確指出控制來源、證據儲存、修補路徑與報告目標，讓圖能同時呈現控制與佐證。

產生前先看語法規則

這個 repo 對 PlantUML 格式很嚴格：要使用 @startuml / @enduml，存取流程要維持由左到右，且只用 ```plantuml 或 ```puml 種類的 fenced code block。它也預期使用 rectangle 來表示信任邊界，以及 mxgraph.aws4.* 的 stencil 語法，所以除非圖真的需要，否則不要自己發明自訂形狀。

security 技能常見問答

這個 security 技能適合一般雲端架構圖嗎？

不適合。repo 明確說明不要拿它來畫一般雲端基礎架構；這類需求應該改用雲端導向的技能。這個 security 技能是為了那些主題核心在身分、加密、邊界防護、合規或偵測的圖而設計。

它適合 Security Audit 工作嗎？

適合，尤其當你需要呈現證據流、政策檢查、集中式記錄與修補循環時。針對 Security Audit，最強的圖通常會把 Config、Audit Manager、CloudTrail、Security Hub，搭配儲存或報告輸出一起畫進來，讓稽核路徑從頭到尾都看得見。

初學者不熟 PlantUML 也能用嗎？

可以，但前提是需求裡要有清楚的架構敘事。初學者如果先講出已知的角色、信任區域與控制項，讓技能去把它轉成安全圖，通常效果會更好。模糊的提示詞通常只會產生模糊的圖。

什麼時候不該使用它？

如果你只需要高層次系統草圖、產品總覽，或非安全性軟體模型，就不該用它。若你的主要決策是運算拓樸、服務相依性，或一般 UML 結構，那會有其他更適合的技能。

如何改進 security 技能

先從控制目標開始

最好的 security 輸出，通常都來自一個單一且清楚的目標：「防止橫向移動」、「落實最小權限」、「證明合規證據」或「偵測並回應威脅」。這個目標能幫助技能選對圖示，也能拿捏 Security Audit 或其他審查情境所需的細節層級。

提供具體的實體與邊界

請給明確輸入，例如使用者類型、身分識別提供者、受保護資源、稽核匯入端與強制執行點。像是「員工透過 AD、客戶透過 Cognito、STS 提供暫時性憑證、API Gateway，以及 CloudTrail 匯入集中式 log archive」就遠比「auth flow diagram」更有幫助。

避免把太多安全故事混在一起

常見失敗模式，是把 IAM、加密、網路安全、合規與事件回應全塞進同一張過度擁擠的圖。若第一次產出的圖看起來太滿，建議把需求拆成幾張圖，每張只保留一條安全敘事，這樣流程才會維持可讀性。

補缺漏，不要只調風格

如果結果在結構上大致正確，但內容不完整，請直接要求補上缺少的控制項或證據路徑，不要只說「做得更好」。有用的後續要求包括：加入信任邊界、呈現非同步稽核流程、插入靜態加密，或把泛用防火牆換成對應情境的正確 AWS security stencil。