前言¶
用 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。
