VibeRaven：为 AI 编程代理提供生产级工作流

AI 编程代理（如 Claude Code、Cursor、Copilot）在生成和修改代码方面能力突出，但往往缺乏对「自己无法验证的内容」的判断力。VibeRaven 是一个面向这类代理的开源生产工作流工具包，尝试用结构化技能和契约约束代理在生产环境中的行为。

项目定位

VibeRaven 由两部分组成：一组可被代理调用的「生产技能（Production Skills）」，以及一个本地 Studio 控制台。代理在实现功能、修复问题、审核发布或准备上线时，可通过该工具包获取 provider 上下文、版本上下文、审批感知聊天与变更证据，避免在信息不足时草率给出「已完成」的结论。

工具包的核心契约包括：

• 明确指出已找到的证据；
• 明确指出缺失的证据；
• 区分仓库代码层面的修改与 provider 控制台层面的操作；
• 在可用时使用 MCP 或 provider 上下文；
• 保持发布与版本上下文可见；
• 在执行高风险本地变更前请求审批。

适配的代理与安装方式

VibeRaven 通过 npx -y viberaven 启动 Studio，并通过 npx -y viberaven init --agents all 为支持的代理写入指令文件，覆盖 Codex、Claude Code、Cursor、Copilot、Gemini CLI 等，写入目标包括 AGENTS.md、CLAUDE.md、GEMINI.md、Cursor rules 与 Copilot instructions。

工具以插件式打包发布：

• Codex：.codex-plugin/plugin.json
• Claude Code：.claude-plugin/plugin.json
• Gemini CLI：gemini-extension.json
• 通用插件宿主：plugin.yaml

同时提供 skills.sh 安装方式与 MCP 暴露配置（--mcp 模式），便于被支持 MCP 的代理直接调用。

内置技能概览

工具内置的技能按常见生产场景划分：

• supabase-rls：设计或修复 RLS，区分仓库 SQL 与线上 dashboard 状态；
• stripe-webhooks：实现更安全的 webhook 处理、幂等性与模式分离；
• vercel-env-sync：在本地、preview 与 production 之间修正环境变量；
• clerk-callbacks：调试鉴权回调、跳转、preview URL 与路由保护；
• sentry-signal：核对监控是否真正接通，避免「装了 SDK 就以为有信号」；
• release-review：跨 provider、鉴权、计费、环境、数据、监控的发布风险审核；
• provider-actions：把代理可改的仓库代码与必须由人或 MCP 工具处理的 dashboard 操作分开；
• launch-readiness：汇总实现状态、验证输出、provider 缺口与下一步行动；
• evidence-first：在仓库代码、MCP 上下文或 provider 证据不完整时约束代理的表述。

命令与文档

Studio 提供代理聊天、可拖拽的 provider 与版本/发布视图、provider MCP 上下文、终端输出、diff 上下文、访问模式控制与 CLI 代理连通性检查。常用的斜杠命令包括：

• /viberaven-help：展示技能包与输出契约；
• /viberaven-work：在任务上调用生产技能；
• /viberaven-launch：在宣布就绪前执行上线检查；
• /viberaven-provider-actions：分离仓库代码修复与 dashboard 操作。

仓库还提供 llms.txt、llms-full.txt、skills.json、skills.sh.json 等机器可读文档，以及 Next.js + Supabase + Vercel 的「生产就绪」启动模板，内置代理规则与 viberaven:* 脚本。

VibeRaven 以 npm 包形式发布，源代码与 issue 跟踪在 GitHub（ohad6k/VibeRaven），官网为 viberaven.dev。官方明确，普通 git push 不会被该工具拦截，工具的「就绪」语义仅作用于生产变更信心、发布审核与代理边界控制。