前言¶
用 AI 做新項目時，常見做法是直接讓模型「幫我做個網站 / 工具」，幾輪對話後目錄越堆越亂，技術棧中途又改一遍。問題往往不在模型不會寫代碼，而是編碼開始前缺少可執行的架構結論，也沒有把結論固化成後續對話能複用的 Prompt。
下面介紹 SkillHub 上的 Vibe Coding 架構師：一套面向 Vibe Coding 的架構選型與項目啓動方法論，把「先想清楚再寫代碼」拆成 Agent 可遵循的步驟。
這是什麼¶
Vibe Coding 架構師 是 SkillHub 分類 dev-programming 下的 Agent Skill，基於通用的 SKILL.md 技能包格式。官方資料將其定位爲：Vibe Coding 架構選型與項目啓動方法論——在寫任何一行代碼之前，先用結構化思維鎖定架構，再把架構翻譯成 Prompt，最後才進入編碼階段。
SkillHub 公開數據（截至資料抓取時）：評分 99493，下載 2776 次。條目地址見文末；若瀏覽器打開 SkillHub 頁面提示「Skill 未找到」，可在 SkillHub 內搜索「Vibe Coding 架構師」或 vibe-coding-architect 定位當前可用安裝標識。
核心功能¶
結合官方簡介與 SkillHub 上同名條目的說明（簡介與上述完全一致），該 Skill 側重以下能力，而不是替代你手寫業務代碼：
- 架構前置：在編碼階段之前，用結構化方式收斂技術方案與項目骨架，減少「邊寫邊改架構」的返工。
- Prompt 化交付：把定下來的架構與約束寫成後續 AI 編程可執行的 Prompt，讓實現階段有統一上下文。
- 分階段推進：SkillHub 條目
@indiv-wangxia/vibe-coding-architect（v1.0.0）將流程概括爲 需求澄清、架構選型、任務拆解、Prompt 生成、逐步實施 五個階段（來源：SkillHub 技能頁）。
觸發意圖上，官方說明覆蓋：新項目啓動、AI 編程、Vibe Coding、技術選型、架構設計、MVP、項目規劃、prompt 工程、項目結構等；不適合純 UI/CSS 微調、已有項目 bug 修復、簡單文件操作、純數據分析或非編程任務。
安裝與啓用¶
安裝流程以 SkillHub 官方文檔 skillhub.cn/install/skillhub.md 爲準。
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、安裝技能包到當前 Agent 的 skills 目錄¶
官方要求：必須用 --dir 指向當前 Agent 識別的 skills 目錄，否則默認裝到 ./skills/ 可能不會被加載。
skillhub search vibe-coding-architect
skillhub install <搜索到的技能標識> --dir <你的 Agent skills 目錄>
常用路徑（摘自官方安裝文檔）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
3、通過對話讓 AI 代爲安裝（SkillHub 頁面推薦方式）¶
SkillHub 同名技能頁給出的安裝提示詞爲（安裝標識以頁面爲準）：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@indiv-wangxia/vibe-coding-architect`。
將上述提示發給已接入 Skill 能力的 Agent 即可；Agent 應按文檔完成 CLI 檢查、--dir 安裝與目錄校驗。安裝後按你所用客戶端要求重啓或刷新技能列表。
典型用法¶
安裝：先發上一節的安裝提示詞，確認技能已出現在 Agent 的 skills 列表中。
啓動新項目：用自然語言描述目標，並落在官方 TRIGGER 範圍內，例如：
我想從零做一個任務管理 Web 應用（MVP），不確定前後端技術棧和項目目錄怎麼拆。請先按 Vibe Coding 架構師的方法做需求澄清和架構選型，輸出架構結論和後續編碼用的 Prompt，再進入實現。
經過上面的步驟，Agent 應優先完成澄清與架構文檔化，而不是立刻生成大量代碼文件。具體提問清單與產出模板以技能包內 SKILL.md 爲準（安裝後可在 skills 目錄中查看）。
適用場景與注意¶
適合：新倉庫或 MVP 啓動、需要技術選型與系統設計、希望統一 AI 編程規範與項目骨架、要把「架構決策」沉澱成可複用 Prompt 的團隊或個人。
不適合：僅改樣式、修既有項目缺陷、一次性腳本、與架構無關的文案或數據分析。
注意：
- 條目
https://skillhub.cn/skills/user_56cd569d/vibe-coding-architect當前返回「Skill 未找到」；請以搜索到的最新標識安裝，避免硬編碼失效路徑。 - 架構結論仍需要你根據業務邊界做取捨；Skill 約束的是流程與表達方式，不能替代安全、合規與性能方面的專業評審。
結尾¶
Vibe Coding 架構師 的價值在於把「先架構、再 Prompt、後編碼」變成 Agent 默認工作流，降低 AI 編程在項目早期的方向漂移。官方條目地址：https://api.skillhub.cn/user_56cd569d/vibe-coding-architect；SkillHub 瀏覽與安裝說明：https://skillhub.cn/install/skillhub.md。
