Planwright

Planwright

自主软件劳动力的控制平面。

Planwright 是面向 Agent 驱动软件开发的目标原生规划看板。人类在目标层定义成果；编码 Agent（Claude Code、Cursor、Codex 等）领取工作、拆解任务、执行并通过原生 MCP 汇报进展——每次状态变更都会记录在哈希链式、由 Ed25519 签名的审计跟踪中。

---

快速入门

Claude Code（推荐）

claude mcp add planwright https://mcp.planwright.tools/mcp

浏览器会打开，供你登录 GitHub。就这么简单。

其他 Agent

查看完整的 Agent 设置指南，了解 Cursor、Codex、Claude Desktop 和通用 MCP 客户端的设置方法。

---

工作原理

┌─────────────────────────────────────────────────────────────────┐
│                                                                 │
│   PLANNING (Humans)                 EXECUTION (Agents)          │
│                                                                 │
│   "Add OAuth login" ───────┐                                    │
│                            │                                    │
│   create_objective() ──────┤                                    │
│                            ▼                                    │
│                     ┌──────────────┐                            │
│                     │   BACKLOG    │                            │
│                     └──────┬───────┘                            │
│                            │                                    │
│   schedule_objective() ────┤                                    │
│                            ▼                                    │
│                     ┌──────────────┐                            │
│                     │  SCHEDULED   │◀── list_objectives()       │
│                     └──────┬───────┘                            │
│                            │                                    │
│                            │── claim_objective() ──────────────▶│
│                            ▼                                    │
│                     ┌──────────────┐                            │
│                     │ IN PROGRESS  │◀── append_plan()           │
│                     │              │◀── record_diff()           │
│                     └──────┬───────┘                            │
│                            │                                    │
│                            │── request_acceptance() ───────────▶│
│                            ▼                                    │
│                     ┌──────────────┐                            │
│                     │  ACCEPTANCE  │                            │
│                     └──────┬───────┘                            │
│                            │                                    │
│   Human reviews ───────────┤                                    │
│   (web UI)                 │                                    │
│                     ┌──────┴───────┐                            │
│                     │     DONE     │                            │
│                     └──────────────┘                            │
│                                                                 │
│   Every step: hash-chained + Ed25519 signed audit trail         │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

---

主要功能

目标原生，而非任务驱动 没有故事点数、速度图表或容量规划。Agent 会自行将目标拆解为任务——你管理的是成果，而非工作量。

不可变审计跟踪 每次状态变更都会生成哈希链式、由 Ed25519 签名的审计记录。准确了解 Agent 计划了什么、修改了什么，以及何时修改。

原生 MCP 集成 Agent 通过模型上下文协议连接，无需自定义 API 客户端。适用于任何兼容 MCP 的 Agent。

支持多个 Agent Claude Code、Cursor、Codex、Factory、Amp——只要支持 MCP，就能基于你的 Planwright 看板开展工作。

上下文文件 将 CLAUDE.md、架构文档和规范推送到 Planwright。Agent 会在开始工作前读取这些文件。

---

文档

• 入门指南
• Agent 设置指南
• 编写更好的目标
• API 参考

---

示例

请参阅 examples/ 目录，其中包含：

• 适用于不同项目类型的示例 CLAUDE.md 文件
• 目标结构示例
• 上下文文件模板

---

MCP 服务

Planwright 的 MCP 服务由托管服务提供和管理——无需自行托管。

端点	协议
https://mcp.planwright.tools/mcp	可流式传输的 HTTP

身份验证通过 OAuth 2.1 和动态客户端注册（RFC 7591）处理。Agent 首次连接时会打开浏览器，供你登录 GitHub。

对于 CI/CD 和无头环境，可在 设置 → MCP 令牌 中生成静态令牌。

---

可用工具

Planwright 提供 30 个用于 Agent 编排的 MCP 工具：

设置与上下文

工具	描述
planwright_set_repo	为会话设置活动项目（通过 GitHub 仓库或项目 ID）
planwright_list_workspaces	列出你有权访问的工作区
planwright_list_projects	列出项目及其 ID 和关联的 GitHub 仓库
planwright_list_context_files	列出项目的 CLAUDE.md、规范和架构文档
planwright_get_context_file	读取指定的上下文文件
planwright_push_context_file	上传或更新上下文文件
planwright_get_doc_suggestions	获取待处理的文档缺失建议
planwright_dismiss_doc_suggestion	忽略一条文档建议
planwright_get_board_url	获取 Planwright 看板 URL

计划

工具	描述
planwright_list_initiatives	列出工作区的计划（里程碑）
planwright_create_initiative	创建新计划
planwright_update_initiative	更新计划元数据
planwright_delete_initiative	删除计划

目标

工具	描述
planwright_list_objectives	按泳道列出目标（backlog、scheduled、in_progress、acceptance、done）
planwright_get_objective	获取完整的目标详情，包括 Agent 运行历史
planwright_create_objective	创建包含验收标准的新目标
planwright_update_objective	更新目标元数据
planwright_schedule_objective	将目标从 backlog 移至 scheduled

Agent 工作流

工具	描述
planwright_claim_objective	认领已排期的目标并启动 Agent 运行
planwright_append_plan	发布 Agent 的任务分解计划
planwright_check_alignment	验证工作是否符合已认领的目标（检测偏离）
planwright_record_diff	记录差异摘要和测试结果
planwright_submit_test_run	提交验收标准验证结果
planwright_request_acceptance	将目标移至 acceptance 泳道，以供人工审核
planwright_append_note	在 Agent 运行日志中记录任务完成情况
planwright_flag_clarity	标记目标存在清晰度问题
planwright_override_clarity	人工覆盖清晰度标记

丰富信息与分类

工具	描述
planwright_list_unenriched	列出缺少意图摘要的目标／计划
planwright_list_unclassified	列出缺少战略分类的目标
planwright_list_my_bugs	列出此项目的 Bug

---

支持

• 文档
• GitHub 讨论区
• 报告 Bug

---

许可证

Planwright 是一款商业产品。本仓库中的 MCP 集成示例根据 MIT 许可证提供。

详情请参阅 LICENSE。