GaosCode/PlanWeave

PlanWeave – 面向代码代理的文件后端循环工程平台

是什么 – PlanWeave 是一个基于 TypeScript/Node.js 的工具（CLI + Electron 桌面应用），可将模糊的开发目标转化为结构化的文件后端任务图。每个节点（文件）包含 块（单个工作单元）。这些块由专用 AI 代理（Codex、Claude Code、OpenCode、Pi、Grok 或本地脚本）认领、执行、审查，并将结果与源文件一同存储。整个循环（规划、实现、审查、恢复）均可恢复且可观测。

为何重要 – 基于聊天的提示适合启动计划，但对长期工程而言脆弱。通过将计划作为仓库的一等公民（文件 = 节点，块 = 文档），PlanWeave 将状态、历史和依赖关系保留在项目内部，从而实现：

• 独立块的并行工作
• 自动将每个块路由到最合适的代理
• 结构化审查反馈，可反馈至实现
• 持久的运行日志、工件和指标，供后续检查
• 多用户协作和远程代理执行

核心概念

概念	角色
包 / 画布	存储在仓库中的普通文件中的 PlanWeave 顶层项目。
任务图	通过依赖关系链接的节点（文件）；每个节点包含一个或多个 块。
块	可认领的工作单元（例如：“实现函数 X”）。
执行者配置文件	描述应由哪个 AI 模型或本地命令处理一个块（例如 codex-acp）。
代理技能	执行特定操作的小型可重用代理（plan-maker、plan-runner、plan-reviewer 等）。
MCP 服务器	本地 HTTP 隧道，允许外部 LLM（ChatGPT、Claude 等）调用 PlanWeave 的 API 来创建或修改计划。

主要功能

• 文件后端图 – 计划直接存在于您的工作区中，而非独立数据库。
• 零配置启动 – 安装 CLI（npm i -g @planweave-ai/cli）和几个技能包，然后运行 planweave 命令即可。
• 按块代理路由 – 为每个块选择最合适的 LLM 或确定性脚本。
• 自动运行模式 – 持续认领就绪的块，调用执行者，收集报告，并将审查结果反馈。
• 桌面画布 – 可视化编辑任务、块、依赖关系和运行状态（Electron 应用）。
• 完整审计追踪 – 每次运行都会将提示、stdout、stderr、结构化报告和元数据存储在工作区下。
• 协作 – 共享项目，支持成员邀请、任务分配、评论和远程代理主机。
• MCP 集成 – 暴露本地隧道，使 ChatGPT（或其他 Web-LLM）可通过 HTTP 驱动 PlanWeave。
• 统计与搜索 – 在不离开工具的情况下查看效率指标、搜索块并查看待办事项列表。

典型工作流

1. 创建 / 导入计划 – 通过 plan-maker 或 plan-importer 技能让 LLM 从高层次目标或现有文档生成一个包状草稿。
2. 验证并导入 – 运行 planweave package-draft validate … 和 planweave package import … 将计划在您的仓库中实体化。
3. 运行计划 – 调用 plan-coordinator 技能（或直接运行 planweave run …）。协调器认领块，调度 plan-runner 实现，plan-reviewer 审查，并在需要时使用 plan-recovery。
4. 检查并迭代 – 使用 CLI 命令（planweave status、planweave graph inspect、planweave doctor）或桌面 UI 查看进度、查看日志并调整图结构。
5. 协作 – 邀请团队成员，分配块，并通过代理主机功能在远程设备上运行代理。

快速开始

# 安装 CLI（npm 或 Homebrew）
npm install -g @planweave-ai/cli
# 或
brew install GaosCode/tap/planweave

# 安装捆绑的代理技能
npx skills@latest add GaosCode/PlanWeave

# 验证安装
planweave --help

• 如需视觉体验，请从仓库的发布页面下载 Electron 应用。
• 要启用 ChatGPT 驱动的规划，请启动 MCP 服务器（planweave mcp tunnel …），并在 ChatGPT 的工具设置中添加隧道。

适合谁使用

• 希望使用 AI 辅助代码生成但需要可复现、可审计运行的开发者。
• 需要多个 AI 代理并行工作的大型代码库团队。
• 正在实验“循环工程”（提示 → 执行 → 审查 → 优化）的研究人员。
• 任何需要持久化、文件后端表示的多步骤 AI 工作流的人。

许可证 – MIT（参见 LICENSE）。

---

以上所有细节均直接来自仓库的 README；未推断任何额外功能。