cmuxcmux/docs

المهارات

يتضمن cmux مهارات تعلّم وكلاء البرمجة كيفية استخدام التحكم عبر cmux CLI، وأسطح المتصفح، ولوحات Markdown، ونوافذ التصحيح، وسير عمل الإصدار.

التثبيت

شغّل skills.sh لتثبيت المهارات الموجودة في المستودع داخل دليل مهارات Codex.

التثبيت من GitHub
curl -fsSL https://raw.githubusercontent.com/manaflow-ai/cmux/main/skills.sh | bash
افتراضيًا، يثبّت السكربت في ~/.codex/skills، أو في $CODEX_HOME/skills عند ضبط CODEX_HOME. مرّر --dest عندما يقرأ وكيلك المهارات من دليل آخر.

التثبيت من نسخة محلية

من نسخة cmux مستنسخة، يستخدم السكربت دليل المهارات المحلي.

الأوامر المحلية
./skills.sh
./skills.sh --list
./skills.sh --skill cmux --skill cmux-browser
./skills.sh --dest ~/.codex/skills
./skills.sh --dry-run

استخدم --ref للتثبيت من فرع أو وسم أو commit محدد عندما ينزّل السكربت من GitHub.

curl -fsSL https://raw.githubusercontent.com/manaflow-ai/cmux/main/skills.sh | bash -s -- --ref main

المهارات المضمنة

لكل مهارة ملف SKILL.md، ومراجع اختيارية، وملف بيانات وصفية خاص بـ OpenAI داخل agents/openai.yaml.

المهارةالاستخدامالأمر المعتاد
cmux Core
skills/cmux/SKILL.md

يتحكم في النوافذ، ومساحات العمل، واللوحات، والأسطح، والتركيز، والنقل، وإعادة الترتيب، والتوجيه عبر cmux CLI.

استخدمها عندما يحتاج الوكيل إلى تموضع أو تنقل حتمي داخل تخطيط cmux متعدد اللوحات.

cmux identify --json
cmux Browser
skills/cmux-browser/SKILL.md

يؤتمت أسطح webview في cmux باستخدام مراجع اللقطات، وإجراءات DOM، والانتظار، ولقطات الشاشة، وحالة الجلسة.

استخدمها لمهام المتصفح التي يجب أن تعمل داخل cmux بدل أداة أتمتة متصفح منفصلة.

cmux browser surface:2 snapshot --interactive
cmux Markdown Viewer
skills/cmux-markdown/SKILL.md

يفتح ملفات Markdown في لوحة cmux منسقة مع إعادة تحميل مباشرة.

استخدمها لعرض الخطط، والوثائق، والملاحظات، وقوائم المهام بجانب الطرفية أثناء العمل.

cmux markdown open plan.md
cmux Debug Windows
skills/cmux-debug-windows/SKILL.md

يدير Sidebar Debug، وBackground Debug، وMenu Bar Extra Debug، ولقطات التصحيح القابلة للنسخ.

استخدمها عند التكرار على واجهة نوافذ التصحيح أو جمع إعدادات التصحيح من بناء موسوم.

skills/cmux-debug-windows/scripts/debug_windows_snapshot.sh
cmux Release
skills/release/SKILL.md

يشغّل سير عمل إصدار cmux من اختيار الإصدار إلى سجل التغييرات، وPR الإصدار، والوسم، وفحوصات الآثار.

استخدمها للمشرفين الذين يجهزون إصدار cmux أو يطلقونه.

./scripts/bump-version.sh

قائمة المساعدة

تعكس قائمة Help في macOS هذا الشريط الجانبي للوثائق وتتضمن Skills. استخدم عنصر Skills في Help لفتح هذه الصفحة من التطبيق.

بنية المهارة

اجعل ملف SKILL.md الرئيسي موجزًا. ضع جداول الأوامر الأعمق، والسكربتات، والقوالب القابلة لإعادة الاستخدام بجانب المهارة.

skills/<name>/SKILL.md
skills/<name>/agents/openai.yaml
skills/<name>/references/*.md
skills/<name>/scripts/*
skills/<name>/templates/*
عند إضافة مهارة جديدة، أدرج agents/openai.yaml كي يعرض المثبّت اسمًا واضحًا، ووصفًا قصيرًا، وموجّهًا افتراضيًا.

وثائق ذات صلة