CLI
npm install -g instruction.md دون اتصال، ودون حساب
| الأمر | ما يفعله |
|---|---|
instruction validate <file> | يفحص مستندًا بقارئ المواصفة: كل مشكلة مع رقم سطرها ورمز ثابت. الأخطاء تُفشل الأمر (رمز الخروج 1)؛ أما التحذيرات، مثل ${name} لا يعرّفه شيء، فتُعرض ولا تُفشله، ومع --strict تُفشله هي أيضًا. السطر الذي ما زال مكتوبًا وفق المواصفة 1.1 يُعدّ خطأً |
instruction init <name> --template agent | مستند للبدء فيه قواعد وأسبابها، وشرط، وشخص يوافق، وشكل الرد، ومسرد |
instruction deliver <file> name=value | النص نفسه الذي يستلمه النموذج (instruction-text/1)، وتُقرأ أسسه ومضمَّناته من الملفات المجاورة له؛ و--resolved يطبع المستند بعد الحل (instruction-resolved/1) مع بصمته |
instruction fmt <file> --write | تنسيق متحفّظ: نهايات الأسطر، والسطر الجديد الأخير، والمسافات في آخر أسطر التوجيهات |
instruction tree <file> | شجرة المستند كما كُتب (instruction/1) بصيغة JSON |
instruction digest <file> | بصمة المستند كما كُتب: قيمة SHA-256 لبايتات الملف |
instruction render <file> --full | HTML لموقع ثابت |
instruction test <dir> | يشغّل اختبارات المطابقة الخاصة بالمواصفة، لقارئك أنت |
instruction eval <file> | يشغّل حالات :::eval في المستند مع Claude ببيانات اعتمادك أنت؛ و--dry-run يعرض ما كانت سترسله كل حالة ولا يستدعي أي نموذج |
مع السجل
هذه الأوامر تخاطب الخادم ببروتوكول MCP 2026-07-28، دون حالة: لا جلسة، وكل طلب قائم بذاته، أيًّا كانت نسخة الخادم التي تجيب عنه.
| الأمر | ما يفعله |
|---|---|
instruction login | تسجيل الدخول، في متصفحك؛ ويُحفظ تسجيل الدخول في مجلد الإعدادات لديك |
instruction login --device | تسجيل الدخول برمز على جهاز آخر، لجهاز ليس فيه متصفح (عبر SSH أو داخل حاوية) |
instruction list، get، pull | البحث والجلب |
instruction push <file> --publish | إنشاء مسودة أو تحديثها، ثم نشرها |
instruction publish <id> --tag v2 --refs latest,stable | نشر المسودة الحالية ونقل المراجع (refs) |
instruction refs <id> set stable <ver> | نقل مرجع، وهكذا يكون التراجع إلى إصدار سابق |
instruction diff <id> <from> <to> | الفروق بالصيغة الموحّدة وكتلةً كتلة |
instruction watch <uri> --out FILE | متابعة مرجع، مع الاحتفاظ بآخر إصدار سليم |
instruction connect --host claude-code <uri> --with-hooks --write | جعل تعليمة تعليماتِ مشروع في Claude Code أو Codex (--host codex، Codex؛ بالإنجليزية): ملف الربط والخطافات |
instruction hook claude-code، hook codex | ما تشغّله تلك الخطافات: التعليمة عند بدء الجلسة، والإصدار الجديد مع الطلب التالي |
instruction sync <uri> --as claude-skill | التعليمة وكيلًا فرعيًا أو مهارة في Claude Code، أو مهارة في Codex (claude-agent، codex-skill) |
instruction connect --managed claude-code <uri> | الإعدادات التي تضعها على كل جهاز في المؤسسة (الوكلاء المُدارون، بالإنجليزية) |
instruction audit export <id> --format csv | سجل التدقيق، دون المحتوى أبدًا |
instruction revoke <id> <ver> | سحب إصدار؛ ويبقى المستهلكون على ما لديهم |
تسجيل الدخول
instruction login يفتح متصفحك على صفحة تسجيل الدخول في instruction.md. سجّل الدخول، ووافق على ما
يطلبه سطر الأوامر، فيعرض المتصفح «تم تسجيل دخولك»: عُد إلى الطرفية. يسلّم متصفحك تسجيل الدخول إلى الأمر على
حاسوبك أنت فقط (عنوان على 127.0.0.1، مفتوح لهذا التسجيل وحده)، ويثبت الأمر أنه هو من بدأ تسجيل
الدخول (PKCE)، فيُرفض أي تسجيل دخول ينتهي في مكان آخر. وإذا لم يعد شيء خلال 5 دقائق يتوقف الأمر ويخبرك بذلك.
في حالة instruction.md لا يسجّل الأمر الدخول إلا على صفحة تسجيل الدخول الخاصة بموقع instruction.md، وفي حالة خادم
تسمّيه بالخيار --url لا يسجّل الدخول إلا على صفحة تقع على عنوان ذلك الخادم نفسه. الخادم الذي يسمّي
صفحة تسجيل دخول تخص جهة أخرى قد يستولي على تسجيل دخولك، ولذلك يُرفض؛ والخيار --issuer يتجاوز ذلك
بعد أن يسألك (أو مع --trust-issuer حيث لا توجد طرفية يُسأل فيها)، غير أن تسجيل الدخول الخاص بموقع
instruction.md لا يُستخدم أبدًا لخادم آخر. يُفحص كل رمز وصول (token) للتأكد من أنه صادر عن خدمة تسجيل الدخول
التي جاء منها وأنه موجَّه إلى الخادم الذي يُرسل إليه: فتسجيل الدخول في instruction.md يتجاهل المعامل
resource من RFC 8707 الذي يرسله الأمر، وهذا الفحص إذن هو ما يربط الرمز بالخادم.
لا يوجد متصفح على الجهاز، كما في اتصال SSH أو داخل حاوية؟ يطبع الأمر الرابط ويقترح
instruction login --device: فيعرض رمزًا قصيرًا ورابطًا تفتحه على أي جهاز، ومنه هاتفك.
يبقى الرمز صالحًا 5 دقائق.
إدارة مؤسسة (إضافة مفاتيح الناشر أو تبديلها، وإنشاء الوكلاء أو إبطالهم، وسجل التدقيق) تحتاج إلى إذن إضافي.
instruction login --admin يطلبه من البداية؛ وإلا فإن أول أمر يحتاج إليه يسألك في الطرفية ثم يسجّل
دخولك من جديد مع هذا الإذن. ومن دون طرفية لا يغيّر شيئًا ويطلب منك تشغيل instruction login --admin
(الخيار --yes لا يبدأ تسجيل دخول)، ويُرفض تسجيل الدخول بحساب آخر.
في CI
عيّن INSTRUCTION_MD_TOKEN لرمز وصول غير تفاعلي واستخدم --json لمخرجات تقرؤها الآلة.
رموز الخروج: 1 خطأ، 2 استخدام غير صحيح، 3 مشكلة في النقل أو لم يتم تسجيل الدخول، 4 غير موجود، 5 ممنوع،
6 لم يُطبَّق شيء، 7 لم يُؤكَّد.
jobs:
publish:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with: { node-version: 22 }
- run: npm i -g instruction.md
- run: instruction validate RUNBOOK.md
- run: instruction push RUNBOOK.md --to ${{ vars.INSTRUCTION_ID }} --publish --yes --message "${{ github.sha }}" --json
env:
INSTRUCTION_MD_URL: https://instruction.md/mcp
INSTRUCTION_MD_TOKEN: ${{ secrets.INSTRUCTION_MD_TOKEN }}
أضف --sign-with key.json للنشر بمفتاحك الخاص بدلًا من مفتاح المنصة.
انظر التوقيع والثقة.