前言¶
在文檔、評審或方案裏補一張架構圖、流程圖，常見做法是手開 draw.io 或 Mermaid 寫一版，再和 AI 來回改文案。圖在對話裏以代碼塊或截圖出現時，後續改版往往要重新排版，也不方便直接交給同事在 draw.io 裏改。
下面介紹 SkillHub 上的 please-drawio-turn（座標 @user_800d68d6/drawiodo，當前版本 2.6.1）。它在用戶提出「畫圖」類需求時介入，產出 .drawio 文件並配合 draw.io 打開，並帶有思考、確認、迭代與版本回溯相關的工作流說明，以及 8 個 Hook Point 安全校驗（以 Skill 自帶說明爲準）。
這是什麼¶
please-drawio-turn 是面向 design-media 分類的社區 Skill，發佈者爲 user_800d68d6，來源標註爲 community。SkillHub 頁面標明 requires_api_key=false，即不依賴額外 API Key 配置項。
一句話定位：當對話裏出現畫圖、生成圖表、架構圖、流程圖、UML、ER 圖、時序圖、思維導圖等意圖時觸發，由 Agent 按 Skill 指引生成 draw.io 可編輯文件，而不是隻輸出一張靜態圖或一段無法直接打開的僞代碼。
核心功能¶
以下能力均來自 SkillHub 官方簡介與頁面描述，未單獨覈實的細節不展開。
- 觸發範圍：畫圖、圖表、架構圖、流程圖、UML、ER 圖、時序圖、思維導圖等自然語言需求。
- 交付物：生成
.drawio文件，並用 draw.io 打開（本機需已安裝或可訪問 draw.io 桌面版 / 配套打開方式，具體以 Skill 內步驟爲準）。 - 工作流：支持 思考 → 確認 → 迭代 → 版本回溯 的完整流程，適合先對齊結構再改細節。
- 安全校驗：內置 8 個 Hook Point 安全校驗，在 Skill 執行鏈路上做約束（具體校驗項以 Skill 文檔爲準）。
SkillHub 統計（以頁面抓取爲準）：評分 100000，下載 1709 次。
安裝與啓用¶
安裝方式遵循 SkillHub 通用說明：skillhub.cn/install/skillhub.md。官方頁面給出的安裝提示爲：根據該文檔安裝 @user_800d68d6/drawiodo。
1、安裝 SkillHub CLI（若尚未安裝）¶
先檢查是否已有 CLI：
command -v skillhub && skillhub --version
未安裝時可執行完整安裝（CLI + 默認 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
僅安裝 CLI 時：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
說明：若環境網絡受限，需在允許訪問外網的終端中執行上述命令。
2、安裝 please-drawio-turn 到當前 Agent 的 skills 目錄¶
SkillHub 要求安裝時必須用 --dir 指向當前 Agent 識別的 skills 目錄，否則默認落在 ./skills/ 可能不會被加載。
skillhub install user_800d68d6/drawiodo --dir <你的 skills 目錄>
常見客戶端路徑（來自 SkillHub 安裝文檔）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
在 Cursor 中示例：
skillhub install user_800d68d6/drawiodo --dir ~/.cursor/skills/
安裝後按你所用客戶端的要求刷新或重啓 Agent，使 Skill 被加載。本 Skill 無需配置 API Key（requires_api_key=false）。
典型用法¶
官方頁面未附帶獨立「示例項目」倉庫；可復現的用法即：在已啓用該 Skill 的對話裏，用自然語言描述圖類型與內容，由 Agent 按 SKILL 流程生成文件並打開。
可參考的提示方向（與官方觸發描述一致）：
- 「畫一張微服務架構圖，包含網關、三個業務服務和 Redis。」
- 「用流程圖描述用戶註冊：校驗 → 寫庫 → 發郵件。」
- 「畫 ER 圖：用戶、訂單、商品三表及外鍵關係。」
- 「時序圖：客戶端、API、數據庫在一次查詢中的交互。」
經過上面的步驟，Agent 應走 思考與確認 後再落盤 .drawio；若結果不符預期，在同一對話中要求迭代，並依賴 Skill 提供的 版本回溯 能力回到較早版本（具體命令或話術以 Skill 內說明爲準）。
適用場景與注意¶
適合誰：需要在方案、設計評審、技術文檔裏頻繁出圖，且希望交付物是 draw.io 原生格式、方便人工微調的團隊或個人。
限制與注意：
- 依賴本機 draw.io 或 Skill 指定的打開方式；純 Web Agent 環境若無法寫本地文件或調起應用，體驗會受限。
- 圖爲 Agent 生成，複雜版式、企業視覺規範仍需人工在 draw.io 中調整。
- 安全相關行爲以 8 個 Hook Point 爲準，若企業有合規要求，安裝前建議在 SkillHub 頁面閱讀完整 Skill 說明。
- 版本以 SkillHub 爲準，撰寫時頁面版本爲 2.6.1；升級可用
skillhub的更新能力並仍指定正確的--dir。
結尾¶
please-drawio-turn 把「對話裏要一張圖」收斂爲 可編輯的 .drawio 交付，並強調確認、迭代與回溯，適合不想在 Mermaid 與手繪之間反覆切換的場景。
官方入口：
