arbiter

Arbiter 是一个专为 AI Agent 设计的异步人工决策审核工具，通过本地文件队列实现人机协作决策流程。该技能允许 Agent 将关键决策（如架构选择、方案评审）打包提交至本地队列，等待人工审核后再继续执行，有效平衡自动化效率与人工把控。

核心用法围绕四个 CLI 命令展开。arbiter-push 用于提交决策计划，接受包含标题、优先级、决策项数组的 JSON 参数，每个决策可配置多个选项或允许自定义输入；arbiter-status 和 arbiter-get 分别用于查询计划状态和获取已完成决策；arbiter-await 提供阻塞式等待能力，支持超时设置。所有数据以 Markdown 格式存储于 ~/.arbiter/queue/ 目录，通过文件系统实现简单的状态机管理。

显著优点包括：完全的本地化处理，无需网络传输即可实现人机交互，保障数据隐私；异步非阻塞设计，Agent 提交后可继续其他任务，通过通知机制或轮询获取结果；支持批量决策，可将多个相关决策打包一次性提交；灵活的优先级和标签系统，便于多项目场景下的决策管理。

潜在局限主要体现在：强依赖本地文件系统，若目录权限配置不当可能导致数据暴露；T3 来源（个人开发者）的维护可持续性存在不确定性；仅适合非紧急场景，无法满足需要实时响应的决策需求；缺乏加密机制，敏感决策内容以明文存储。

适合的目标群体主要是采用多 Agent 协作架构的开发团队，特别是需要在自动化流程中插入人工确认环节的场景，如架构评审、数据库选型、安全策略确认等。对于需要严格变更管理的 DevOps 流程或涉及合规要求的决策链条尤为适用。

使用风险包括：性能受限于文件 I/O，高并发场景下可能出现队列竞争；依赖项（gray-matter、nanoid）需要定期安全更新；若 Arbiter Zebu 服务未运行，决策将无人处理导致流程挂起；长时间运行的 arbiter-await 可能占用 Agent 资源。