الصفحة الإنجليزية أحدث من هذه الترجمة. اقرأها بالإنجليزية

CLI

Shell
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> --fullHTML لموقع ثابت
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 لم يُؤكَّد.

GitHub Actions
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 للنشر بمفتاحك الخاص بدلًا من مفتاح المنصة. انظر التوقيع والثقة.