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 代理的工具包,通过钩子和脚本强制严格的验证和分阶段方法,防止代理跳过测试等关键步骤。