Vibe-Skills

Vibe-Skills 是一个给 Claude Code、Codex、OpenCode 这类 AI 编码环境加的工作流编排层。它要解决的问题是：当 AI 助手装了几十个甚至上百个 skill 之后，怎么让它们被可靠地挑对、执行、验收，而不是每次调用都从头猜一遍意图。

仓库自带 340 多个预置 skill 和 129 条治理规则，所有任务强制走一套固定的四阶段流程。

四阶段工作流

每次调用 /vibe 都会按顺序走完下面四步，每一步都可以人工确认或打断：

1. Clarify（/vibe-want）：固化需求和边界，防止一开始就偏题
2. Plan（/vibe-how）：按 M / L / XL 三档评估复杂度并生成执行方案
3. Execute（/vibe-do）：智能路由挑出合适的 skill 组合，按方案执行
4. Verify：用 129 条治理规则校验产出，发现违规直接打回

这套流程最直接的收益是：在需求没确认清楚之前，AI 不会开始写代码。独立使用 Claude Code 时最常见的返工原因是"理解错了再写一遍"，这个问题会在 Clarify 阶段被前置处理掉。

340+ skill 覆盖的领域

按领域粗分：

• 编码：重构、迁移、code review、测试生成、Git 工作流
• 研究：信息收集、竞品对比、文献整理
• 数据：SQL 生成、报表、可视化
• 文档与创意：文档生成、PPT、图片描述

skill 的选择由路由自动完成。用户不需要记每个 skill 的名字，路由会根据任务意图挑一批候选，治理规则再过滤掉冲突组合。

跨会话的项目记忆

记忆系统分四层：

• 会话级（session）：当前对话窗口的临时上下文
• 项目级（project）：绑定到代码仓库或目录的长期记忆
• 短期语义（semantic cache）：最近若干次检索结果的向量缓存
• 长期图谱（knowledge graph）：跨项目的结构化知识

项目级记忆落在本地的 Obsidian vault 或绑定的 GitHub 仓库里，文本可读、可版本控制、可手动修改。出错时能直接定位到是哪一条记忆出了问题，而不是把整个记忆系统重置。

适用场景

• 长期在同一套代码库里工作，希望 AI 记住项目上下文的工程师
• 有稳定复用流程的小团队，需要把个人 prompt 固化成团队规范
• 对 AI 产出可复现性有要求的场景，例如合规审计或受监管环境

不适用的情况

• 偶尔让 AI 写一次性脚本，四阶段流程会拖慢节奏
• 已有成熟的 prompt 和 agent 编排，两层叠加会产生冗余
• 希望 AI 直接动手、不想被中间确认打断的工作习惯

安装

Linux / macOS：

bash
bash <(curl -fsSL https://raw.githubusercontent.com/foryourhealth111-pixel/Vibe-Skills/main/install.sh)

Windows：

powershell
iwr -useb https://raw.githubusercontent.com/foryourhealth111-pixel/Vibe-Skills/main/install.ps1 | iex

调用方式

调用入口按宿主环境区分：

• Claude Code：/vibe <任务描述>
• Codex：$vibe <任务描述>
• OpenCode：/vibe <任务描述>

首次使用建议从一个范围明确的小任务开始，熟悉四阶段节奏之后再接入真实项目。