vibesafe

Vibesafe 是一款专业的开发工具，旨在解决人工意图与 AI 生成代码之间的落差。它提供了一个稳健的合约系统，让开发者能够通过类型注解与嵌入式 doctest 撰写 Python 函数规格，并由 AI 填充经验证的实现。通过内容寻址哈希 (content-addressed hashing) 与确定性检查点，Vibesafe 能确保生产环境运行的代码与开发阶段测试的完全一致，防止非确定性 LLM 输出所造成的代码漂移。此技能整合了 Vibesafe MCP 服务器，让您能够管理整个工具链——从扫描项目中的装饰器单元，到强制执行质量闸道与自动重新生成过时的代码。

• 执行全面的项目扫描，识别并索引所有经 Vibesafe 标记的单元及其元数据。

• 自动化代码生成与编译任务，支持指定目标与强制重新生成，以实现精确的实现控制。

• 执行整合式 doctest 与质量闸道，通过 mypy 检查类型安全，并通过 ruff 进行代码风格检查。

• 管理并保存经哈希锁定的检查点，以冻结已验证的代码，确保不同环境间的可重现性。

• 产生包含版本信息、单元数量、环境状态与检查点完整性的详细状态报告。

• 通过比较当前实现与已验证检查点来检测漂移，在部署前向开发者警示未经授权的规格变更。

• 当您从事需要 AI 辅助开发，且同时对安全性与可重现性有严格要求的企业级 Python 项目时，请使用此技能。

• 输入通常包含选择性操作的目标单元标识符，或进行批次状态检查与验证的项目范围指令。

• 预期输出包含诊断表格、编译日志、测试结果，以及检查点同步确认。

• 请注意，Vibesafe 强制执行严格的开发/生产生命周期：在开发阶段，哈希不匹配会触发自动重新生成；而在生产阶段，这些不匹配会导致快速失败错误，以保护部署的完整性。

• 确保您的环境已配置适当的 AI 供应商（如 OpenAI 兼容的 LLM），以启用 Vibesafe 框架内的自动生成能力。