🚀 Vibe Check项目
Vibe Check是一款专门解决大型语言模型（LLM）代理在运行时，因“思维惯性”导致无序行为问题的工具。它整合了vibe_check、vibe_distill和vibe_learn三个核心功能，让LLM代理在运行时能主动识别并纠正推理过程中的偏离行为。
🚀 快速开始
Vibe Check通过整合三个核心功能，为LLM代理提供了一种机制，使其能够在运行时主动识别和纠正其推理过程中的偏离行为。你可以参考后续的安装与配置步骤，快速使用该工具。
✨ 主要特性
1. vibe_check
- 用途：当代理在开发待办事项应用程序时，开始解释区块链基础概念（如区块、链表等），强制执行阶段一致的中断。
- 触发条件：代理处理与当前任务无关的概念或逻辑时。
- 实现机制：在每个推理阶段（规划/实施/审查）中嵌入检查点，确保中断的有效性。
2. vibe_distill
- 用途：当代理的计划包含过多嵌套的要点（例如，详细到技术规范文档的程度），强制执行压缩和简化。
- 触发条件：代理生成过于复杂的解决方案或计划时。
- 实现机制：将复杂逻辑转换为简明扼要的关键点链，作为重新校准的基础。
3. vibe_learn
- 用途：在代理陷入过度复杂性之后，记录和分析错误模式，以优化后续中断策略。
- 触发条件：用户手动将代理从复杂性中引导回来后。
- 实现机制：建立反馈循环，用于存储和利用历史错误数据。
📦 安装指南
通过 Smithery 自动安装
要通过 Smithery 自动为 Claude Desktop 安装 vibe-check-mcp-server：
npx -y @smithery/cli install @PV-Bhat/vibe-check-mcp-server --client claude
手动安装（推荐）
# 克隆仓库
git clone https://github.com/PV-Bhat/vibe-check-mcp-server.git
cd vibe-check-mcp-server
# 安装依赖项
npm install
# 构建项目
npm run build
# 启动服务器
npm run start
💻 使用示例
基础用法
示例 1: 开发待办事项应用
{
"name": "todo-app",
"description": "A simple todo application built with Node.js.",
"planning": {
"features": ["CRUD operations", "User authentication"],
"technologies": ["Node.js", "Express.js", "MongoDB"]
}
}
示例 2: 区块链基础教学
{
"name": "blockchain-lesson",
"description": "Teaching blockchain basics to new developers.",
"planning": {
"topics": ["Block structure", "Blockchain validation"],
"examples": ["Bitcoin transaction flow", "Ethereum smart contracts"]
}
}
📚 详细文档
集成指南
与 Claude 的集成
在你的 claude_desktop_config.json 文件中添加以下内容：
"vibe-check": {
"command": "node",
"args": [
"/path/to/vibe-check-mcp/build/index.js"
],
"env": {
"GEMINI_API_KEY": "YOUR_GEMINI_API_KEY"
}
}
环境配置
在项目根目录中创建一个 .env 文件：
GEMINI_API_KEY=your_gemini_api_key_here
API 参考
1. vibe_check
- 用途：在规划、实施或审查阶段中嵌入中断检查点。
- 输入参数：
stage：当前推理阶段（"planning" | "implementing" | "reviewing"）context：上下文信息（如当前任务描述、已执行步骤等）
- 返回值：中断策略或继续信号
2. vibe_distill
- 用途：将复杂推理过程简化为关键点链。
- 输入参数：
complexity_level：复杂度指标（1 - 5）content：需要简化的上下文信息
- 返回值：简化后的关键点列表
3. vibe_learn
- 用途：分析和记录推理过程中的错误模式。
- 输入参数：
error_type：错误类型（"偏离主题" | "过度复杂" | "逻辑错误"）context：错误发生时的上下文信息
- 返回值：反馈信号或优化建议
文档参考
安装指南
- 通过 Smithery 自动安装
- 手动安装（推荐）
集成指南
- 与 Claude 的集成
- 环境配置
API 参考
- vibe_check
- vibe_distill
- vibe_learn
项目结构
.
├── README.md # 项目文档
├── package.json # 项目依赖和脚本
├── src/
│ ├── index.js # 主程序入口
│ └── utils/
│ ├── check.js # vibe_check 实现
│ ├── distill.js # vibe_distill 实现
│ └── learn.js # vibe_learn 实现
└── .env.example # 环境变量示例
🔧 技术细节
Vibe Check通过在每个推理阶段嵌入检查点、将复杂逻辑转换为关键点链以及建立反馈循环等机制，实现了对LLM代理推理过程的有效监控和优化。具体来说，vibe_check在推理阶段嵌入检查点，确保代理不会偏离当前任务；vibe_distill将复杂的推理过程简化，避免代理生成过于复杂的解决方案；vibe_learn则通过记录和分析错误模式，不断优化中断策略。
📄 许可证
本项目采用 MIT License。
⚠️ 重要提示
- 环境依赖：确保已安装 Node.js 和 npm。
- 权限设置：确保有正确的文件读写权限。
- 错误处理：在生产环境中建议添加错误捕捉和日志记录机制。
💡 使用建议
欢迎任何贡献！请参考 CONTRIBUTING.md 文件了解如何参与。如有任何问题，请联系 作者邮箱 或访问 项目主页。