前言¶
業務規則寫在 Markdown 裏，老系統裏又有一堆歷史 CREATE TABLE 腳本。要把兩者對齊成一套可上線的表結構，往往要反覆對照《阿里巴巴 Java 開發手冊》裏的數據庫約定、MySQL 5.7/8.0 語法差異，以及阿里雲 RDS 的建表要求。手工整理 DDL 費時，也容易在字段類型、命名和註釋上漏項。
下面介紹 SkillHub 上的 mysql數據庫測試助手（座標 @user_1a9d72e6/mysql-design）。它在對話中根據業務規則文檔和存量 SQL，輸出面向 MySQL 5.7/8.0、並參考阿里規範與阿里雲 RDS 的建表設計，適合在 Agent 裏做「文檔 + 舊庫 → 新 DDL」的輔助工作。
這是什麼¶
mysql數據庫測試助手 是社區來源（community）的 Agent Skill，當前版本 1.0.0，分類爲 dev-programming，發佈者爲 user_1a9d72e6。頁面簡介將其定位爲 MySQL 數據庫設計助手：讀取業務規則（.md）與 SQL 腳本（.sql），生成符合阿里巴巴規範的 MySQL 5.7/8.0 建表語句，並強調輸出遵循 阿里雲 RDS 相關的表設計約束。
Skill 標註 requires_api_key=false，不依賴額外 API Key。在 SkillHub 上評分 100000，下載 1175 次（數據取自 SkillHub 頁面與已抓取元數據）。
官方入口：
- SkillHub 展示頁：https://www.skillhub.cn/skills/user_1a9d72e6/mysql-design
- API 資源地址：https://api.skillhub.cn/user_1a9d72e6/mysql-design
核心功能¶
以下能力均來自官方簡介，未做延伸：
- 觸發方式：當對話中出現「數據庫設計」「建表語句」「DDL」「表結構設計」「CREATE TABLE」等表述時，Skill 可被喚起參與任務。
- 輸入類型：支持讀取 業務規則文檔（
.md）與 存量 DDL/SQL 腳本（.sql）。 - 輸出目標：生成 MySQL 5.7 / 8.0 可用的建表語句；規範側面對 阿里巴巴 數據庫相關約定，並面向 阿里雲 RDS 的表設計習慣。
- 協作形態：在支持 Skill 的 Agent 中，由模型按 Skill 說明組織上下文，你提供文檔與腳本路徑或內容，由助手產出或修訂
CREATE TABLE類 DDL。
安裝與啓用¶
SkillHub 官方建議：讓 AI 按 SkillHub 安裝說明 安裝座標 @user_1a9d72e6/mysql-design。人工操作時，典型流程如下。
1、安裝 SkillHub 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、安裝本 Skill 到當前 Agent 的 skills 目錄¶
安裝時必須用 --dir 指向當前客戶端識別的 skills 目錄，否則默認落在 ./skills/ 可能不會被 Agent 加載。
skillhub install user_1a9d72e6/mysql-design --dir <你的 skills 目錄>
常見路徑（摘自 SkillHub 安裝文檔）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
安裝後按你所用客戶端的要求重啓或刷新 Agent，使 Skill 生效。
典型用法¶
官方頁面未提供固定的一鍵示例對話，但簡介明確了可復現的材料與意圖。可按下面步驟在 Agent 裏使用。
- 準備材料：將業務規則整理爲
.md（實體、字段含義、約束、枚舉等）；若有現網或遺留庫，導出相關表的.sqlDDL。 - 在對話中說明目標：使用簡介中的觸發詞之一，例如說明需要「根據業務文檔和存量 DDL 做表結構設計」，並指明 MySQL 版本（5.7 或 8.0）。
- 提供文件：在 Cursor 等環境中 @ 引用上述
.md/.sql，或粘貼關鍵片段，要求輸出完整CREATE TABLE及必要說明。 - 覈對輸出：對照阿里規範與 RDS 側要求（字符集、主鍵、索引、註釋、字段類型等）做人工審查；Skill 產出的是設計草案，上線前仍應在測試庫執行並走變更流程。
示例意圖（非官方原文，僅說明輸入輸出關係）：
請根據 @docs/order-rules.md 和 @sql/legacy_order.sql，
爲 MySQL 8.0 設計訂單域新表，輸出 CREATE TABLE，遵循阿里數據庫規範與阿里雲 RDS 建表習慣。
適用場景與注意¶
適合誰
- 需要在 Agent 裏快速把 產品/業務文檔 與 歷史 DDL 對齊爲統一建表語句的後端或 DBA。
- 團隊已約定參考 阿里巴巴 數據庫規範，並計劃或已使用 阿里雲 RDS 的場景。
限制與注意
- Skill 名稱含「測試助手」，但官方簡介定位爲 數據庫設計助手；以簡介中的設計、DDL、建表能力爲準。
- 規範落地以模型對 Skill 指令的執行爲準，不能替代 代碼評審、壓測與在目標版本 MySQL 上的實機驗證。
- 未要求 API Key，但若你本地未安裝 SkillHub CLI 或未把 Skill 裝到正確
--dir，Agent 將無法加載該技能。 - 簡介未承諾自動連接線上庫；實際輸入以你提供的
.md/.sql及對話內容爲主。
結尾¶
mysql數據庫測試助手 把「業務規則 Markdown + 存量 SQL」收斂爲 MySQL 5.7/8.0 建表 DDL，並對齊阿里巴巴規範與阿里雲 RDS 表設計取向，適合在 Skill 驅動的開發流程裏減少手工拼 DDL 的時間。安裝與座標以 SkillHub 爲準：@user_1a9d72e6/mysql-design，頁面 https://www.skillhub.cn/skills/user_1a9d72e6/mysql-design 。
