Agent Dev Thai Academyprinciples · patterns · architecture

synchro

CLI เล็กๆ สำรอง skill ของ agent ลง git และ sync skill ระหว่าง Claude, Codex, Factory

agent-dev-thai/synchro บน GitHub ↗★ 1Pythonอัปเดต กรกฎาคม 2026Claude CodeCodexAntigravity

synchro อ่านโฟลเดอร์ skill ของแต่ละ tool (Codex กับ Antigravity ใช้ ~/.agents/skills ร่วมกัน, Claude ใช้ ~/.claude/skills, และ Factory/Droid) แล้ว audit ว่าตรงกันไหม backup ลง git repo ที่ใช้เป็น vault แล้วเอาไป restore บนอีกเครื่องได้

ทุกคำสั่งเป็น dry-run ก่อน ต้องใส่ --apply ถึงจะเขียนจริง ไม่ push และไม่ copy .env ไฟล์ credential หรือ .git เข้า vault ถ้า skill ปลายทางมีอยู่แล้วแต่ไม่เหมือนกัน มันจะรายงานเป็น conflict แล้วข้าม จะทับได้ต้องใส่ --force และมันจะเก็บสำเนาไว้ใน ~/.synchro/backups ก่อน

เริ่มใช้

  1. ต้องมี Python 3.11 ขึ้นไป ติดตั้งจากโฟลเดอร์ที่ clone มา แล้วเช็คว่าเจอ root ครบ

    python3 -m pip install .
synchro doctor

  2. ดูว่า skill แต่ละที่ต่างกันตรงไหน

    python3 -m synchro audit

  3. backup ลง vault แล้ว commit (ไม่ push)

    python3 -m synchro backup --repo ~/agent-skill-vault --apply --commit -m "backup skills"

  4. sync skill ที่ยังไม่มีจากที่หนึ่งไปอีกที่ (ไม่ใส่ --apply คือแค่ดูผล)

    python3 -m synchro sync --from codex --to claude

ข้างในมีอะไร 5

  • synchro/cli.py

    คำสั่งทั้งหมด audit, backup, restore, sync, migrate-codex, doctor

  • bin/synchro

    ตัวรันจาก source ไม่ต้อง pip install

  • ~/.synchro/config.json

    ลงทะเบียนโฟลเดอร์ skill อื่นเพิ่ม แล้วใช้ชื่อนั้นกับทุกคำสั่งได้

  • migrate-codex

    ย้าย skill จาก ~/.codex/skills ที่เป็นที่เก่าไป ~/.agents/skills โดย snapshot ไว้ก่อน

  • tests/test_synchro.py

    test ชุดหลัก รันด้วย python3 -m unittest -v

ช่วยเรื่องไหนบนกระดาน 1

บทความที่พูดถึง 1