Hermes Vibe Coding

技能简介

Hermes Vibe Coding 是专为 Hermes Agent 设计的一套 Vibe Coding 元技能（meta-skill），让开发者用自然语言描述需求，即可驱动 Agent 自动完成代码仓库理解、任务规划、跨文件编辑、错误自愈和 Git 提交全流程。v2 版本在 6 个核心维度上全面对齐 Claude Code 的能力，同时利用 Hermes 跨会话记忆优势实现超越。

核心能力

• 7 阶段 Agent 循环：Phase 0（Git 分支创建）→ Phase 1（仓库符号图谱）→ Phase 2（StraTA 多策略规划）→ Phase 3（AST 跨文件原子修改）→ Phase 4（LSP 语义校验）→ Phase 5（错误自愈）→ Phase 6（Git 结构化提交）→ Phase 7（项目记忆持久化）
• StraTA 规划子技能：采样 N 个候选计划卡（minimal / structured / rewrite 策略标签）→ 智能选择 → 自判断评分 → 将差距写入 Mistake Journal，形成学习闭环
• LSP 语义分析：集成 pyright / tsc / gopls / rust-analyzer，支持 Python / TypeScript / Go / Rust 四种语言
• 原子跨文件修改：基于 AST 导入图谱计算影响半径，事务性提交避免部分写入
• 10 类错误分类自愈：错误分类器匹配策略，bounded retry × 3 轮自动修复
• Git 全面集成：任务前 stash + 分支创建 → 分步提交 → PR 创建 → 回滚能力
• 跨会话结构化记忆：JSON 格式存储团队规范、常见陷阱和任务历史，v2.5 支持项目级配置
• v2.5.0 新特性：中日韩语言意图检测、项目级配置、非交互式选择模式（first/best/random）、7 类场景模板、类别感知阈值、自适应再校准

安装配置

• 前置依赖：需要先安装 Hermes Agent（hermes-agent.nousresearch.com）
• 安装命令：git clone https://github.com/itproco0701/hermes-vibe-coding && cd hermes-vibe-coding && bash install.sh
• 可选工具（自动检测安装）：ripgrep（快速文件搜索）、pyright（Python 语义分析）、madge（TypeScript 依赖图）
• Python 版本：需要 Python 3.11 或更高版本

使用步骤

• 初始化项目配置：strata-plan init 在项目目录生成 .hermes/strata-config.json 配置文件
• 启动 Vibe Coding 会话：在 Hermes Agent 中输入 /vibe-coding "添加 OAuth 登录流程" -p ~/myproject，或直接使用 CLI：vibe "重构认证模块为依赖注入" -p ~/myproject
• StraTA 规划采样：strata-plan sample "add OAuth to login flow" -n 4 生成 4 个候选计划，选择最佳：strata-plan pick --auto-select best
• 执行与判断：Agent 执行计划后，strata-plan judge .strata-plans/plan-*.md 评分，若低于阈值自动写入 Mistake Journal
• 回滚与状态查询：vibe undo 回滚全部更改；vibe status 查看当前分支和循环状态

适用场景

• 重构大型代码库：跨多个模块的依赖注入改造，需要 LSP 语义保证
• 自动化测试补充：API 变更后的回归测试自动生成与执行
• 多语言 monorepo 管理：Python + TypeScript + Go 混合项目的一致的开发体验
• CI/CD 集成：非交互模式（--auto-select）支持在 GitHub Actions / GitLab CI 中运行
• 团队知识沉淀：Mistake Journal + 项目配置在团队成员间共享学习经验
• 文档自动更新：代码变更后同步更新 README / API 文档

适用人群

• 使用 Hermes Agent 的开发团队和个人开发者
• 需要在 monorepo 中保持代码风格一致性的 AI 辅助开发团队
• 希望将 Claude Code 体验迁移到开源 Hermes 生态的用户
• 追求高可靠性的 AI 编程流程、需要错误自愈和规划验证的专业工程师

工作原理

Hermes Vibe Coding 的核心是 vibe_loop.py 驱动的 7 阶段 Agent 循环。当用户输入自然语言意图时，Intent Detection 模块判断是否需要加载 hermes-strata 规划子技能（包含 planning / refactor / fix 关键词时自动触发）。strata-plan sample 调用 LLM 生成 N 个候选计划，每个计划附有策略标签（minimal / structured / rewrite）、权衡说明和风险等级。strata-plan pick 支持交互式选择或非交互式自动选择（first/best/random）。执行阶段通过 LSP 诊断验证语义正确性，错误自愈模块根据 10 类错误分类器匹配最优修复策略。完成后 strata-plan judge 将计划与执行结果比对，低于类别感知阈值的差距写入 .vibe-mistakes.json，为后续运行提供预防性提示。v2.5 新增的 recalibrate 命令可基于真实判断数据自动调优阈值。

官方链接

• GitHub：https://github.com/itproco0701/hermes-vibe-coding
• Hermes Agent 主页：https://github.com/NousResearch/hermes-agent
• StraTA 论文：https://arxiv.org/abs/2605.06642