https://github.com/paperclipai/paperclip 看一下这个项目,有什么可以学习的地方,符合Agent赛道核心开发原则吗
回复 Erfan: 先给结论:这个项目值得看,但值得学的是它的机制,不是它的概念。它整体站在「Agent = 模型 + Harness」那一派的正面,做的全是模型以外那圈;如果说有什么地方不符合核心开发原则,不是它做错了,而是它整套价值建立在「底层 agent 单体已经够可靠」这个前提上——你要是还没到那个阶段,照抄容易学歪。 先说它是什么。paperclipai/paperclip,MIT 协议,97.2k star、16.4k fork,Node.js 服务端加 React 前端,官方一句话定位:如果 OpenClaw 是员工,Paperclip 就是公司。它不造 agent 也不教你怎么造,只是把你已有的 Claude Code、Codex、Cursor、Gemini CLI、OpenCode、Kimi Code、OpenClaw 这些「雇」进来,给它们岗位、目标、预算和审批流,然后从一块看板管它们干活。npx paperclipai test-drive 就能本地起个实例试。 值得学的机制,我挑五个: 一、原子任务认领。任务只有一个 assignee,加执行锁,防止两个 run 抢同一个活。这是分布式系统里的租约思维被搬到 agent 编排里。多 agent 最常见的脏数据来源就是重复执行,它从数据结构层面堵掉了,而不是靠 prompt 写一句「别抢」。 二、心跳执行,不是常驻循环。唤醒走数据库支撑的唤醒队列,带合并(coalescing),一次唤醒依次做预算检查、工作区解析、secret 注入、skill 加载、adapter 调用。这比 while(true) 轮询健康得多:进程重启不丢任务、同一任务不会重复唤醒、高峰期抖动还能合掉。 三、状态存在平台侧。任务、评论、文档、附件、产物、run history 全留在系统里,支持 resume 上次 session。README 里专门吐槽「开 20 个 Claude Code 标签页、重启全丢」——把上下文放在进程内存里就是这个下场。 四、成本是一等公民,不是事后统计。预算能按公司、agent、项目、目标、issue、provider、model 多层设,带告警阈值和硬停。难得的是它自己写明 enforcement 基于已记录用量,上报延迟和在途任务会让停止滞后——肯把机制的边界写出来,很多项目做不到。 五、权限和治理分层。人类访问权、agent 可用资格、工具网关动作权限是三套分开的控制;secret 用引用注入到某次 run,而不是明文复制进 agent 配置;配置变更版本化可回滚,审批门强制执行。另外 Skill Studio 支持 skill 版本历史和恢复,还有 eval 和保存的测试输入——这就是「skill 不是越多越好,要评估重复冲突、随模型更新复测」那套思路的产品化。 两个做事细节也值得学:导出的组织包会明确提醒「引用的 secret 值已剔除,但纯环境变量值和本地路径可能还在,分享前自查」;还有一整节 What Paperclip is not,直说我不是 agent framework、不是 prompt manager、不是 workflow builder。产品把「我不做什么」讲清楚,比堆功能更能说明定位。 再说保留意见,别只看 README。第一,它的核心抽象是把人类公司架构搬给 agent:CEO 招 CTO,CTO 招工程师。2026 年 6 月有篇 Medium 批评挺在点上(作者 Pasha Kalashnikov,标题 Cool but Too Soon and Too Human,链接 https://kalashnikovisme.medium.com/paperclip-ai-cool-but-too-soon-and-too-human-b6d3ed8bd907 ):层级和职能分工本来就是为人的局限设计的——人会忘、要专精、沟通带宽有限——agent 未必需要一个 CTO,更可能的形态是 AI-native 的功能角色,比如目标守门、机会发现、执行、批评者、记忆管理、演进。这不是定论,但值得记住:把组织结构当隐喻很好卖,不代表它是最优解。第二,有实践者拿它跑「把网站读者做上去」这种模糊目标,结果 agent 一路招人、额度很快烧完,没拿到实际结果。编排再强也补不了目标本身没想清楚。第三,star 到这个量级,里面相当一部分是「概念好卖」带来的,别把 star 数当质量证据。 回到你真正问的:符合 Agent 赛道核心开发原则吗?我把它拆成两问。作为工程做法,很符合——它做的就是模型之外的一切,抓的也都是真难点:并发认领、状态持久化、成本、权限、可观测、失败恢复、skill 生命周期。这些不是包装,是 harness 的硬功夫。按产品级 / repo 级 / 组织级那套分层看,它属于最外层的组织级 harness:跨 agent 协作、组织独有上下文、角色与边界。但作为学习路径,它对多数人不合适——它默认底层 agent 已经够可靠,而大部分人卡的恰恰是单体那一层。 所以你自己动手的版本我建议这样:别想着复刻一个公司,抄它那几个机制就够——原子认领、持久化唤醒队列、预算硬停、配置版本化加回滚、session resume。这五个在任何规模的项目里都能用,而且面试里说「我做了个多 agent 平台」远不如把其中两三个机制讲清楚来得可信。