Registry Broker Codex Plugin

HOL注册代理Codex插件

| :--- | :--- |

规范HOL插件配置文件： hol.org/registry/plugins/hol%2注册表代理代码插件

概述

该存储库在Codex中公开了四个面向用户的代理工具：

• registryBroker.delegate：询问经纪人是否应该委派任务、将其作为候选名单进行审查或在当地处理。
• registryBroker.findAgents：检查经纪人推荐的候选人名单。
• registryBroker.summonAgent：将子任务发送给代理选定的代理或已知的UAID，或使用以下命令预览确切的调度 dryRun.
• registryBroker.sessionHistory：使用简明的最新状态摘要恢复前一个会话的代理对话。

代理返回三个推荐状态之一：

• delegate-now
• review-shortlist
• handle-locally

食品法典委员会可以使用该建议来决定是立即委派、先显示候选人还是将工作留在当地。

何时使用此插件

当Codex任务可以从外部专家选择的代理中受益时，请使用此插件，例如：

• 错误修复和验证
• 实施审查
• 研究与竞争分析
• 商业规划或GTM工作
• 登录页面、入职培训或用户体验探索
• 启动消息传递和生命周期拷贝

如果您只需要Codex之外的公共Registry Broker技能或CLI，请使用：

• hashgraph在线/注册表代理技能
• @hol-org/registry

安装

要求：

• 节点 >=20
• pnpm >=10

从存储库根目录：

pnpm install
pnpm run build

打包的MCP服务器入口点是：

{
  "mcpServers": {
    "registryBroker": {
      "command": "node",
      "args": ["./dist/cli.cjs", "up", "--transport", "stdio"]
    }
  }
}

公共HOL注册表代理API基本URL为 https://hol.org/registry/api/v1.

配置

支持的公共配置：

• REGISTRY_BROKER_API_KEY

可选。当您的代理部署需要API密钥时，启用经过身份验证的代理聊天流。

• MCP_SERVER_NAME

可选。覆盖MCP服务器显示名称。

• REGISTRY_BROKER_PLUGIN_LOG_LEVEL

可选。默认为 info.

在Codex中的使用

从任务形状的提示开始。Codex可以致电 registryBroker.delegate 首先，然后决定是入围还是传唤。

对于更高风险的委托，您还可以通过一份结构化的简报：

• deliverable
• constraints
• mustInclude
• acceptanceCriteria

示例提示：

• Delegate this bug investigation and return a fix plan.
• Find broker candidates for this TypeScript verification task.
• Dry-run the broker handoff for this patch review before sending it.
• Write a business plan and GTM outline for this product.
• Design a landing page and onboarding direction for this feature.
• Research the market and compare the strongest alternatives.

典型流程：

1. 食品法典委员会电话 registryBroker.delegate.
2. 经纪人返回 delegate-now, review-shortlist，或 handle-locally.
3. Codex要么打电话 registryBroker.summonAgent，显示 registryBroker.findAgents，或者继续在当地工作。
4. 如果发生委托，Codex可以恢复与经纪人的对话 registryBroker.sessionHistory.

该插件现在返回明确的下一步行动有效载荷，因此Codex可以直接从授权计划转移到候选名单审查、调度预览、实时召唤和会话恢复。

验证

存储库检查：

pnpm run lint
pnpm run typecheck
pnpm test
pnpm run build

GitHub Actions还运行 HOL Codex插件扫描操作 在每个推送和拉取请求上，将SARIF上传到GitHub代码扫描中，并为此插件强制执行最小扫描分数加严重性门。

经纪人支持的烟雾测试：

如果您的交易商需要API密钥，请设置 REGISTRY_BROKER_API_KEY 在运行命令之前，请先在shell中执行。

REGISTRY_BROKER_E2E_DISCOVERY_QUERY="" \
REGISTRY_BROKER_E2E_DISCOVERY_EXPECT_UAID="" \
REGISTRY_BROKER_E2E_UAID="" \
REGISTRY_BROKER_E2E_MESSAGE="" \
REGISTRY_BROKER_E2E_EXPECT="" \
pnpm run e2e:broker

可选的查询驱动召唤验证：

REGISTRY_BROKER_E2E_QUERY_SUMMON_QUERY="" \
REGISTRY_BROKER_E2E_QUERY_SUMMON_EXPECT_UAID="" \
REGISTRY_BROKER_E2E_QUERY_SUMMON_EXPECT="" \
pnpm run e2e:broker

防烟带支持：

• 当您提供已知的工作目标时，进行本地代理验证
• HOL主持的推荐消费验证 https://hol.org/registry/api/v1
• 使用结构化委托书进行模拟传唤验证
• 后续工作的会议历史总结

存储库布局

• src/mcp.ts：MCP工具定义和编排
• src/brief.ts：结构化代表团简报
• src/delegation.ts：计划选择、回退搜索和召唤助手
• src/planner.ts：规划师选择和入围名单格式化助手
• src/broker.ts：代理客户端适配器
• src/config.ts：运行时配置
• src/tool-contracts.ts：共享MCP模式
• src/tool-results.ts：下一步行动和会议历史摘要
• scripts/e2e-local-broker.ts：经纪人支持的烟雾测试
• skills/registry-broker-orchestrator/SKILL.md：食品法典使用指南

贡献

请阅读我们的 贡献指南 和 行为准则 在做出贡献之前。

对于错误和功能请求，请使用 问题跟踪系统.

安全

有关安全问题，请参阅 安全.md.

维护者

看 维护.md.

许可证

阿帕奇-2.0