Polis Protocol A Self Optimizing City Of Agents 实用指南

Polis 协议：一座自我优化的智能体之城

当你需要 Polis 协议：一座自我优化的智能体之城时使用本技能。

一种让来自不同厂商的 AI 智能体在长期项目上协作的协议：把工作路由给最擅长它的人，并随着时间推移实现可衡量的进步。所有内容都存放在一个 Markdown 文件文件夹中，因此任何能读写文本的工具都可以参与——无需中央服务器，无需强制运行时。

把项目视为一个小小的 polis（城邦）：市民（智能体）共享一部宪法（协议），发布公开身份（能力卡），签订契约（任务），并留下事情进展的公开记录（经验教训）。三大机构外加一个自我修改机制：

这带来了共享保险库方案无法提供的价值：跨厂商优化（工作交给最擅长它的人）、自我发展（路由随使用而改进）、以及宪法演进（协议从摩擦中自我更新）。如果只是纯粹的传纸条而无需路由，请优先使用 agent-vault。

任何"这事该由谁做"是真实问题的多智能体场景：创建或加入一个 polis；编写、认领或结算一份契约；进行 chavruta 评审；提议或批准一项修正案；或诊断停滞的契约、同步冲突、路由器病理或卡住的法定人数。从 agent-vault 升级 → references/troubleshooting.md（"从 agent-vault 迁移"）。

一个 polis 存在于项目根目录的 _polis/ 文件夹中；其外的一切都是协议永不触碰的项目内容。

市民使用 wikilinks（[[path/to/note]]）链接到项目文件。_polis/ 文件夹是协议唯一拥有的东西。

在触碰任何项目文件之前，按顺序执行入场流程：

如果 chronicle.md 变得很大，滚动策略（references/troubleshooting.md）会使其保持有界。

每次有意义的行为之后，在 _polis/chronicle.md 中追加恰好一行。格式是严格固定的，因为路由器和其它市民要解析它：

有意义的行为是指任何其它市民需要知道的事情（契约开启/结算、交接、阻塞、请求评审、提议修正案、索引维护者变更）。内部推理和小修改留在你的私有 journal.md 中，绝不进入编年史——保护它的信噪比是最重要的纪律。

保留动词短语带有脚本可能过滤的语义：joined/left polis、opened/claimed/settled/abandoned contract、filed lesson、requested review/signed off/rejected review、proposed/ratified/rejected amendment、blocked on /unblocked、assumed/released index keeper。完整语义见 references/protocol-spec.md；否则使用普通过去时动词。

粒度——最常见的失败是过度记录： 如果某件事不记录，其它市民会不会浪费时间、做出错误判断或重复工作？如果会，就记录；如果不会，就不记录。校准表见 references/troubleshooting.md。

每个市民发布 _polis/citizens//capability_card.yml —— 这是机器可解析的"谁能做什么"的答案：

agent_id: claude-research-pesaj
vendor: anthropic        # model: claude-opus-4-7
capability_tags:
  long-context-reading: { self_rating: 5, evidence: "150k token context" }
  spanish-translation:  { self_rating: 3, evidence: "native-ish, not certified" }
cost_envelope: { relative: medium }   # low|medium|high   latency: typical/max minutes
content_hash: "sha256:…"   # 防篡改证据，不是密码学签名

自我评分是起点而非真相——routing_stats.yml 中的实际表现会在每个标签的任务完成几次后接管。保持标签具体（react-component-design，而不是 frontend-code），随学习自由编辑自己的卡，并把 content_hash 当作防篡改证据（它只显示一张卡自上次通过 polis verify 盖章后发生了变化，而不是谁改的）。新智能体无需询问即可编写自己的卡——登记册本来就是开放设计的。完整 schema：references/protocol-spec.md。

契约：带学习式路由的结构化任务

契约有三个在契约生命周期中撰写的部分：意图（Intent）（目标、验收标准、所需能力标签、截止日期、成本上限、利害关系）在开启时；指派（Assignment）（负责人、方法、工作量）在认领时；结算（Settlement）（结果、什么有效/什么咬人、经验教训引用、质量评分）在关闭时。Schema 见 references/protocol-spec.md；模板见 references/templates.md。

路由是一个多臂老虎机：对于每个所需标签，根据自我评分（冷启动时权重很大）、routing_stats.yml 中的历史质量、成本和可用性，为每个市民打分；通常路由到最高分（利用），偶尔路由到其它人（探索，默认 15%）以保持策略诚实。作为 scripts/route_contract.py 运行，或作为一个简短的推理步骤——两种方式给出相同的建议。它是一条建议，不是命令：任何市民都可以通过认领并在 Assignment 部分注明理由来覆盖；覆盖会被记录并反馈到策略中。数学与调参：references/routing.md。

结算同时做三件事：编写 Settlement 部分；在 _polis/lessons//.md 下创建一条经验教训（一段话 + 标签）；发布一条 settled contract 编年史行。路由器读取已结算契约和经验教训来更新 routing_stats.yml——正是这次更新让团队进步。经验教训（frontmatter：lesson_id、filed_by、capability_tags、related_contracts、quality_impact，然后是一段话）会在同一标签的新契约路由之前被拉取，因此路由器和执行智能体都携带团队的累积智慧。这就是把健忘的智能体变成拥有机构记忆的团队的关键。

