NMFS Agents

基于 Claude CLI 的 AI 多角色自动化系统。30+ Agent 协作完成代码修复、板端测试、 成熟度评估、架构整合、市场洞察与基础技术调研。

组织架构

Boss（战略决策，周报）
│
├── 基础技术部（os-base-leader）
│   ├── 架构设计   base-architect   — 平台架构整合，跨组技术决策
│   ├── 架构验证   base-validator   — 基准测试，架构方案验证
│   ├── 硬件工程   hw-engineer      — 硬件选型，功耗/算力权衡
│   ├── OS 系统    os-engineer      — 内核参数，驱动框架
│   ├── 内核开发   dev-kernel       — 驱动开发，DTS/BSP
│   ├── 底层开发   dev-lowlevel     — 嵌入式固件，硬件 bring-up
│   ├── 系统测试   system-tester    — 集成测试，端到端验证
│   ├── 算法专项
│   │   ├── algo-antishake   防抖算法（IMU/滤波/卡尔曼）
│   │   ├── algo-position    定位算法（UWB/BLE/视觉）
│   │   └── algo-nav         导航算法（路径规划/避障）
│   ├── 技术调研（有独立专项记忆 __research__.*）
│   │   ├── rtp-researcher   — RTP/RTCP 实时传输协议
│   │   ├── net-researcher   — 网络栈优化
│   │   └── kernel-analyzer  — 内核调度分析
│   └── 平台扩展
│       ├── nrf-dev    — nRF54L15 / BLE 5.4 / Zephyr（运动健康）
│       └── esp32-dev  — ESP32S3 / mmWave（适老辅助）
│
├── 市场洞察部（market-leader）
│   ├── market-pm      — 市场分析（通用）
│   ├── market-sport   — 运动健康专项
│   ├── market-elder   — 适老辅助专项
│   └── market-safety  — AI 安全专项
│
├── 项目交付部
│   ├── architect      — 跨项目架构分析
│   ├── developer      — 代码修复/重构
│   ├── tester         — 本地 pytest + 板端 SSH 测试
│   ├── planner        — 差距分析，洞察任务规划
│   ├── productizer    — 成熟度评估（100分制）
│   ├── vision-analyst — 视觉效果分析
│   └── media-producer — 技术内容生产
│
└── Ops（独立运营，星形枢纽）
    ├── OpsAgent  — 每日巡检，项目健康评分
    └── OpsHub    — EventBus 事件消费 → 日报写入

人员矩阵

角色	所属组	队列	memory	设备
base-architect	基础技术	base_opt	W/W	─
base-validator	基础技术	base_opt	R/W	rk3566/rk3588
hw-engineer	基础技术	base_opt	R/W	─
os-engineer	基础技术	base_opt	R/W	rk3566/rk3588
dev-kernel	基础技术	base_opt	R/W	rk3566/rk3588
dev-lowlevel	基础技术	base_opt	R/W	rk3566/rk3588
system-tester	基础技术	base_opt	R/W	rk3566/rk3588
algo-antishake	基础技术	base_opt	R/W	rk3566
algo-position	基础技术	base_opt	R/W	rk3566
algo-nav	基础技术	base_opt	R/W	rk3566
rtp-researcher	基础技术	project_delivery	R/W	─
net-researcher	基础技术	project_delivery	R/W	─
kernel-analyzer	基础技术	project_delivery	R/W	─
nrf-dev	基础技术	project_delivery	R/W	─
esp32-dev	基础技术	project_delivery	R/W	─
architect	项目交付	project_delivery	W/W	─
developer	项目交付	project_delivery	R/R	─
tester	项目交付	project_delivery	R/R	rk3566/rk3588
planner	产品洞察	insight	R/W	─
productizer	产品洞察	insight	W/W	─
market-pm	市场洞察	insight	R/W	─
market-sport	市场洞察	insight	R/W	─
market-elder	市场洞察	insight	R/W	─
market-safety	市场洞察	insight	R/W	─
vision-analyst	产品洞察	insight	R/W	rk3566/rk3588
media-producer	产品洞察	insight	R/R	─
boss	管理层	project_delivery	R/W	─
os-base-leader	管理层	project_delivery	R/W	─
senior-dev	管理层	project_delivery	R/W	─
ops	独立运营	project_delivery	R/W	─

memory 格式：goals/facts（W=可写 R=只读）| 设备：rk3566=192.168.123.183，rk3588=192.168.123.137

快速开始

python3.10 -m venv venv && source venv/bin/activate
pip install -e ".[dev]"
claude login                        # CLI OAuth 认证
bash scripts/start_daemon.sh        # 启动多队列调度器
python scripts/run.py status        # 查看任务状态

工作原理

┌─ Web Dashboard（http://localhost:9080）──────────────────────────────────┐
│  提交需求         →  project_delivery 队列  →  developer/architect      │
│  技术攻关         →  base_opt 队列          →  专项研究 Agent           │
│  触发市场洞察     →  insight 队列           →  market-*/planner         │
│  查看日报         →  /api/daily/*           →  时间线 + Boss 决策视图   │
└──────────────────────────────────────────────────────────────────────────┘

┌─ APScheduler（定时自动）────────────────────────────────────────────────┐
│  Scanner 扫描 → 自动入对应队列 | Boss 周报 | Ops 巡检 | 调研/算法轮次  │
└──────────────────────────────────────────────────────────────────────────┘

                         ↓ 三队列并发执行 + EventBus 事件广播

project_delivery（tasks.db）  ─> developer / architect / tester / boss / ops
base_opt（base_opt_tasks.db） ─> 算法 / 调研 / 硬件优化 Agent
insight（insight_tasks.db）   ─> market-* / planner / productizer

                         ↓ EventBus（Redis Streams）→ OpsHub → DailyReport

任务完成/失败 → publish_task_done/failed → 5 consumer groups 消费
Ops 日报自动聚合 → Dashboard 日报 Tab 展示

执行模式

模式	行为	飞书审批
auto	直接修复 + 运行测试	结果摘要推送
confirm	每步写操作需 claude-wx hook 审批	飞书卡片逐一确认
report	只读分析，不修改文件	报告摘要推送

文档

• DEVELOP.md — 开发指南、架构、添加新 Agent/项目
• RELEASE.md — 变更日志