notque/vexjoy-agent

VexJoy AI Agent with Intelligent Routing - /do routes plain-English requests to the right specialist agent and gates the work with reviews, tests, and a learning loop.

它解决了什么问题

VexJoy Agent 通过用结构性强制来取代建议性指令,防止 AI 代理“跳过步骤”或交付有缺陷的代码。它解决了代理自信地声称工作已完成或“微不足道”,却没有实际运行测试或验证更改的问题,确保无论代理的自信程度如何,都遵循高质量的方法论。

工作原理

该工具包通过四层架构直接集成到 AI CLI 运行时(如 Claude Code、Codex、Factory 和 Reasonix)中:

  • Agents(代理): 提供领域特定知识,包括失效模式目录和错误‑修复映射。
  • Skills(技能): 定义具有严格退出标准的分阶段方法。代理在未提供成功证据前,不能进入下一阶段。
  • Hooks(钩子): 生命周期事件触发器,以零 LLM 成本阻止不完整的工作。
  • Scripts(脚本): 确定性工具(如 linter、测试运行器),负责实际执行和验证,将验证过程中的 LLM 判断剔除。

用户通过路由器与系统交互(例如使用 /do 命令),系统会分析意图并自动将合适的专科代理与相应的技能和方法配对。

适用人群

  • 开发者: 需要一种代理工作流,保证代码验证并防止回归。
  • 知识工作者: 使用该工具包进行研究、起草以及创建自包含的 HTML 产物(报告、幻灯片、原型),无需编写代码。
  • AI 高级用户: 想要自定义路由表、流水线和钩子。

亮点

  • 反合理化(Anti‑Rationalization): 使用退出门和钩子阻止代理跳过测试或验证,要求返回退出码而非断言。
  • 多运行时支持: 兼容 Claude Code、Codex、Factory 和 Reasonix。
  • 集成路由(Harness‑Integrated Routing): 自动将纯英文请求路由到正确的专科代理和方法论。
  • 知识工作引擎: 包含内容引擎,可根据 AI 模式验证草稿并生成高保真 HTML 产物。
  • 基于证据的演进: 新技能在合并到工具包前会进行 A/B 测试,以基线为对照。

摘要

一个面向 AI 代理的工具包,通过钩子和脚本强制严格的验证和分阶段方法,防止代理跳过测试等关键步骤。

标题