PlanWright：为AI编码代理打造的控制平面

背景

AI 编程代理（coding agents）正在快速普及，开发者购买了大量代理工具，期望大幅提升生产效率。然而，实际体验中，编码本身早已不再是瓶颈——瓶颈转移到了代理无法自动化的环节：规划（Planning） 和 验收（Acceptance）。传统的流程中，人类仍然以 UI 速度手动编写任务，然后喂给快上千倍的机器；验收阶段，资深工程师逐条阅读 Pull Request，恰恰成为速度的杀手。PlanWright 试图用“控制平面”的思路，翻转这两个传统仪式，让规划和验收也以代理的速度运行。

核心内容

PlanWright 是一个面向 AI 编程代理的控制平面（control plane），定位为“代理劳动的编排层”。它解决了当前 AI 编程领域的核心矛盾：代理变快了，但流程没变。产品围绕三个原语（primitives）构建，最终目标是通过一个可审计、可溯源的状态机，让人类只做真正需要判断的决策。

问题被明确描述为“Amdahl's law”的实例

• 编码不再是瓶颈，现在约束来自未自动化的两端：规划（人类以 UI 速度手写任务）和验收（人工逐条审查 diff）。PlanWright 称之为“速度移到中间，把繁文缛节留在了后面”。
• 如果不解决这两端的“仪式”，即使 Agent 快 10 倍，整体速度仍被天花板限制。

解决方案：翻转两个仪式

1. 翻转规划：混乱输入 → 结构化目标输出
   传统的规划输入（会议纪要、幻灯片、邮件、Slack 消息）并不整洁。PlanWright 在 Claude Desktop（通过 MCP 协议）中，将这些原始信号综合成结构化目标（objectives），并附带机器可检查的验收标准。人类不再手写任务，而是用自然语言描述想要的结果，由代理起草计划，人类批准意图即可——“以描述想要什么的速度完成规划”。

2. 翻转验收：分类筛选，而不是淹没在审查中
   当目标完成后，PlanWright 自动拾取并在 Claude Cowork（协作空间）中分类验收：将纯机械性的标准（plain, mechanical criteria）自动清除，只把需要判断的关键条目路由给人类。机器不做最终接受，它只做分类。人类停止逐条阅读 diff，只裁决真正需要人类判断的事项。每一次裁决都带有签名（cryptographically signed）。

验收门（Acceptance Gate）状态机

PlanWright 定义了一个四个状态的状态机：

• 人类设定目标并调度给代理领取。
• 代理认领工作、规划、编码，并通过 MCP 记录 diff。
• 代理请求验收。人类审查 diff、测试并签署批准。
• 人类批准后，审计记录被密封并形成哈希链。

每一次状态转换都产生一个哈希链（hash-chained）、加密签名的审计记录。该链可在公共信任页面上独立验证。

工作原理：三个原语

1. 将混乱转化为目标：在 Claude Desktop 中，PlanWright 综合议题、幻灯片、邮件、Slack 信息，生成结构化的目标和机器可检查的验收标准。人类批准意图，而不是手动编写任务。
2. 分类验收：目标完成后，PlanWright 自动处理机械性标准，只将需要判断的条目路由给人类。机器不做接受，只做分类。
3. 每次裁决都签名：机器加速的吞吐量仍可问责：每个人类决策都是哈希链记录，而不是临时的 PR 阅读。

看板（Board）与工作流

PlanWright 提供了一个看板界面，目标（objectives）在其中流动，代理执行，人类审批。示例目标包括：添加 webhook 重试逻辑、迁移认证到 PKCE 流程、实现 ECDSA P-256 审计签名、为工作区添加 RLS 策略、为 MCP 服务器添加 SSE 传输、数据库 schema v1。

五步工作流：零忙琐事

1. 编写目标：描述你想要的结果，而不是步骤或实现细节。
2. 代理通过 MCP 认领：Claude Code 连接到 PlanWright 看板，拾取已调度的目标开始工作。
3. 代理规划、执行、请求验收：代理分解目标、写代码、跑测试，将目标移到验收通道（每一步记录在审计链中）。
4. 人类审查和签署：每次验收都是一个加密签名，不是复选框，是绑定你身份的真正批准。
5. 每一步都哈希链化并签名：从目标创建到最终合并，不可变更的审计线索——SOC 2 证据自动生成。

合规（SOC 2）

2026 年信任服务标准（Trust Services Criteria）日益要求对 AI 驱动的变更提供不可篡改、防伪证据的审计轨迹和文档化的变更审批控制。PlanWright 将哈希链（ECDSA P-256 签名）作为核心原语提供，从第一个目标到最终合并。这正是 SOC 2 审计师寻找的变更审批控制点。

入门方式

• 一条命令：claude mcp add planwright --transport http https://mcp.planwright.tools/mcp
  浏览器打开 GitHub 登录后即完成连接，无需配置 token 或文件。静态 token 可通过设置生成（用于 CI 或服务账户）。
• 零配置。

定价方案

• Free：最多 3 席位、1 个项目、30 天审计保留、社区支持，适合个人开发者试用代理原生规划。
• Team：4–10 席位、无限项目、1 年审计保留、公共信任页、GitHub App 集成，适合每天用代理交付的小团队。
• Business：11–50 席位、3 年审计保留、自定义域名信任页、优先支持、高级分析，适合需要开箱即用合规的团队。
• Enterprise：51+ 席位、7 年审计保留、SSO/SAML（路线图）、SOC 2 attestation letter（路线图）、专属支持、自定义集成，适合有监管要求的组织。

所有方案均包含 MCP 服务器、审计链和看板。

关键要点

• 核心洞察：AI 编程代理带来的是局部加速，整体瓶颈从编码转向规划与验收两个人类环节，符合 Amdahl's law。
• 翻转规划：将人类手写任务改为自然语言描述意图，由代理起草计划，人类只需审批意图。
• 翻转验收：机器自动处理机械性验收标准，只将关键判断路由给人类；机器不做接受，只做分类。
• 验收门状态机：定义明确的状态（目标设置→代理工作→请求验收→人类签名），每一次状态转换产生哈希链签名审计记录。
• 合规内置：SOC 2 审计证据自动生成，满足 2026 年信任服务标准对 AI 变更的要求，使用 ECDSA P-256 加密签名。
• 零配置接入：一条命令即可集成到 Claude Desktop/Code，通过 MCP 协议建立连接。
• 定价分层：从免费单人方案到企业级合规方案，通过席位和审计保留时长区分。
• 不可篡改审计链：每个目标和每次人类裁决都记录在公共可验证的哈希链中，提供“不信任文字，信任链”的透明性。

意义与影响

PlanWright 代表了一种将流程控制基础设施引入 AI 代理工作流的趋势。当前多数开发者工具仍停留在“代理写代码+人类审查”的简单循环中，而 PlanWright 将代理视为一种需要编排和审计的“劳动力”，并为其构建了专门的控制平面。这至少带来三方面影响：

1. 效率与安全的平衡：代理的劳动可以无限快，但通过加密签名的状态机，人类仅需在关键节点给出判断，既释放了速度，又保留了必要的安全与合规控制。对于需要 SOC 2 等审计要求的组织，这种“自动生成审计证据”的能力可能成为标配。

2. 工作流范式的转变：从“人类写任务给机器”变为“人类描述意图，机器起草任务，人类审批意图”。这种反转减少了从想法到代码的“摩擦”，将人类注意力从“如何分解任务”提升到“想要什么结果