TaskNest 任务巢开源项目

TaskNest（任务巢）是一个本地运行的软件开发 Agent 工作台，采用“主 Agent 规划加子 Agent 执行”的两层架构，把 AI 辅助开发从单轮对话扩展为可审核、可回溯的工程化流程。

核心模块包括：规划会话模块，主 Agent 读取仓库后生成 Markdown 计划表，含糊处通过 waiting_input 弹出选项与自由输入框，支持反复修订，确认后才进入执行；两层任务管理模块，一个主任务下挂直属子任务，主任务与子任务使用独立状态机和数据库表，互不干扰；受控工具模块，提供目录查询、文件查找、文件读取与写入、本地 Shell、ask_user 等工具，所有文件操作严格限制在 Git 仓库根目录内；Git 分支隔离模块，主任务分支下每个子任务再开独立临时分支，成功以 no-ff 方式合并，退回或失败删除子分支，整体失败回滚主任务分支，冲突保留现场；审核与测试模块，平台先在子任务分支上执行测试，再由只读审核 Agent 输出结构化结论，测试失败或产生副作用强制返工；动态重排模块，主 Agent 可在子任务边界调整未开始的 PENDING 任务，计划版本号随之递增；可观测与历史档案模块，包含 SSE 事件、事件账本、提示词版本、工具调用配对、审核面板、Git 时间线，以及 MySQL 持久化的历史档案只读回放；本地设置模块，LLM 连接与审核策略写入 MySQL，启动自动加载，保存后即时生效。

主要功能是让 AI Agent 在受控的 Git 环境中完成真实软件开发任务：先规划、后执行，每一步的思考增量、工具调用、审核结论和 Git 检查点均完整可见；子任务之间通过分支隔离，失败可回滚、冲突可追溯；审核 Agent 独立把关，测试不通过即返工；历史任务的全链路记录可随时回放复盘。