内容
<div align="center">
<img src="./assets/raven-mascot.png" alt="VibeRaven raven mascot" width="150" />
<h1>VibeRaven</h1>
<p><strong>您的 AI 代理构建它。VibeRaven 控制它。</strong></p>
<p>
<a href="https://www.npmjs.com/package/viberaven"><img src="https://img.shields.io/npm/v/viberaven?color=8b5cf6&label=npm" alt="npm 版本" /></a>
<a href="https://www.npmjs.com/package/viberaven"><img src="https://img.shields.io/npm/dm/viberaven?color=8b5cf6&label=下载量" alt="npm 下载量" /></a>
<a href="https://github.com/ohad6k/VibeRaven/stargazers"><img src="https://img.shields.io/github/stars/ohad6k/VibeRaven?style=flat&color=8b5cf6&label=星星" alt="GitHub 星星" /></a>
<a href="./LICENSE"><img src="https://img.shields.io/badge/license-MIT-8b5cf6" alt="MIT 许可证" /></a>
<a href="https://skills.sh"><img src="https://img.shields.io/badge/skills.sh-6--skill_pack-34d399" alt="skills.sh 技能包" /></a>
<a href="https://discord.gg/ZAJvazz63Y"><img src="https://img.shields.io/badge/Discord-加入-5865F2?logo=discord&logoColor=white" alt="加入 Discord" /></a>
<a href="https://x.com/VibeRavenStatio"><img src="https://img.shields.io/badge/X-关注-000000?logo=x&logoColor=white" alt="在 X 上关注" /></a>
</p>
<p>
<a href="https://viberaven.dev">官方网站</a> ·
<a href="#your-first-5-minutes">快速入门</a> ·
<a href="#agent-skills">代理技能</a> ·
<a href="https://github.com/ohad6k/VibeRaven/releases">版本发布</a> ·
<a href="https://github.com/ohad6k/VibeRaven/discussions">讨论</a>
</p>
</div>
VibeRaven 是开源的 AI 编码代理控制台。代理可以快速编写代码，但它们盲目地进行补丁。VibeRaven 在几秒钟内映射您的产品：版本、提供商和启动风险，准备好拖入代理的下一个提示。
```bash
npx -y viberaven
```
Studio 在您的浏览器中打开，完全在您的机器上运行：它检测您的堆栈，找到您的提供商，将您的 git 版本发布到时间轴上，并从离线检查中为您提供“是否可以发布”的判决。无需登录，无需 API 密钥，无需遥测。
## 您的前 5 分钟
1. **运行它。** 在您的项目文件夹中运行 `npx -y viberaven`。Studio 在您的浏览器中打开并离线扫描您的仓库。
2. **阅读您的判决。** 门控芯片和启动信号显示了阻止发布的确切内容，并排名。点击任何信号，然后点击 **修复** 将其交给您的代理。
3. **连接您的编码代理。** 在聊天面板中选择 Codex、Claude Code 或 Gemini CLI，点击 **测试连接**，然后选择它可以获得的访问权限（`询问`、`批准` 或 `完全`）。
4. **打开架构图。** 页面、API、数据、模块和提供商作为实时可拖动的图表显示。弱边界显示为红色。点击一个，然后按纯英文的动作，如 *"保护用户数据（RLS）"* 或 *"修复慢速查询"*。
5. **打开工作树。** 您的分支作为真实的树显示。未提交的混乱？一步到位：*使用代理提交*。分支准备好了？*审查* 用纯语言解释它，*合并* 安全地执行。
6. **给予您的代理技能。** 安装六项技能包和插件，以便 Codex、Claude Code 和 Gemini 在所有地方遵循相同的资深工程师循环：
```bash
npx -y skills add ohad6k/VibeRaven --skill viberaven # skills.sh 技能包
npx -y viberaven init --agents all # 仓库中的代理规则
```
代理需要的所有内容也写入 `.viberaven/` 中，以 Markdown 和 JSON 格式存储，可供任何工具读取，并由 git 版本控制。
## Studio 提供的内容
| 功能 | 它执行的操作 |
| --- | --- |
| **仓库中的代理聊天** | 从一个控制台驱动 Codex、Claude Code 或 Gemini CLI，具有连接健康状态和实时终端输出。 |
| **访问模式** | `询问`、`批准` 或 `完全`。模式更改实际的代理命令，而不仅仅是 UI 复制。 |
| **可拖动的上下文** | 将发布、提供商卡或生产内存拖入代理聊天，以便代理在修补程序时了解您产品的实际状态。 |
| **版本和发布** | 发布差异、标签、更改日志和“自上次发布以来发生了什么”的纯英文描述。 |
| **通过 MCP 的提供商** | 连接 Supabase、Vercel 和 Stripe。提供商状态流入代理提示，提供商证明与仓库代码修复分开。 |
## 终端双胞胎：`viberaven check`
对于代理和 CI，相同的判决作为一个命令：
```bash
npx -y viberaven check
```
```text
viberaven check · ~/my-app
🔴 RLS 在公共表格上禁用 (rls_profiles)
🟡 服务角色密钥在客户端捆绑包中被引用 (service_role_client)
⚪ 没有连接错误监控 (monitoring_missing)
判决：❌ 1 个阻止因素，1 个警告 · 分数 62
修复：viberaven fix · 详细信息：.viberaven/agent-tasklist.md
```
每个发现一行，`file:line` 证据在工件中，阻止因素的退出代码为 `1`。然后：
```bash
npx -y viberaven fix # 列出具有安全自动修复的漏洞
npx -y viberaven fix --gap <id> # 应用一个修复
npx -y viberaven --strict # 部署或 CI 之前的最终门控
```
所有结果都存放在 `.viberaven/` 中，以 Markdown 和 JSON 格式存储在磁盘上 (`agent-tasklist.md`、`gate-result.json`、`context-map.json`)，因此任何代理和您的 git 历史记录都可以读取它们。
## 为 AI 代理安装
让代理在修补程序之前使用发布和提供商上下文：
```bash
npx -y viberaven init --agents all
npx -y viberaven doctor --agents
```
预览而不写入文件：
```bash
npx -y viberaven init --agents all --dry-run
```
这将有界限规则（`<!-- VIBERAVEN:START -->` ... `<!-- VIBERAVEN:END -->`）安装到：
- `AGENTS.md`、`CLAUDE.md`、`GEMINI.md`
- `.cursor/rules/viberaven-core.mdc`（以及作用域 Supabase、部署和支付规则）
- `.github/copilot-instructions.md`
- `.viberaven/agent-context.md`、`.viberaven/mission-map.md`
规则教循环：`检查`，读取 `.viberaven/`，修复一个漏洞，然后再次 `检查`，直到 `gate.status === "clear"`。
## 代理技能
六个 [skills.sh](https://skills.sh) 技能引导代理完成架构问题、版本证据和启动证明：
| 技能 | 工作 |
| --- | --- |
| `viberaven` | 路由器：本地检查/修复循环、Studio 和 MCP 上下文。 |
| `architecture-context` | 在任何编辑之前询问缺少的产品问题。 |
| `architecture-plan` | 将答案和仓库证据转化为工作流计划。 |
| `what-broke` | 在修补程序之前找出哪个版本破坏了应用程序。 |
| `production-context` | 在 `.viberaven/production-context.md` 中保持紧凑的生产内存。 |
| `go-live` | 本地应用程序到 GitHub 到 Vercel，具有实时 URL 证明。 |
```bash
npx -y skills add ohad6k/VibeRaven --skill viberaven
```
在 [agent-skills/](./agent-skills/) 中查看完整的技能包。
该仓库还可以用作代理 **插件**：`plugin.yaml`、`claude-plugin/`、`codex-plugin/` 和 `gemini-extension.json` 公开六项技能以及 `/viberaven-work`、`/viberaven-help`、`/viberaven-production-context` 和 `/viberaven-launch` 命令给 Claude Code、Codex 和 Gemini CLI。
## MCP
VibeRaven 在 MCP 注册表中列出，供喜欢使用工具而非终端命令的代理使用：
```json
{ "viberaven": { "command": "npx", "args": ["-y", "viberaven", "--mcp"] } }
```
关键工具：`viberaven_check_readiness`（运行本地检查）、`viberaven_heal_apply`、`viberaven_verify`、`viberaven_audit`、`viberaven_provider_verify` 和 `viberaven_validate_npm_package`（在添加 npm 依赖项之前运行）。
## Vercel + Supabase
```bash
npx -y viberaven audit --vercel-supabase
```
本地证据检查 RLS 证明、服务角色暴露和连接器端口，然后再声称“生产就绪”。
## 哲学
- **本地优先。** CLI 和 Studio 在您的机器上运行。无需登录，无需 API 密钥，无需遥测，无需扫描配额。
- **磁盘上的 Markdown。** 所有上下文都存储在 `.viberaven/` 中，以纯文件形式存储，您的代理和 git 历史记录可以读取。
- **证据优于感觉。** 发现指向仓库证据。提供商仪表板状态从不声称仅凭仓库编辑。
- **非破坏性。** 修复配方受到保护，清理仅限计划，内容不会为您推送或部署。
## 贡献
欢迎贡献，其中大部分不需要私有源代码访问：
- 挑选一个 [good first issue](https://github.com/ohad6k/VibeRaven/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22)：文档、提供商夹具、示例和翻译。
- 在 [Discussions](https://github.com/ohad6k/VibeRaven/discussions) 中分享想法或问题。
- 加入 [Discord](https://discord.gg/ZAJvazz63Y) 直接与维护者交流。
## 资源
- 代理就绪的启动模板：[examples/nextjs-supabase-vercel-production-ready-template](./examples/nextjs-supabase-vercel-production-ready-template/)
- 可机读的文档：[llms.txt](./llms.txt) · [llms-full.txt](https://viberaven.dev/llms-full.txt) · [skills.json](https://viberaven.dev/skills.json) · [skills.sh.json](./skills.sh.json)
- 示例证明工件：[examples/proof/](./examples/proof/)
- 官方网站：[viberaven.dev](https://viberaven.dev) · npm：[viberaven](https://www.npmjs.com/package/viberaven) · 问题：[ohad6k/VibeRaven/issues](https://github.com/ohad6k/VibeRaven/issues)
## 许可证
[MIT](./LICENSE)。当前公共版本：`viberaven@1.3.5`。
如果 VibeRaven 帮助您交付，请点亮仓库，以便其他 AI 应用构建者可以找到它。使用 **Watch → Custom → Releases** 获取版本通知。
> 此公共仓库是代理发现和安装的表面。产品源代码开发发生在私有仓库中。
