Rockchip Agents

基于 Claude CLI 的 AI 项目自动化维护与调研系统，运行在 RK3588 NPU 开发平台上。 支持代码修复、板端测试、成熟度评估、架构整合、市场洞察与基础技术调研。

组织架构

AI 自动化平台
│
├── 基础技术组（base_opt + project_delivery 队列）
│   ├── 架构设计   base-architect   — 平台架构整合，跨组技术决策
│   ├── 架构验证   base-validator   — 基准测试，架构方案验证
│   ├── 硬件工程   hw-engineer      — 硬件选型，功耗/算力权衡
│   ├── OS 系统    os-engineer      — 内核参数，驱动框架
│   ├── 内核开发   dev-kernel       — 驱动开发，DTS/BSP
│   ├── 底层开发   dev-lowlevel     — 嵌入式固件，硬件 bring-up
│   ├── 系统测试   system-tester    — 集成测试，端到端验证
│   ├── 算法专项
│   │   ├── algo-antishake   防抖算法（IMU/滤波/卡尔曼）
│   │   ├── algo-position    定位算法（GNSS/视觉里程计）
│   │   └── algo-nav         导航算法（路径规划/避障）
│   └── 技术专项（架构师/高级研发，有独立专项记忆）
│       ├── rtp-researcher   — RTP/RTCP 实时传输协议（__research__.rtp.*）
│       ├── net-researcher   — 网络栈优化调研（__research__.net.*）
│       └── kernel-analyzer  — 内核调度分析（__research__.kernel.*）
│
├── 项目交付组（project_delivery 队列，1h 扫描）
│   ├── architect   — 跨项目架构分析，技术债识别
│   ├── developer   — 代码修复/重构（含 dev-refactor/dev-embedded）
│   └── tester      — 本地 pytest + 板端 SSH 测试
│
└── 产品洞察组（insight 队列，6h 扫描）
    ├── planner       — 差距分析，洞察任务规划
    ├── productizer   — 成熟度评估（100分制，规则引擎）
    ├── market-pm     — 市场分析，竞品调研，众筹追踪
    ├── vision-analyst   — 视觉效果分析，截图回归
    └── media-producer   — 技术内容生产

人员矩阵

角色	所属组	队列	memory goals	memory facts	设备访问	主要项目
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	OS 调优
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-base
algo-position	基础技术	base_opt	R	W	rk3566（默认）	algo-base
algo-nav	基础技术	base_opt	R	W	rk3566（默认）	algo-base
rtp-researcher	基础技术	project_delivery	R	W	─	rtp-research
net-researcher	基础技术	project_delivery	R	W	─	net-research
kernel-analyzer	基础技术	project_delivery	R	W	─	kernel-analysis
architect	项目交付	project_delivery	W	W	─	全项目
developer	项目交付	project_delivery	R	R	─	全项目
tester	项目交付	project_delivery	R	R	rk3566/rk3588	全项目
planner	产品洞察	insight	R	W	─	insight
productizer	产品洞察	insight	W	W	─	全项目
market-pm	产品洞察	insight	R	W	─	市场调研
vision-analyst	产品洞察	insight	R	W	rk3566/rk3588	视觉验证
media-producer	产品洞察	insight	R	R	─	内容输出

W=可写 R=只读 ─=不访问 | 设备栏：rk3566=192.168.123.183，rk3588=192.168.123.181

托管项目

项目	路径	模式	主要负责组
yolo	/data/company/yolo	confirm	项目交付
mediapipe	/data/company/mediapipe	auto	项目交付
embedding	/data/company/embedding	report	项目交付
info-privacy	/data/company/info-privacy	confirm	项目交付
logodetect-x86	/data/company/logodetect-x86	auto	项目交付
rtp-research	/data/company/os-base/rtp-research	auto	调研
net-research	/data/company/os-base/net-research	auto	调研
kernel-analysis	/data/company/os-base/kernel-analysis	auto	调研
claude-wx	/data/company/claude-wx	auto	项目交付
ui-tars	/data/company/ui-tars	auto	基础技术

快速开始

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        # 查看任务状态

工作原理

APScheduler（多队列，1h/4h/6h）
  └─> Scanner 扫描项目（README 已知问题 / TODO / CLAUDE.md 标记）
        └─> TaskQueue 入队（SQLite，去重，优先级排序）
              └─> Executor 并发分发（asyncio Semaphore 限流）
                    └─> Agent.run(task) → claude --print 子进程

执行模式

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

文档

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