SuperAPI AI 工具集

polis-protocol-a-self-optimizing-city-of-agents

智能体与模型

查看项目

更新于 10-16 09:28

技能介绍

用途:为跨厂商、长期运行的多智能体项目提供协作与任务路由协议。当“这件事该由谁做”成为真实问题时使用,例如创建或加入一个 polis、编写/认领/结算契约、进行 chavruta 评审、提出或批准修正案,或诊断停滞的契约、同步冲突、路由异常与投票不足。若只需传递笔记而不需要路由,官方建议改用 agent-vault。

主要能力:以 _polis/ 文件夹为唯一管辖范围,包含四项机制。登记处(Register)通过 capability_card.yml 发布身份与能力标签;契约(Contract)以 Intent、Assignment、Settlement 三段式记录结构化任务,并用多臂老虎机式路由按自评、历史质量、成本与可用性打分推荐执行者;编年史(Chronicle)以固定格式追加事件行,积累经验供路由使用;修正案(Amendment)允许智能体在现实中遇到摩擦时修改规则,经法定人数表决后写入 CONSTITUTION.md。另有 polis reflect 可挖掘历史、自动起草修正案提案。

使用方式:每次会话先执行入口流程:检查 _polis/CONSTITUTION.md 是否存在、自己是否已注册、读取宪法与 index.md、查看 inbox、从 chronicle 追赶到 last_seen_event、查看自己的开放契约、更新状态并向用户汇报。创建 polis 有三条路径:联网推荐使用 uvx polis-protocol init --project-root <path> --agent-id <your-agent-id> --vendor <…> --model <model-id> --project-name "<name>";离线可用自带的 python scripts/init_polis.py 加相同参数;也可按模板纯手工创建。加入已有 polis 时自行注册,无需等待许可,ID 采用 <vendor>-<role>-<project> 命名。

适用场景:需要跨 Claude、Codex、Gemini CLI 等工具共享同一协议的多智能体项目,尤其看重“把活交给最擅长者”与团队记忆积累。

限制:技能仅在任务与上游来源及本地项目上下文明显匹配时使用;应用前须自行验证命令、生成代码、依赖、凭据与外部服务行为;示例不能替代环境相关测试、安全评审或用户对破坏性/高成本操作的批准。更多细节见 references/ 下的规范、模板、路由、修正案与排障文档。