English | 中文

VibeFlow

VibeFlow 不是一个agent工具，而是一个把每次AI 驱动的软件改动组织成稳定交付链路的 skill 交付编排层

"凡事预则立，不预则废。" 先定章法，再求速度；先有节奏，后有规模。

安装 · 3 分钟上手 · 核心能力 · Skills · 能力对比

VibeFlow 是什么

VibeFlow 不替智能体思考，也不试图再造一个执行内核。它做的事情更直接：把一次 AI 驱动的软件改动组织成一条能真正走完的交付流程，让工作不只"写出来"，还能继续、恢复、交接、审查、测试、发布和复盘。

一句话理解：VibeFlow 把 AI 编码从"聊天里临场发挥"，变成"按SDD+Harness理念交付流程推进"

核心能力

能力	VibeFlow 做什么
把想法变成计划	先把需求、方案和任务拆清楚，再开始做
把改动真正做完	不只写代码，还继续推进审查、测试、发布和复盘
让工作不中断	会话关掉、换人接手、隔天继续，都还能接着跑
让结果有证据	每次改动都能留下审查、测试和交付痕迹
降低跑偏概率	用阶段、规则和门禁约束 AI 不要一路猜下去
让复杂任务更稳	把大任务拆成可推进、可回收、可验证的小块
让进度看得见	当前做到哪、卡在哪、下一步做什么，都有地方看
适配真实仓库	可以持续跑在已有项目里，而不只是新建项目模板

安装

方式一：自己安装

默认安装最新发布版本。

平台	安装命令	安装后
macOS / Linux	`/sh curl -fsSL https://raw.githubusercontent.com/ttttstc/vibeflow/main/claude-code/install.sh \| bash`	运行 `/plugin install vibeflow@vibeflow`
Windows PowerShell	`irm https://raw.githubusercontent.com/ttttstc/vibeflow/main/claude-code/install.ps1 \| iex`	运行 `/plugin install vibeflow@vibeflow`

指定版本安装

平台	命令
macOS / Linux	`/sh curl -fsSL https://raw.githubusercontent.com/ttttstc/vibeflow/main/claude-code/install.sh \| VIBEFLOW_VERSION=v1.0.0 bash`
Windows	`$env:VIBEFLOW_VERSION="v1.0.0"; irm https://raw.githubusercontent.com/ttttstc/vibeflow/main/claude-code/install.ps1 \| iex`

方式二：让 AI 帮你安装

粘贴以下内容到 Claude Code

帮我安装 VibeFlow，并确保最后能正常使用。

要求：
1. 根据当前系统选择官方安装命令：
   - macOS / Linux：
     /sh curl -fsSL https://raw.githubusercontent.com/ttttstc/vibeflow/main/claude-code/install.sh | bash
   - Windows：
     irm https://raw.githubusercontent.com/ttttstc/vibeflow/main/claude-code/install.ps1 | iex
2. 如果我给了版本号，就安装指定版本；否则安装最新发布版本
3. 如果脚本不可用，再手动安装到 Claude Code marketplace 目录
4. 安装完成后执行：
   /plugin install vibeflow@vibeflow
5. 验证安装是否成功：
   - 重启或刷新 Claude Code 后运行 /vibeflow
   - 如果没有成功，继续排查直到成功或明确告诉我卡在哪一步
6. 最后告诉我：
   - 是否安装成功
   - 安装到了哪里
   - 当前安装版本
   - 下一步该怎么开始使用

验证安装

运行 /vibeflow，能看到 VibeFlow 入口说明，就说明插件已正常加载。如果还想确认 plugin 可见工具入口也已就绪，再执行 /vibeflow-status 或 /vibeflow-dashboard。

更新与卸载

更新使用与安装相同的命令。更新后重启 Claude Code 并再次执行 /plugin install vibeflow@vibeflow。

3 分钟上手

安装并激活插件后，在项目里运行 /vibeflow
第一次进入时选择 Full Mode 或 Quick Mode
在 Spark → Design → Tasks 完成必要确认
一旦进入 Build，系统默认自动继续 Review → Test → Ship / Reflect
想看进度时用 /vibeflow-status 或 /vibeflow-dashboard

一句话理解：前半程你拍板，后半程系统推进，卡住了再回来问你。

模式选择建议： 不确定时优先选 Full Mode。只有小范围、低风险、可快速回滚的改动再用 Quick Mode。如果项目里已有 .vibeflow/state.json，会自动沿用已有 mode 继续工作。

常用命令

需求	命令
开始或继续工作流	`/vibeflow`
快速处理小改动	`/vibeflow-quick`
启动独立学习流	`/vibeflow-learn`
查看当前状态摘要	`/vibeflow-status`
打开本地 live 看板	`/vibeflow-dashboard`

深入了解

如果把 VibeFlow 用在一个真实项目里，你最终得到的不是一组提示词，而是一套可以持续运行的软件交付机制。

结构化交付流程

Spark → Design → Tasks 负责想清楚问题、方案和执行顺序
Build → Review → Test 负责把实现、审查和验证真正跑完
Ship / Reflect 作为可选收尾，处理发布和复盘

文件即状态

VibeFlow 把状态留在仓库里，而不是留在一次聊天里。关掉会话、换机器、换 AI，都能继续。

Build 后自动继续

设计确认后，系统不需要你手动推进每个子步骤。进入 Build 后自动走完 Review → Test → Ship → Reflect，直到完成、阻塞，或需要你确认。

更稳的实现链路

Build 不是"把整份长上下文硬塞给 AI 再赌它别漂"。当前已支持：

Feature 级实施输入，以 design.md + tasks.md + feature-list.json + rules/ 为主输入
归一化 feature 合同和执行证据保存在 feature-list.json
依赖感知构建，安全回退到串行执行
Review 区分"做得对不对"和"代码写得稳不稳"

现有项目也能用

VibeFlow 不只适合新项目。它能维护项目级代码结构地图，为本次变更生成影响分析，在 Spark / Design 阶段自动引用这些上下文。

本地 live 看板

不需要盯着 state.json 猜系统跑到哪了。看板展示当前 mode/phase、主阶段状态、feature 状态、关键产物、最近事件和下一步建议。

质量闭环

默认链路包含：TDD、覆盖率门禁、变异测试、功能验收、全局审查、系统测试，以及 UI 场景下的 QA。

增量、发布与复盘

除主工作流外，还支持增量请求队列、发布说明和迭代复盘日志。

模板与安全护栏

四种模板控制流程严格度和质量阈值。careful / freeze / guard 安全护栏限制危险命令和编辑边界。

Skills

English | 中文