SuperAPI AI 工具集

polis-protocol

智能体与模型

查看项目

更新于 10-16 05:51

技能介绍

用途:当两个及以上智能体(尤其跨厂商)协作于同一项目、且“谁该做这件事”成为真实问题时使用;适合希望团队随结果可衡量改进、需要可 git 审计的“谁做了什么、学到什么、改了哪些规则”记录的场景,也可作为 Antigravity 默认编排过于僵硬时的路由与治理层。

主要能力:每个智能体在 _polis/citizens/ 发布能力卡;工作以带 required_tags 的合同(contract)开启而非固定角色分派;路由由学习型 bandit 按历史、自评、成本、可用性、已应用教训打分并推荐;智能体可保留文件(polis reserve src/auth --as <citizen>),重叠声明会被拒绝并指出持有者;结算合同会归档教训,被接受的教训带有限定的 routing_effect 供下次相似任务读取;失败转为 guardrail,后续同标签合同继承为必过验收标准;公民可提议并投票修正协议本身。厂商无关,Antigravity、Claude、Codex、Gemini 可共享一个 _polis/。使用方式:默认用已审阅的 checkout 固定脚手架代码,先 git clone 仓库并 git checkout <reviewed-commit-sha>,再运行 python3 scripts/init_polis.py 并传入 --project-root、--agent-id、--vendor、--model、--tool;也可在审阅后 pipx install polis-protocol==<reviewed-version>,不要用未固定版本的 uvx 或 latest 自动化安装。init 会写入 _polis/、.agents/skills/ 及指向 _polis/CONSTITUTION.md 的桥接指针,可用 --dry-run 预览,init 不覆盖已有文件,polis init --repair 可恢复缺失文件。路由示例:polis route --polis-root _polis --contract _polis/contracts/open/your-task.md --explain。结算与学习:polis contract settle <contract-id> --quality 5;polis reconcile --polis-root _polis。可运行 polis bench --mode learning 自行复现学习效果。限制:路由质量依赖准确的能力卡与足够结算历史;协议协调工作但不替代评审、测试或维护者明确批准;多智能体投票与修正对小规模单人任务会增加流程开销;上游脚本为外部代码,须固定到已审阅提交并先 --dry-run 再允许写入项目。