VexJoy Agent

概述 – VexJoy Agent 是一个 LLM 代理工具包，将纯英语命令映射到领域特定的代理、可复用的技能和验证钩子。Jev 驱动的路由器分类意图，选择正确的代理-技能对，并运行四阶段管道（计划、执行、验证、交付），在打开 PR 或交付输出之前强制执行基于证据的检查。它适用于 Claude、Codex、Factory 和 Reasonix，并通过填充每个运行时目录的单个脚本安装。

标题: VexJoy Agent – 用于代码调试、知识工作和自动化管道的结构化、证据驱动的 LLM 代理工具包

VexJoy Agent

这是什么 – VexJoy Agent 是一个工具包，让您可以向大型语言模型（LLM）代理（Claude、Codex、Factory、Reasonix 等）发出纯英语命令。路由器（/do 或 /d）对请求进行分类，选择合适的 代理（领域知识）和 技能（方法），然后执行多阶段管道（计划、执行、验证、交付），同时强制执行要求证据的 钩子。

关键概念

• 代理（43） – 精选的知识包（例如 Go 工程师、测试自动化工程师），了解领域词汇和故障模式目录。
• 技能（62） – 可复用的程序化方法，引导代理完成任务（例如系统调试、测试优先模式）。
• 钩子（79） – 生命周期检查，除非提供所需证据（测试输出、变更证明），否则阻止进展。
• 脚本（156） – 用于验证、调度和编排的自动化管道。
• Jev 路由器（/d） – 使用 TypeSafe 的 Jev 模型 保留意图：它重述预期结果，判断对齐，并在派遣代理之前将回执记录在 learning.db 中。

工作原理

/do → 路由器 → 任务计划 → 代理+技能 → 测试（门禁） → PR → 记录

路由器选择代理-技能对，运行四个阶段（重现、假设、验证、修复）的任务，最后打开带有修复的拉取请求。

安装

git clone https://github.com/notque/vexjoy-agent.git ~/vexjoy-agent
cd ~/vexjoy-agent
./install.sh   # 安装到 ~/.claude、~/.codex、~/.factory、~/.hermes、~/.reasonix

选项包括 dry-run、目标选择和卸载/回滚。安装程序是幂等的，可以通过本地 profile.yaml 配置。

典型用法

$ claude
> /do debug this Go test

系统将请求路由到 go-engineer 代理，使用 systematic-debugging 技能，运行四个验证阶段，修补代码，并打开 PR。

支持的运行时

• Claude Code（/do）
• Codex（$do）
• Factory（/do）
• Reasonix（/do）
• Hermes（已安装，但 README 中未详细说明）

可扩展性

• 按照 SKILL.md front-matter 架构，添加新的代理、技能或钩子。
• 使用提供的脚本（agent-scheduler.py、crontab-manager.py 等）来自动化定期判断或维护。
• 可选的 Jev Auto-Compact 插件可以在令牌使用量超过 60% 后修剪上下文，并通过 jev-compact-evidence.py 记录证据。

使用案例

• 代码库的自动调试和 PR 生成。
• 知识工作管道：研究、起草、HTML 报告生成（/html）。
• 结构化的、证据驱动的工作流程，每一步都必须经过验证才能继续。

设计理念（总结）

• 结果优先：描述结果，让路由器选择工具。
• 确定性代码用于可计算部分；模型仅用于判断/生成。
• 密集、规则丰富的提示；最小化不必要的上下文。
• 所有工作都通过强制门禁进行管道化，以防止静默失败。

许可证 – MIT。

---

所有细节均直接取自存储库的 README；未推断任何其他功能。