nvwa-ai
v0.1.0
Published
Nvwa (女娲) - AI Team Creator & Runner. Build, run, and evolve AI project teams.
Maintainers
Readme
Nvwa (女娲)
AI 团队的项目结果交付平台
女娲造人,Nvwa 造 AI Team。
Nvwa 帮助你组建专业化的 AI 团队来推进复杂项目、交付业务结果。不是又一个编码助手——是一个能自我迭代、朝目标持续推进的 AI 项目团队。
核心理念
结果导向,而非交付物导向。 Nvwa 的目标不是"把代码写完",而是交付你定义的业务结果。
- AI 员工,不是 Agent — 每个团队成员有独立的身份、记忆、知识、执行能力,在项目中持续成长
- 深度无限,宽度固定 — AI 员工纯纵向深挖,做过 50 个项目的后端开发,领域经验超越任何人类
- 不限于编码 — 开发、调研、数据分析、运维、内容生产,任何可分解的工作
- 自驱团队 — AI 项目经理驱动迭代循环,对照目标持续推进,人只需要定方向
特性
- 智能建团 — 描述项目需求,自动生成定制化 AI 团队(或从历史项目克隆成熟员工)
- PM 驱动迭代 — AI 项目经理分解任务、调度执行、验收结果,最多 5 轮自主迭代
- 四大元角色 — 项目经理管事 + 人力总监管人 + 效能总监管能力 + 领域专家管知识
- 经验积累 — 每次任务执行后自动沉淀经验,团队越用越强
- 跨项目传承 — 通过克隆(全量复制)和学习(选择性导入)传递经验
- 飞书协作 — AI 团队在飞书群中汇报进展、接受指导,人类随时可介入
- Claude Code 驱动 — 通过 Claude Code SDK/CLI 实际执行工作
- 团队复盘 — HR 总监自动复盘团队与项目表现,提炼经验技能,优化 Prompt(需审批)
快速开始
# 安装
npm install -g nvwa-ai
# 在你的项目中初始化 AI Team
cd your-project
nvwa init
# 执行任务
nvwa start "给项目添加用户认证功能"
# 查看团队状态
nvwa status
# 复盘团队表现
nvwa evolveCLI 命令
| 命令 | 说明 |
|------|------|
| nvwa init | 初始化 AI 团队(交互式 + AI 建团) |
| nvwa start "<任务>" | 执行任务(团队协作完成) |
| nvwa status | 查看团队和项目状态 |
| nvwa team | 查看团队成员详情 |
| nvwa history | 查看任务执行历史 |
| nvwa memory [agent] | 查看经验记录 |
| nvwa evolve [agent] | 复盘团队表现(HR 总监分析) |
架构
人(老板/PM)
│ 设定目标、提供资源、审批关键决策
│
├── AI 项目经理 — 管事
│ 任务分解 → 调度执行 → 进度追踪 → 结果验收
│
├── AI 人力总监 — 管人
│ 建团配人 → 绩效复盘 → Prompt 优化 → 团队调整
│
├── AI 效能总监 — 管能力
│ 工具调研 → 工具开发 → 技能沉淀 → 流程自动化
│
└── AI 领域专家 — 管知识(按项目领域动态创建)
知识管理 → 领域咨询 → 规则校验技术架构
飞书群聊 → Feishu Gateway (WebSocket + 消息解析)
→ Team Architect (建团)
→ Team Orchestrator (任务分解 + DAG 拓扑调度)
→ Agent Runtime (Claude Code SDK / CLI 双执行器)
→ Memory Store (经验记录 + 关键词检索 + 技能库)
→ Evolution Engine (HR 复盘 + 数据触发)AI 员工模型
每个 AI 员工由五个要素构成:
| 要素 | 本质 | 说明 | |------|------|------| | Identity | 身份 | 角色定义、工作风格、执行流程 | | Memory | 记忆 | 项目经验、成功失败教训、积累技能 | | Knowledge | 知识 | 领域文档、技术栈、最佳实践 | | Context | 上下文 | 当前项目目标、任务、协作关系 | | Executor | 执行体 | LLM、工具链、MCP servers |
.nvwa/ 目录
your-project/
└── .nvwa/
├── config.json # 项目配置
├── project-context.md # 项目目标(所有员工共享的北极星)
├── team-topology.json # 团队拓扑(角色、权限、依赖)
├── agents/ # 员工 Identity(Prompt 文件)
├── memory/ # 员工 Memory(经验记录)
├── skills/ # 可复用技能库
└── history/ # 任务执行历史文档
| 文档 | 内容 | |------|------| | 核心理念 | AI 员工模型、元角色体系、协作模型、失败哲学 | | 总体架构 | 六层架构、9 要素框架、进化机制、路线图 | | 执行层设计 | SDK/CLI 双模式、权限映射 | | 编排层设计 | DAG 调度、状态机 | | 记忆层设计 | 经验存储、关键词检索 | | HR 复盘设计 | 复盘、触发机制、审批流程 |
技术栈
- TypeScript (strict mode) + Node.js ≥ 20, ESM
- @anthropic-ai/claude-agent-sdk — Agent SDK 执行器
- @larksuiteoapi/node-sdk — 飞书 WebSocket 接入
- Vitest — 测试框架
- ESLint 9 + typescript-eslint 8 — 代码规范
开发
npm install # 安装依赖
npm run dev # 开发模式
npm run build # 编译
npm test # 运行测试
npm run lint # 代码检查
npm run typecheck # 类型检查