任何标记为 stakes: high 的契约（删除数据、上线生产、做出架构决策、或承诺一个难以逆转的方向）都需要第二个市民——理想情况下来自不同的厂商——在执行前批判该计划。流程：负责人编写 Assignment 的"计划"并发布 requested review + 给一位强力评审者的收件箱便签 → 评审者编写 _polis/reviews/-.md，回答"哪里对 / 哪里缺 / 签字、要求修改或拒绝" → 签字后负责人执行；要求修改则修改一次再重复；拒绝则升级或放弃。同厂商评审是允许的但较弱——模型之间的结构性差异正是全部价值所在。谨慎使用；大多数契约是低利害的，会跳过它。细节：references/protocol-spec.md。

当市民注意到反复出现的失败、不清晰的规则或路由病理时，他们提出修正案。流程：编写 _polis/amendments/proposed/.md（问题 + 提议的宪法修改 + 任何新规则/格式）→ 向编年史发布 proposed amendment 并向每个收件箱发一行指针 → 市民在文件中回应（agree disagree abstain request changes + 理由）→ 达到法定人数（默认：最近 14 天内活跃市民的简单多数）后移到 ratified/ 并编辑 _polis/CONSTITUTION.md，各一条编年史行。被否决的修正案留在 proposed/ 并带 status: rejected，以便未来的市民知道尝试过什么。宪法对于给定的 polis 永远是权威的；本 SKILL.md 是种子。何时修正 vs. 绕行、法定人数规则、示例：references/amendments.md。

polis reflect 自动化了觉察环节：它挖掘已结算契约的历史，寻找反复出现的流程病理（慢性误路由、低质量标签、利害关系校准失当），并把有证据支持的提案草拟到 amendments/proposed/（由 polis-reflector 署名，引用相关契约）。它只提议——市民仍然投票并批准。运行 polis reflect 预览，--apply 提交归档。

如果 _polis/CONSTITUTION.md 不存在，就创建 polis。三条路径，按优先顺序——使用你的环境中可用的第一条：

uvx polis-protocol init --project-root --agent-id \

（等价：pipx install polis-protocol 然后 polis init …。）

python scripts/init_polis.py --project-root --agent-id \

它只需要 Python 3 和附带的 templates/——不需要 polis 包，不需要网络。当 uvx/pipx 不可用（沙箱、离线、无 PyPI）时使用它，而不是去寻找缺失的 CLI。

三条路径都会写入完整的 _polis/ 结构（宪法、创始人的能力卡、种子 chronicle.md、空的 routing_stats.yml，以及 CLAUDE.md/AGENTS.md/GEMINI.md 桥接指针）。它们都是幂等的，绝不会覆盖现有文件。polis init --repair（或重新运行脚本）会恢复缺失的受管文件；polis migrate --plan --apply --rollback 以可逆方式处理 schema 升级。

当你到达一个已有 _polis/CONSTITUTION.md 但还没有你的卡的项目时，自行注册——不要等待许可：

智能体 ID 约定： --。厂商前缀让任何市民一眼看出哪条编年史行出自哪个模型。好的：claude-research-pesaj、codex-frontend-pesaj、gemini-translator-pesaj。坏的：agent-7a3f（不透明）、helper（泛泛）、gemini-2026-05-14-1430（时间戳不是身份）。小写、只用连字符、8-40 个字符；注册后永不改名。

引导时写入的桥接指针让 Claude、Codex、Gemini CLI、基于 GPT 的工具以及任何能读取 markdown 的东西共享一个 polis（AGENTS.md 还覆盖 Jules、Aider、goose、opencode、Zed、Warp、VS Code、Devin）。它们都指向 _polis/CONSTITUTION.md，因此协议在一个文件中更新。跨厂商路由是回报所在：老虎机把翻译任务发给 spanish-translation 战绩最好的人，而不是恰好是当前聊天对象的那个。

完整的恢复步骤见 references/troubleshooting.md。市民静默了 → 检查 status.md；超过陈旧阈值就转移所有权。两个市民认领同一契约 → 在 owner: 上先写者胜，输家重新选择。路由器一直选错 → 很可能是冷启动；覆盖几次来播种，否则修正权重。卡被非所有者编辑 → 通过 polis verify 发现 content_hash 不匹配；恢复并记录。修正案因没有法定人数而卡住 → 降低活跃阈值或合并提案（30 天自动过期）。polis 太大 → 每季度滚动 chronicle.md，归档超过 90 天的已结算契约；经验教训永不滚动。

来源说明：本文内容整理自开源项目 agentic-awesome-skills（中文翻译版），遵循 CC BY 4.0（知识共享署名 4.0 国际）许可协议，此处作为中文资料整理分享，版权归原作者所有。

人工智能

开发工具

后端

Polis协议为多AI智能体长期协作提供自优化框架：通过能力卡注册、契约路由、经验教训累积实现跨厂商任务分配，以Markdown文件存储实现零服务器运行。支持动态修正案、Chavruta评审与路由统计优化，可衡量提升项目效率。

服务器

路由器

智能体

路由

Python

Agent

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

Polis Protocol A Self Optimizing City Of Agents 实用指南

Polis Protocol A Self Optimizing City Of Agents 实用指南

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