Nguyên tắc thiết kế phần mềm robot
Skill giúp thiết kế và review module phần mềm robot theo SOLID, ràng buộc real-time và mặc định an toàn.
Lập trìnhTrung cấp★ 366⑂ 47Điểm AI 8/10Cập nhật lần cuối: 12 thg 8, 2026
Skill này làm được gì
- Trình bày 12 nguyên tắc thiết kế dành riêng cho phần mềm robot (đơn nhiệm, đảo ngược phụ thuộc, đóng-mở, phân tách interface, Liskov, tách tần số, mặc định an toàn, cấu hình hóa, idempotent, khả năng quan sát, khả năng kết hợp, suy giảm mềm) kèm ví dụ Python xấu/tốt.
- Đưa ra mẫu abstraction như
ArmInterface,CameraInterfaceđể cùng một code chạy được trên mô phỏng và robot thật. - Cung cấp bảng tần số khuyến nghị cho từng thành phần (vòng điều khiển 1000Hz đến quản lý task 0.1Hz) và mẫu thread/buffer để perception không chặn vòng điều khiển.
- Có bảng checklist theo từng nguyên tắc dùng trực tiếp khi review code.
Phù hợp với ai
- Lập trình viên Python làm việc với ROS2, MuJoCo, UR5/Franka hoặc stack robot tương tự.
- Nhóm nghiên cứu muốn dùng chung một codebase cho cả mô phỏng và phần cứng thật (sim-to-real).
- Tech lead cần thiết lập tiêu chuẩn refactor và review cho codebase robot.
Ví dụ sử dụng
- "Class
RobotControllercủa tôi gộp cả camera, planner và driver — hãy tách trách nhiệm." → Gợi ý tách thành module perception/planning/execution. - "Thêm nhà cung cấp gripper mới phải sửa code lõi." → Đề xuất kiến trúc plugin đăng ký và interface nhỏ gọn.
- "Vòng điều khiển không giữ được 100Hz." → Áp dụng mẫu đưa perception sang thread riêng và đọc giá trị mới nhất qua buffer.
· · · Hướng dẫn cài đặt · · ·
Dùng thử ngay, không cần cài
Dán đoạn dưới vào Claude là dùng được skill này mà không cần cài đặt.
Hãy đọc hướng dẫn trong tệp này và làm theo để giúp mình: https://raw.githubusercontent.com/arpitg1304/robotics-agent-skills/HEAD/skills/robotics-software-principles/SKILL.md Mình muốn: (viết việc bạn cần ở đây)
Nếu Claude không mở được liên kết, hãy mở liên kết và copy nội dung vào rồi dán.
↓ Thấy hữu ích thì tải ZIP bên dưới và cài. Sau đó skill tự chạy, không phải dán lại mỗi lần.
Cài vào ứng dụng Claude (không cần terminal)
- Tải tệp ZIP bằng nút bên dưới.
- Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
- Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.
Cài vào Claude Code
Để Claude làm — dán câu dưới đây vào Claude Code
Hãy cài skill mình tìm thấy trên Claude Skill Mart. Copy thư mục skills/robotics-software-principles từ repo GitHub arpitg1304/robotics-agent-skills vào ~/.claude/skills/robotics-software-principles/ của mình. Sau khi cài xong, cho mình biết skill này làm được gì trong một câu.
Cài bằng lệnh thủ công
git clone https://github.com/arpitg1304/robotics-agent-skills.git /tmp/robotics-agent-skills && mkdir -p ~/.claude/skills && cp -r /tmp/robotics-agent-skills/skills/robotics-software-principles ~/.claude/skills/⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.
- Mở terminal.
- Tải repo:
git clone https://github.com/arpitg1304/robotics-agent-skills.git - Tạo thư mục skill:
mkdir -p ~/.claude/skills - Sao chép skill:
cp -r robotics-agent-skills/skills/robotics-software-principles ~/.claude/skills/ - Khởi động lại Claude Code và kiểm tra
robotics-software-principlesxuất hiện trong danh sách skill. - Thử câu lệnh như "Review kiến trúc module robot của tôi theo nguyên tắc SOLID" để skill tự kích hoạt.
Xem mã nguồn trên GitHub ↗Giấy phép: Apache-2.0