| name | taishan-rk3566 |
| description | Plan, implement, debug, and validate NUEDC-style computer-vision projects for the Lichuang Taishan RK3566 board. Use when a user needs to decompose a vision competition problem, choose between classical vision, geometry, tracking, or model inference, connect vision to GPIO/UART/gimbals or lower controllers, develop through VS Code Remote-SSH or another board-side Linux workflow, or produce a testable project and acceptance evidence. Do not use as a generic RK3566 Linux reference when the task has no competition-vision or board-integration context. |
泰山派 RK3566 电赛视觉 Skill
面向公开用户，把电赛视觉任务组织为“约束确认、方案选择、板端探测、最小验证、联调和验收”。摄像头、系统镜像、协议、模型和下位机均可替换；不把单届赛题或个人工程写成固定答案。
按需路由
只读取当前任务需要的资料：
- 来源、陌生题和研究边界：
references/source-index.md、references/nuedc-topic-coverage.md、references/research-guidance.md。
- 板端发现与真实基线：
references/board-and-runtime.md；运行 scripts/run_baseline.sh 或相关 scripts/probe_*，保存 JSON、stderr、命令、版本和退出码后才能称为实板基线。
- 视觉方案与工程：
references/vision-task-archetypes.md、references/robust-vision-control.md、references/architecture-patterns.md。
- 调试、部署和已有工程：
references/debugging-playbook.md、references/live-debugging-and-deployment.md、references/existing-project-integration.md。
- 证据与发布回归：
references/validation-and-evidence.md、references/validation-scenarios.md；RKNN 案例仅见 references/yolo-rknn-validated-case.md，不得泛化其配置和性能。
- 需求与决策模板：
templates/first-use-gate.md、templates/task-intake.md、templates/quick-check-intake.md、templates/solution-options.md、templates/existing-project-change.md、templates/serial-protocol-decision.md。
- 交付与调优模板：
templates/project-architecture.md、templates/acceptance-checklist.md、templates/debug-evidence.md、templates/hardware-evidence-record.md、templates/yolo-data-and-training.md、templates/performance-report.md、templates/perception-control-tuning.md。
门禁与硬规则
- 首次使用门禁按
templates/first-use-gate.md 建立“已确认事实、用户选择、合理假设、待验证”台账；结论只能是“通过、部分通过、阻塞”。部分通过只做列出的最小验证，阻塞只给缺口和低风险探测。
- 先确认题目、评分、误差、时限、场景、硬件、通信、执行机构、失败条件和安全约束。信息不足时不得确定设备号、引脚、协议、坐标、模型、性能或完整工程。
- 物理连接以官方原理图和 IO 表为准，运行时接口以当前镜像、内核、设备树和实板探测为准。不得从
GPIOx_y 猜 Linux 编号，不假设固定 /dev/video*、串口、摄像头后端或同一引脚同时复用；电源和 GND 不是 GPIO。
- 性能、帧率、延迟、精度、稳定时间和资源占用必须来自目标板实测；桌面结果、合成输入和历史个案不能替代当前环境，缺证据时写“待实测”。
- 传统视觉、几何和标定能满足约束时不引入模型；模型路线必须确认许可证、数据、类别、预处理、输入输出、Runtime/驱动和板端证据，并提供降级路线。
- 已有工程先读入口、配置、协议和测试，保留已确认接口，只做最小修改面；交付必须含原行为基线、回滚办法、原有行为回归和新功能最小验证，不得平行重写。
- 协议、ACK、心跳、频率、坐标单位、超时、丢失动作和安全动作都由用户材料或双方契约确定；高影响项确认前不直接生成完整闭环代码。
- MSPM0 或其他下位机已负责电机、巡迹和安全控制时保持边界；RK3566 默认负责视觉、坐标/误差和已确认接口。
- 闭环观测必须包含时间戳、有效性、质量和超时。过期观测不得驱动执行器；默认不得“继续上一帧动作”。激光、云台、电机和飞行器先低能量、限幅、急停或空载验证。
- 区分 Codex 当前工作区与 VS Code Remote-SSH 板端。没有远程终端权限时，只提供可复制命令、预期现象、失败含义和证据保存；收到真实输出后才能声称执行成功。
工作流
- 需求与分类：完整任务使用
templates/task-intake.md，低风险 API/单硬件检查使用 templates/quick-check-intake.md。区分相机观测、编码器/IMU/下位机反馈和控制目标；识别成功不等于定位或控制完成。
- 方案与接口：按
templates/solution-options.md 给出推荐路线、失败信号、最小验证和降级路线；只有真实取舍才列 2–3 个方案。通信决策使用 templates/serial-protocol-decision.md。
- 板端发现：基础项检查板卡、系统、内核、架构和开发入口；图像任务再查摄像头/OpenCV，涉及 UART/GPIO 才查对应能力，使用已有模型才查 RKNN。探针缺工具或失败时如实记录。
- 分阶段验证：依次完成单帧采集、单帧算法、坐标/标定或跟踪、独立通信/执行机构、低速低风险闭环和题目验收；每轮只改变一个主要变量。
- 联调与部署：沿“输入→视觉→坐标/状态→通信→执行→反馈”定位，分别证明电脑看到、程序输出、板端执行和评分达成。冻结活动入口、配置、协议、校验和和回滚点；服务 active 或单帧日志不等于端到端可用。
- 交付与证据：交付唯一入口、真实依赖、部署运行方法、配置、测试和验收记录。分开报告采集/处理/发布频率、端到端延迟、误差、连续运行时间和异常次数。
回答与发布边界
复杂任务依次报告：门禁结论；四类台账；任务分类与路线；坐标、标定、状态和接口；最小验证、证据与失败判据；降级路线；门禁通过后的工程；验收与待实测项。低风险问题只回答必要探测、预期现象、失败排查、证据保存和下一步。
修改首次门禁、题型或核心工作流后执行 R1、R2、R3；模型路线执行 R4；鲁棒识别/闭环执行 R5、R7；现场部署执行 R6。出现假设冒充事实、漏读已有工程、无数据却承诺模型、过期观测驱动执行器、误判设备状态、破坏现有链路或无实测却宣称达标时，不能发布该版本。
公开内容不得包含本地路径、账号、密钥、令牌、未授权模型、私有数据集或个人信息；区分官方事实、公开案例、用户经验和待验证结论，不复制其他平台专属 API。
