--- title: "Anthropic透露了对法律AI插件基础设施的顶尖理解" section: "法律AI教程" slug: "2026-05-15-Anthropic透露了对法律AI插件基础设施的顶尖理解" canonical_url: "https://fazhuli.cn/tutorials/t_23y7d5oknbe" date: "2026-05-15" author: "吕盈辉律师" tags: ["法律AI"] --- # Anthropic透露了对法律AI插件基础设施的顶尖理解 作者：吕盈辉律师 发布日期：2026-05-15 ## 摘要 假设你git到了 Anthropic 官方发布，面向法律行业的插件 claude-for-legal 的源码，里面有12个插件：商事合同、劳动法、诉讼、合规、尽职调查…… ## 正文 假设你git到了 Anthropic 官方发布，面向法律行业的插件 claude-for-legal 的源码，里面有12个插件：商事合同、劳动法、诉讼、合规、尽职调查…… 但你一看，这玩意儿针对美国的啊，我是跟中国法打交道的，玩个锤子还，做适配先。 于是你在这个基础上做了中国化改造，把北大法宝的MCP接口或着我星球会员的法律法规和案例查询CLI接进去了，把审查逻辑里的 Delaware law 换成了《民法典》，把 GDPR 换成了《个人信息保护法》。 你想用这个改造过的版本搭一套自己的法律AI体系。 你装好了劳动法插件，花了一个小时完成初始化，填好了你们所的劳动争议审查规则、经济补偿金的计算偏好、哪类风险点要标红。 第二天插件出了新版，你安装更新。打开一看，配置全没了，模板恢复了初始状态。 你让AI检索类似案件，它回复说"根据北大法宝查到的相关判例……"，但北大法宝的MCP你还没有配置，账号也还没有绑定。 AI看到配置文件里声明了北大法宝的连接信息，就认为它能用，然后从训练数据里"补充"了一批看起来真实的判决引用。 你说"帮我看看这个劳动合同"，系统里有竞业限制审查、劳务派遣合同审查、保密协议审查等十几个专项技能。 AI选了一个，结果是错的，和你发的合同类型不符。你重发了一遍，这次选了另一个，结论又不一样。 这三个问题，不是偶发的bug，是没有基础设施时必然会发生的系统性缺陷。解决它们的，是四个文件： plugin.json 、 .mcp.json 、 CLAUDE.md 、 SKILL.md 。 ![四层基础设施总览](https://mmbiz.qpic.cn/sz_mmbiz_png/et3ibfiaM9ia2zK1kicbvjFyKtLHKnibHuwksbrI1qjr0ZtFnDYEqkPQDAFexUuN3n3vffQFcIoRaTD5LMyFx6yWssLaAZH0v2CTZJpNgg74FPRI/640?wx_fmt=png) ## 第一层：plugin.json — 插件怎么被识别 每个插件根目录下有一个隐藏文件夹 .claude-plugin/ ，里面是一个8行的 plugin.json ，只有四个字段：name、version、description、author。 ![image](https://mmbiz.qpic.cn/sz_mmbiz_png/eRZqoqddscLb6nwApBkYZcSyBHjCedQga8jPyKMbXCOCUpWFB8rUPeqCeuz7D4n6Jj2S8zaCDr11iaO4Uxm24KVNSD5lWV14qyH6FPrkTzfk/640?wx_fmt=png&from=appmsg) name 是整个插件在系统里的地址起点。技能的触发命令从这里派生——商事合同插件叫 commercial-legal ，它的审查技能触发命令就是 /commercial-legal:review ；劳动法插件叫 employment-legal ，对应命令是 /employment-legal:review 。两个插件都有叫 review 的技能，但前缀来自各自的 name，永不冲突。用户配置文件的存储路径也从 name 派生，不同插件的配置物理上分开存放。 version 不是给用户看的更新日志，是给系统的迁移信号。用户在 1.0.1 下填好了所有配置，插件升到 1.0.2，系统看到版本号变了，就知道要去旧路径检查有没有已填写的配置，找到了就迁移到新路径，再触发增量问卷，只问新增字段，不让用户重来。 版本号永远写 "1.0.0" 不更新，这个机制就失效了。 description 是四个字段里最容易被忽视的。它不是给人看的说明，是给AI做技能匹配的触发信号。 当用户说"帮我审一下这份劳动合同"，系统需要从12个插件、几十个技能里找到最相关的那个，判断依据就是把用户意图和每个插件的 description 做语义匹配。 description 里写"review employment contracts under PRC Labor Contract Law"还是只写"法律合同插件"，决定的是匹配精度，也是这个技能能不能在正确的时机被调用。 author 是信任链的起点。Anthropic 出品的插件和社区贡献者出品的插件，在安装时走不同的审查路径。后者要通过白名单核验，author 字段不在白名单里，安装请求被拒绝。 ## 第二层：.mcp.json — AI的外部工具怎么接入 MCP（Model Context Protocol，模型上下文协议）是 Anthropic 提出的一个开放标准：让AI可以直接向外部系统发请求，而不是依赖人工把数据粘贴到对话框里。 .mcp.json 这个文件，告诉AI它有哪些外部工具可以用。 ![image](https://mmbiz.qpic.cn/sz_mmbiz_png/eRZqoqddscLgdjKTI3U4zoG4ibUBVXm9HY5kjzpaBESTJyqGzGTcTIKbnjkr9Xt2tvBFicMiaTCM9HgLpaSkFbiad4snyaj3ILUCqlib2jUd7sz0/640?wx_fmt=png&from=appmsg) 每个连接器声明里，description 字段是最重要的。AI决定要不要调用一个工具，看的是这里，不是 title。 Ironclad 的 description 里写了"expiring MSAs（即将到期的主服务协议）、termination clauses（终止条款）、vendor agreements（供应商协议）"，当用户问"有没有快到期的合同"，AI会想到Ironclad；如果 description 只写"contract database"，AI可能想不到去调它，或者调了却不知道该传什么参数。 不同法律领域需要完全不同的连接器集合。商事合同插件连接 Ironclad（合同库）、DocuSign（电子签名）、iManage（文档管理）。诉讼插件连接 CourtListener（联邦判例库）、Trellis（州法院数据）、Everlaw（电子取证平台）。劳动法插件只需要 Slack 和 Google Drive。 连接器不是越多越好，多余的连接器会干扰 AI 的调用决策，让它在不合适的场景下尝试调用一个根本用不到的工具。 配置了不等于能用，这是这一层最核心的规则。 .mcp.json 里声明了北大法宝，不代表北大法宝可以查，可能是账号没有、API key 没配置、网络不通。 冷启动面试（插件初始化向导）有一个专门的探测步骤：只有实际调用成功了，才标记为"✓ 可用"；声明了但没有探测通过的，标记为"⚪ 未验证"，并说明怎么确认。 这条规则的代价是每次初始化要真正发出测试请求。收益是：AI 不会在连接器不可用时从训练数据里"补充"一个听起来真实的引用。 在法律工作里，一个有来源但来源是虚构的结论，比没有来源的结论更危险，因为它看起来已经有依据了。 ## 第三层：CLAUDE.md — 用户配置怎么在版本升级中活下来 这是开头那个"配置全没了"问题的解法。 根本矛盾在于：插件自带的 CLAUDE.md 是模板，随着插件版本更新会被替换。但用户填进去的配置是用户数据，不能被替换。 ![image](https://mmbiz.qpic.cn/sz_mmbiz_png/eRZqoqddscJ86ZKdJH7OIpoDoH0ukfu0qibYVV1R3zzEnjsQuO9sUQO7vGqWFP3yL43SFnxN0ZUiakRQVuYV1kHicSMZGduO9gwNL6TCQfq6fw/640?wx_fmt=png&from=appmsg) 如果模板和用户数据住在同一个文件里，更新模板就必然损坏用户数据，没有中间地带。 解法是物理分离：让它们住在不同的文件，放在不同的路径。 插件目录里的 CLAUDE.md 是只读模板，跟着插件版本走，每次升级可以被覆盖。用户配置住在 ~/.claude/plugins/config/claude-for-legal/<插件名>/CLAUDE.md ，完全在插件目录之外，插件怎么升级都碰不到它。还有第三层：跨插件共享的公司画像，存在 ~/.claude/plugins/config/claude-for-legal/company-profile.md ，12个插件都读它，不需要每个插件里重复填一遍公司信息。 ![模板与用户配置的物理分离](https://mmbiz.qpic.cn/sz_mmbiz_png/et3ibfiaM9ia2x1UfmFUicoCmnsxk3aNg22mbg4RibvnroHC5phhqBYWmskzpemfyrqcial0QpK4c38ZzRnC4a6A1brsEicrOCTbt2MDOGR1qPjQ28/640?wx_fmt=png) 模板里凡是需要用户填写的位置，都有一个 [PLACEHOLDER] 标记。每个技能在开始工作之前，都会先检查用户配置文件。发现 [PLACEHOLDER] 还在，技能停下来，拒绝继续： > "这个插件还没有配置，无法给出有用的输出。请先运行冷启动面试，大约需要10-15分钟。" [PLACEHOLDER] 不是给人看的提示，是给技能代码看的执行拒绝信号。宁可拒绝工作，也不输出一个通用的、看起来像定制但实际上什么都没考虑的法律审查意见。通用的审查意见让人误以为已经针对自己的情况做了分析，这比没有审查意见更危险。 ## 第四层：SKILL.md 路由 — 用户的一句话怎么到达正确的技能 用户说"帮我看看这份合同"，系统里有十几个审查技能，用哪个？ claude-for-legal 的解法是两层分离：一个路由技能负责识别文档类型，再调用对应的专项技能。路由逻辑的核心是一张硬编码的映射表： ![image](https://mmbiz.qpic.cn/sz_mmbiz_png/eRZqoqddscJREiaa4W45BLFF7kc5bicKmYJ7GQqBUgLXFMhFNXufCAMcov0knwZA3LvbxibdWJPBxh5jzj0TzAetkwwOtAdibu4rRwxRSte5ibKE/640?wx_fmt=png&from=appmsg) 这里有个容易忽略的设计：路由优先读文档标题，不是优先读正文关键词。 ![image](https://mmbiz.qpic.cn/sz_mmbiz_png/eRZqoqddscJA9jrHbneZOsQ66LdkzgucfGQeFtoEn9DTXXJBvjsf87iblSgapnCtMph7TEV43qicn5ZIsZ0icf8v6TOLVcFyjKnJZmScicMFUIM/640?wx_fmt=png&from=appmsg) 一份40页的主服务协议，正文里"confidential"这个词可能出现上百次。如果用关键词匹配正文，系统会把这份MSA误判为NDA，审查结论完全错误。文档标题是路由的主要信号，正文是备用。 ![用户输入到技能的路由调用链](https://mmbiz.qpic.cn/sz_mmbiz_png/et3ibfiaM9ia2xiabOCAOZyEIHeGLdeoL499ty82uP8CicxPkfFlXZCjuAmLgc0ZQBmFefmNpyEpw4k4GjJ1drPvJD8pibeNrIJYpRUrxVsMPMhOk/640?wx_fmt=png) 路由技能发现文档附件里有数据处理协议（DPA），会同时调用对应的数据保护分析，合并成一份完整的审查备忘录。子技能被标记为 user-invocable: false ，用户不能直接输入 /nda-review ，这条技能只能由路由触发。原因很直接：用户如果直接用 /nda-review 审一份 SaaS 合同，结论是错的。 为什么不让AI自由决定路由，有两个理由。 一是可审计性。硬编码的映射表，路由出了问题，能看到哪一步走错了，能修复。AI自由决策，出了问题不知道为什么，也没法系统性修复。 二是一致性。同一类合同每次都走同一条路由，同类合同的审查结论才能横向比较。法律工作需要稳定的、可重复的流程，不能"今天心情好就路由对了"。 ## 四个文件合在一起 plugin.json 解决身份问题： 这个插件叫什么名字、命名空间怎么隔离、description 让AI知道什么时候该调用它。 .mcp.json 解决工具诚实的问题： 声明了哪些外部连接器，但声明不等于可用，只有探测通过才标为可用。 CLAUDE.md 解决数据持久的问题：模板和用户配置物理分离，升级不丢数据， [PLACEHOLDER] 保证没有配置就不会输出错误结论。 SKILL.md （路由层）解决意图准确的问题： 用户的一句话，通过硬编码映射表找到对应的专项技能，可审计、可修复。 Anthropic 在这套设计里有一个反复出现的判断： 对于法律工作，系统应该把"确定地拒绝"作为比"不确定地回答"更优先的选择。 AI编造了一个"有来源"的虚假引用，不如直接报错。 插件没有配置就输出通用审查意见，不如拒绝工作，让用户先完成初始化。 路由逻辑让AI自由发挥偶尔出错，不如硬编码映射表，出了错能找到根因并修复。 四个文件，把这个判断编码进了插件运行的每一个层次。 你，学废了吗？ ## 往期相关内容回顾 [法律人的AI agent教程 合集](https://mp.weixin.qq.com/mp/appmsgalbum?__biz=MzI0NzUwMDUzMw==&action=getalbum&album_id=4453870239231082497#wechat_redirect) [法律人学Claude｜第一期：桌面版已经很好用了，为什么我还是力推 VSCode 插件版？](https://mp.weixin.qq.com/s?__biz=MzI0NzUwMDUzMw==&mid=2247483900&idx=1&sn=8ed3394ed1fde9b78e5f5b285dfd34a5&scene=21#wechat_redirect) [法律人学Claude｜第二期：半小时装好 VSCode + Claude Code](https://mp.weixin.qq.com/s?__biz=MzI0NzUwMDUzMw==&mid=2247483936&idx=1&sn=5a4ce57b245c80cee51253db8e605518&scene=21#wechat_redirect) [法律人学Claude｜第四期：你的项目助理—CLAUDE.md使用指南](https://mp.weixin.qq.com/s?__biz=MzI0NzUwMDUzMw==&mid=2247483973&idx=1&sn=a26555517c52d5f6cc8afa97ba0dd89e&scene=21#wechat_redirect) [法律人学Claude｜第九期：给自己定制一个审合同Skill——Skill详解](https://mp.weixin.qq.com/s?__biz=MzI0NzUwMDUzMw==&mid=2247484051&idx=1&sn=4d90b86f04b6efa4feb9c1eca7c82d21&scene=21#wechat_redirect) [法律人学Claude｜第十四期：法律检索报告实战](https://mp.weixin.qq.com/s?__biz=MzI0NzUwMDUzMw==&mid=2247484149&idx=1&sn=2bfac47ccf355c98cc03511e59b84d2d&scene=21#wechat_redirect)