AI代理元认知检查工具

Vibe Check MCP是一个为AI代理设计的元认知检查工具,通过模式中断、计划简化和自我改进反馈循环来防止工作流中的错误和过度工程化。

  • by abuasifkhan
  • 本地部署
  • 更新于
在 GitHub 查看 abuasifkhan/vibe-check-mcp-server

使用说明

🧠 振动检查MCP

还可以在以下网址找到Vibecheck: mcpservers.org, Glama.ai公司, mcp.so

你的人工智能的内部橡胶鸭,当它不能橡胶鸭本身。

什么是Vibe Check?

在 “vibe编码” 时代,人工智能代理现在拥有令人难以置信的能力,但问题已经转移:

从

“我的AI代理真的能做到吗 复杂的任务?"

向

“我的AI代理能理解我想写一个 简单程序,不是 为一家价值数十亿美元的科技公司提供基础设施?"

它提供了人工智能代理目前没有的基本“暂停……这不是它”时刻:一个内置的自我纠正监督层。这是权威的Vibe Coder健全性检查MCP服务器:

  • 通过实施策略模式中断来防止AI工作流程中的级联错误。
  • 使用名为“Vibe Check”的工具与LearnLM 1.5 Pro(Gemini API)配合使用,对教学法和元认知进行微调,以增强复杂的工作流程策略,并防止隧道视觉错误。
  • 实施“Vibe Distill”以鼓励计划简化,防止过度设计解决方案,并最大限度地减少代理中的上下文漂移。
  • 自我改进的反馈循环:代理可以将错误记录到“Vibe Learn”中,以提高语义回忆,并帮助监督人工智能随着时间的推移瞄准模式。

太长,读不下去了实施一个经过微调的代理,以阻止你的代理,并在它自信地实施错误之前让它重新考虑。

问题:模式惯性

在vibe编码运动中,我们都在使用LLM来生成、重构和调试我们的代码。但这些模型有一个关键缺陷:一旦它们开始走上推理之路,即使这条路明显错误,它们也会继续前进。

You: "Parse this CSV file"

AI: "First, let's implement a custom lexer/parser combination that can handle arbitrary 
     CSV dialects with an extensible architecture for future file formats..."

You: *stares at 200 lines of code when you just needed to read 10 rows*

这 模式惯性 导致:

  • 🔄 井底之蛙:你的经纪人陷入了一种困境,无法看到替代方案
  • 📈 范围蠕变:简单任务逐渐演变为企业级解决方案
  • 🔌 过度工程化:为不需要抽象层的问题添加抽象层
  • ❓ 不对齐:解决一个与你要求的问题相邻但不同的问题

功能:元认知监督工具

Vibe Check通过三个集成工具为您的代理工作流程添加了一个元认知层:

🛑 vibe_check

模式中断机制 通过元认知提问打破了狭隘的视野:

vibe_check({
  "phase": "planning",           // planning, implementation, or review
  "userRequest": "...",          // FULL original user request 
  "plan": "...",                 // Current plan or thinking
  "confidence": 0.7              // Optional: 0-1 confidence level
})

⚓ vibe_distill

元思维锚点 重新校准复杂的工作流程:

vibe_distill({
  "plan": "...",                 // Detailed plan to simplify
  "userRequest": "..."           // FULL original user request
})

🔄 vibe_learn

自我改进反馈回路 随着时间的推移建立模式识别:

vibe_learn({
  "mistake": "...",              // One-sentence description of mistake
  "category": "...",             // From standard categories
  "solution": "..."              // How it was corrected
})

Vibe入住登记

Vibe检查前:

尽管有歧义,克劳德还是假设了MCP的含义,导致所有后续步骤都有这种错误的假设

Vibe检查后:

调用了Vibe Check MCP,并指出了其中的歧义,这迫使克劳德承认信息不足并积极解决问题

安装和设置

通过Smithery安装

要安装vibe,请通过以下方式自动检查Claude Desktop的mcp服务器 史密瑟里:

npx -y @smithery/cli install @PV-Bhat/vibe-check-mcp-server --client claude

通过npm手动安装(推荐)

# Clone the repo
git clone https://github.com/PV-Bhat/vibe-check-mcp-server.git
cd vibe-check-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

# Start the server
npm run start

与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

代理提示指南

对于有效的模式中断,请在系统提示符中包含以下指令:

As an autonomous agent, you will:

1. Treat vibe_check as a critical pattern interrupt mechanism
2. ALWAYS include the complete user request with each call
3. Specify the current phase (planning/implementation/review)
4. Use vibe_distill as a recalibration anchor when complexity increases
5. Build the feedback loop with vibe_learn to record resolved issues

何时使用每种工具

工具 何时使用
🛑 vibe_check 当你的代理开始解释todo应用程序的区块链基础知识时
⚓ vibe_distill 当你的代理人的计划中嵌套的要点比你的整个技术规格更多时
🔄 vibe_learn 在您手动将代理从复杂性深渊中引导回来之后

api参考

请参阅 技术参考 获取完整的API文档。

建筑

The Metacognitive Architecture (Click to Expand)

Vibe Check基于递归监督原则实现了双层元认知架构。关键见解:

  1. 图案惯性阻力LLM代理在其推理路径中自然表现出类似动量的特性,需要外部干预来重定向。

  2. 相位谐振中断元认知提问必须与代理人的当前阶段(规划/实施/审查)保持一致,以实现最大的纠正效果。

  3. 权限结构集成:必须明确提示代理人将外部元认知反馈视为高优先级的中断,而不是可选的建议。

  4. 锚杆压缩机构:复杂的推理流必须被提炼成最小的锚链,作为有效的重新校准点。

  5. 递归反馈循环:必须存储并利用所有观察到的失误来构建纵向故障模型,以提高中断效率。

有关基本设计原则的更多详细信息,请参见 哲学.

Vibe入住登记(续)




文档

文档 描述
代理人激励策略 代理集成的详细技术
高级集成 反馈链、置信水平等
技术参考 完整的API文件
哲学 Vibe Check背后更深层次的AI对齐原则
案例研究 Vibe Check-in的真实示例

贡献

我们欢迎对Vibe Check的贡献!无论是bug修复、功能添加,还是只是改进文档,请查看我们的 贡献指南 开始吧。

许可证

麻省理工学院