Weave：面向 AI 编程代理的图工作流任务追踪系统

Weave是专为AI编码代理设计的基于图的工作流管理系统，原作者/维护者为AGM1968，来源平台为GitHub，原始链接：https://github.com/AGM1968/weave，发布时间：2026-06-04。其核心特点包括：通过显式图遍历替代传统向量检索，使用SQLite和tmpfs实现高效Token优化任务追踪，支持多代理集成和语义化任务关系管理，旨在解决传统任务工具缺乏复杂关系表达、RAG系统难以捕捉显式依赖等问题。

随着GitHub Copilot、Claude Code等AI编程助手普及，任务流程与上下文管理成为新挑战。传统工具将任务视为孤立条目，缺乏复杂关系表达能力；RAG系统依赖隐式向量相似性，难以捕捉任务间显式依赖和逻辑关联。Weave设计理念：采用图结构建模任务与工作流，通过8种语义边类型表达任务关系；以Token效率为核心，通过上下文包机制减少LLM交互的Token消耗。

图数据模型

使用SQLite+tmpfs实现高性能内存级访问，每个代码仓库拥有独立图数据库，节点代表任务/决策等实体，边编码8种语义关系（如implements、blocks、depends_on等）。

Token优化检索

通过显式图遍历获取相关上下文，结合BM25+余弦相似度的RRF融合进行本地混合搜索，避免无关内容占用上下文窗口。

代码搜索能力

内置代码搜索功能，使用RRF融合在本地索引源代码，支持函数定义、调用点查询，与图节点搜索互补。

• 仓库初始化：wv init-repo生成配置，创建.weave目录，设置Git钩子关联任务提交。
• 任务生命周期：wv add（创建）、wv work（认领）、wv done（完成）管理任务，含唯一Weave ID与学习点记录。
• 任务层次：wv link创建语义边，wv tree可视化层级，支持史诗级任务分解。
• 上下文恢复：wv bootstrap --json提供会话快照，替代git status+wv status获取工作状态。

• Claude Code：通过hooks和skills文件集成，预提交钩子确保代码提交与任务关联。
• VS Code Copilot：提供MCP服务器，通过.vscode/mcp.json配置注入工具定义，Copilot可直接查询操作任务。
• 统一工作流：不同代理间共享任务状态、学习点与上下文，无缝切换工具不丢失信息。

• 学习点捕获：任务完成时通过--learning记录关键洞察，形成组织知识库，避免重复问题。
• 影响分析：wv impact分析变更波及范围，计算受影响节点爆炸半径、风险评分等，助力重构风险评估。
• 语义查询：wv query支持基于属性（状态、边类型等）的查询，如查找被阻塞任务、核心任务等。

适用于复杂开发工作流的团队与个人：

• 长期项目维护：图结构保留任务历史关联，帮助新成员理解系统演进。
• 探索性开发：学习点捕获保存实验成果。
• 团队协作：统一任务视图减少沟通摩擦，wv ready查看可执行任务，wv context获取完整上下文。 对AI代理：解决上下文窗口管理难题，提升决策质量与一致性。

Weave是AI辅助编程工具链的演进方向，作为连接人类与AI代理的语义层，通过图结构显式编码工作流关系，使代理理解任务上下文与依赖。其Token优化设计体现对LLM交互成本的务实考量。未来，这类工作流基础设施将成为AI原生开发工具链的关键组件，管理人机协作边界与协议。