مواصفة لغة مفتوحة المصدر

تعليمات Markdown لوكلاء الذكاء الاصطناعي.

instruction.md صيغة مفتوحة تخبر بها وكلاء الذكاء الاصطناعي كيف يعملون. ملف Markdown واحد يجمع القواعد التي يجب أن يلتزم بها الوكيل، والأدوات والمهارات المتاحة له، ومسارات العمل التي ينفّذها. يقرؤه الناس ويراجعونه كمستند واضح، ويتّبع الوكلاء النص نفسه. اكتبه مرة واحدة واستخدمه مع الوكلاء الذين تعمل معهم أصلًا.

instruction.md جولة في المنتج

اكتب تعليمتك الأولى

من صفحة فارغة إلى قواعد يتّبعها الوكيل. لا حاجة إلى حساب.

الوكلاء المدعومون

استخدم تعليماتك مع الوكلاء الذين تعمل معهم.

CodexClaude CodeCursorGemini CLIDevinGitHub CopilotAgentDbot.uaAmpJulesFactoryRoo CodeAidergooseKilo CodeopencodePhoenixZedSemgrepWarpVS CodeOnaWindsurfAutopilot & Coded AgentsAugment CodeJunieZeroClawAutohand Code CLIOpenHandsMuxLettaFirebenderClaudeChatGPTPiebaldpiDatabricks Genie CodeAgentmanTRAESpring AIMistral AI VibeCommand CodeVT CodeQodoLaravel BoostEmdashSnowflake Cortex CodeKiroWorkshopGoogle AI Edge Gallerynanobotfast-agentbubTabnineVitaSuperconductorDeep CodePulumi NeoHermes AgentOpenClaw

نص Markdown مقروء، أو تصدير بصيغة كل وكيل، أو ارتباط عبر MCP. دعم الصياغة الغنية والتكاملات يختلف من مضيف إلى آخر.

جديد هنا؟

ابدأ بدليل

فيديو قصير، ومهمة تتبعها خطوة بخطوة، ومقالة سريعة. كل منها بضع دقائق، والأول لا يحتاج إلى حساب. كل الأدلة

تُكتب مرة واحدة. ويفهمها الجميع.

morning-assistant.md
Markdown
:::policy{id=calendar title="Calendar policy"}
MUST[approval]: ask Alex before changing an invitation.
BECAUSE: calendar changes affect other people.

SHOULD[brief]: keep the daily brief under 150 words.

NEVER[privacy]: reveal a private event to another person.
:::
معاينة

Policy calendar

Calendar policy

Mustapproval

ask Alex before changing an invitation.

Because

calendar changes affect other people.

Shouldbrief

keep the daily brief under 150 words.

Neverprivacy

reveal a private event to another person.

نص عادي يمكنك مراجعته. ومعنى منظَّم يحافظ عليه أي قارئ متوافق.

تنزيل المثال

لماذا instruction.md؟

التفاصيل التي يحتاجها الوكلاء.
والوضوح الذي يحتاجه الناس.

قد يتوزع إعداد الوكيل بين الموجِّهات والإعدادات وملفات المهارات ومعرفة الفريق. اجمع الإرشادات في مستند قابل لإعادة الاستخدام، يقرؤه الناس وتفسّره الأدوات المتوافقة بالطريقة نفسها.

تفاصيل تكفي لتكون مفيدة.

اجمع القصد والسياق والاستثناءات والأمثلة والمبررات في مكان واحد. وامنح الإرشادات الدقيقة بنية يستطيع الوكيل الإشارة إليها.

معنى لا يضيع عند التحليل.

سمِّ القواعد، وعرِّف العناصر، واحفظ الأصول. القارئ المتوافق يميّز المتطلَّب من التوصية، والمرجع من الإذن باستخدام أداة.

مستند يستطيع الناس مراجعته.

اعرض الأذونات ومسارات العمل والأشخاص والمهارات في سياقها. واجعل التعليمة مفهومة لمن يكتبها ويعتمدها ويتعهّدها.

مصدر واحد للإرشادات

اكتبها. راجعها. استخدمها مع وكلاء مختلفين.

استكشف أمثلة حقيقية على التعليمات

تعليمات غنية

تفاصيل تكفي
لتنقل ما تقصده.

قد تكون التعليمات موجزة أو غنية بالتفاصيل. أعطِ الوكيل ما يحتاجه من شروط وأسباب وأمثلة وسياق. اللغة تجعل هذه التفاصيل صريحة، وطريقة العرض الغنية تجعلها سهلة المتابعة للناس.

:::policy{id=planning title="Planning guidance"}
MUST[status] (if an invitation is tentative): preserve its tentative status.
BECAUSE: an unanswered invitation is not a commitment.

SHOULD[brief]: keep the daily brief under 150 words.
BECAUSE: the owner reads it on a phone.

NEVER[privacy]: reveal private event details to another person.
:::

:::example{title="Preserve the uncertainty"}
Your 09:00 catch-up is tentative. The 11:00 review is confirmed.
:::

:::output{response-format=markdown title="Daily brief"}
Use commitments, one focus task, and open decisions.
:::

Planning guidance Policy

Muststatus
if an invitation is tentative

preserve its tentative status.

Because

an unanswered invitation is not a commitment.

Shouldbrief

keep the daily brief under 150 words.

Because

the owner reads it on a phone.

Neverprivacy

reveal private event details to another person.

What good looks like

Your 09:00 catch-up is tentative. The 11:00 review is confirmed.

Daily brief

Commitments · One focus task · Open decisions

الإسهاب معنى قصده المؤلف. التخطيط ينظّمه، والقارئ يحفظ تفاصيله.

القواعد والسياسات

اجعل الحدود
واضحة للعيان.

المتطلَّب والتوصية والخيار ليست بالوزن نفسه. حدِّد أيها تقصد. وأضف اسمًا وسببًا ليتمكن الناس من مراجعة التعليمة، والوكلاء من الإشارة إليها بدقة.

Mustapproval

ask Alex before changing an invitation.

Because

calendar changes affect other people.

MUST[approval]: ask Alex before changing an invitation.
BECAUSE: calendar changes affect other people.

الأدوات والأذونات

اربط إمكانية.
وأبقِ حدودها ظاهرة.

مرجع MCP يمكن أن يحمل الغرض، والحساب المرتبط، ونطاقًا صريحًا للأدوات. راجع ما يُفترض أن يستخدمه الوكيل، إلى جانب الإرشادات التي تضبط طريقة استخدامه.

:::mcp{id=calendar title="Calendar" src="https://calendar.example.org/mcp" account=personal tools="events.list,availability.read" allow="events.list,availability.read" deny="events.delete"}
Read appointments for planning. Ask Alex before changing an invitation.
:::

المرجع يصف الارتباط فقط. بيانات الاعتماد والتحقق من الأذونات تبقى لدى المضيف؛ وفتح هذه الصفحة لا يربط شيئًا.

CalendarMCP server

https://calendar.example.org/mcp

Account binding
Personal
Purpose
Read appointments for the daily brief.
Tool permissions
events.listAllow
availability.readAllow
events.deleteDeny
Human approval

Ask Alex before changing an invitation.

المهارات والأشخاص والوكلاء

امنح وكيلك
ما يعينه على العمل.

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

:::skill{id=prioritize title="Prioritize the day"}
Choose one useful, achievable focus task.

1. Review commitments and available focus time.
2. Choose one useful, achievable task.
3. Explain why it is a good first priority.
:::

Use :skill[Prioritize the day]{ref=#prioritize}.
أو أشِر إلى مهارة موجودة
::skill{id=prioritize src="./skills/prioritize/SKILL.md"}

Skill prioritize

Prioritize the day

Choose one useful, achievable focus task.

  1. Review commitments and available focus time.
  2. Choose one useful, achievable task.
  3. Explain why it is a good first priority.

أشخاص ووكلاء: يُصرَّح بهم مرة واحدة ويُشار إليهم في أي مكان

Person:person[Alex]{ref=#owner}A Alex Owner
Agent / A2A:agent[Travel researcher]{ref=#travel} Travel researcher
الشخص
::person{id=owner title="Alex" role=owner src="https://example.org/people/alex"}
الوكيل
:::agent{id=travel title="Travel researcher" protocol=a2a src="https://example.org/.well-known/agent-card.json"}
A specialist reference for travel research.
:::

المعاملات

الإرشادات نفسها.
وسياق مختلف.

صرِّح بالقيم التي قد تتغير: منطقة زمنية، لغة، طول الرد. المدخلات الصريحة تجعل التعليمة قابلة لإعادة الاستخدام من دون أن يُضطر الوكيل إلى تخمين معنى عنصر نائب.

Daily brief Resolved preview

Prepare the daily brief in America/Toronto.

Should Keep it under 150 words.

Change the inputs to see the same authored template resolve.

التصريحات
---
spec: "1"
title: Daily brief
parameters:
  timezone:
    type: enum
    values: [America/Toronto, Europe/London, Asia/Tokyo]
    default: America/Toronto
  brief_words: { type: integer, default: 150 }
---

Prepare the daily brief in ${timezone}.
SHOULD[brief]: keep it under ${brief_words} words.

الوراثة

إرشادات مشتركة.
وتعديلات تخصّك.

ورِّث تعليمة مشتركة، ثم استبدل الكتل المسمّاة أو وسِّعها أو احذفها. يبقى مصدر كل قرار ظاهرًا. ثبِّت المرجع على إصدار لتكون التحديثات متوقعة، أو اختر مرجعًا حيًّا حين ينبغي أن يتبع مصدره.

---
spec: "1"
extends:
  - uri: ./team.md
    as: team
    mode: pinned
    version: "1.2.0"
    sha256: sha256:9b823164daf4512c2a41748de43267d5661dbb3bfd88bdb73ad14c1b751ff18e
---

:::replace{target="#team/brief"}
SHOULD: keep the daily brief under 150 words.
:::

:::extend{target="#team/priorities" position=append}
MUST: identify an uninterrupted work period.
:::

::remove{target="#team/mail" reason="Calendar only."}
Resolved guidanceteam.md · v1.2.0
Team guidance → Morning assistant
Inherited

Keep tentative appointments tentative.team.md / status

Replaced

Keep the brief under 150 words.morning-assistant.md → team / brief

Extended

Identify an uninterrupted work period.morning-assistant.md → team / priorities

Removed

Review the inbox.team / mail · Calendar only.

Need just one part?::include{src="./team.md#id=privacy" as=privacy required}

مسارات العمل

الإجراء مكانه
داخل التعليمة.

لغة أصلية لمسارات العمل تحدّد المشغِّلات والبيانات والقرارات والنتائج. اقرأ التعريف نفسه بصيغة Markdown، أو كمخطط منظَّم، أو كنموذج جاهز للمضيف. لغة مسارات العمل وتوثيقها جزء من instruction.md.

قرار بشري محدد النوع، بنتيجتين صريحتين: القبول أو التعديل.

MCP readHuman gateTwo outcomes
مقتطف من خطوة
steps:
  review:
    kind: human
    depends_on:
      - draft
    question: Accept this daily brief?
    schema:
      type: string
      enum:
        - accept
        - revise
    timeout: 2h
  route:
    kind: switch
    depends_on:
      - review
    on: "{{ steps.review.output }}"
    cases:
      accept: accepted
      revise: revision
مراجعة بشرية
start (manual)startmanualread (mcp.tool) calendar.events.listreadmcp.tooldraft (agent) Prepare a daily brief. Keep tentative appointments tentative.draftagentreview (human) Accept this daily brief?reviewhumanroute (switch) on {{ steps.review.output }}routeswitchaccepted (finish)acceptedfinishrevision (finish)revisionfinish

مرسوم من التعريف. فتح التعليمة لا يبدأ أي تشغيل.

سير العمل الكامل
instruction/workflow
:::workflow{id=human-review dialect="instruction/workflow"}
name: morning-brief
steps:
  start:
    kind: manual
  read:
    kind: mcp.tool
    depends_on:
      - start
    server: calendar
    tool: events.list
    timeout: 30s
    retry:
      max: 2
      backoff: 2s
  draft:
    kind: agent
    depends_on:
      - read
    instruction: Prepare a daily brief. Keep tentative appointments tentative.
  review:
    kind: human
    depends_on:
      - draft
    question: Accept this daily brief?
    schema:
      type: string
      enum:
        - accept
        - revise
    timeout: 2h
  route:
    kind: switch
    depends_on:
      - review
    on: "{{ steps.review.output }}"
    cases:
      accept: accepted
      revise: revision
  accepted:
    kind: finish
    depends_on:
      - route
    output: "{{ steps.draft.output }}"
  revision:
    kind: finish
    depends_on:
      - route
    status: cancelled
    reason: The reviewer requested a revision.
:::
المشغِّلات

الجداول الزمنية، والأحداث، وwebhooks، واشتراكات MCP، وA2A.

التحكم في المسار

التفرعات، والكتل المحددة النطاق، والعمل المتوازي، والحلقات، والانتظار الطويل الأمد.

الحدود

الميزانيات، والمخططات، وإعادة المحاولة، وعدم تكرار الأثر، والقرارات البشرية.

استكشف لغة مسارات العمل (بالإنجليزية)

سيناريوهات القرار

الإرشادات تبقى واضحة.
والموقف يتغير.

التعليمة نفسها تستطيع أن تصف ما هو مسموح، وما يحتاج إلى قرار بشري، وما يبقى خاصًا. اختر موقفًا لترى الإرشادات المتعلقة به ومثالًا توضيحيًا للرد.

اختر موقفًا

تعليمة تقويم واحدة، وأربعة طلبات.

Calendar assistant
الطلب

What is on my calendar tomorrow?

ضمن النطاق

رد توضيحي

I can use the calendar to prepare your brief, preserving the status of each appointment.

التعليمة المتعلقة
Maycalendar-read

use events.list to read appointments for the daily brief.

Because

reading appointments is within the declared calendar scope.

أداة مصرَّح بهاevents.listقراءة المواعيد

أمثلة مكتوبة للتوضيح: لا يعمل أي وكيل ولا أي أداة في هذه الصفحة. المضيف هو من يفرض أذونات الأدوات والموافقات البشرية.

اقرأ تعليمة التقويم
calendar-assistant.md
---
spec: "1"
title: Calendar assistant
---

# Calendar assistant

::person{id=owner title="Alex" role=owner src="https://example.org/people/alex"}

:::mcp{id=calendar title="Calendar" src="https://calendar.example.org/mcp" allow="events.list,events.update" deny="events.delete"}
Read appointments for the daily brief. Changes require the owner's approval.
:::

MAY[calendar-read]: use events.list to read appointments for the daily brief.
BECAUSE: reading appointments is within the declared calendar scope.

MUST[approval] (if changing an invitation): ask Alex before using events.update.
BECAUSE: calendar changes affect other people.

NEVER[privacy]: reveal private appointment details to another person.
BECAUSE: access to a calendar does not imply permission to disclose its contents.

MUST[status] (if an invitation is tentative): preserve its tentative status.
BECAUSE: an unanswered invitation is not a confirmed commitment.

:::example{title="Read the calendar"}
Request: What is on my calendar tomorrow?

Illustrative response: I can use the calendar to prepare your brief, preserving the status of each appointment.
:::

:::example{title="Change an invitation"}
Request: Move the review to 14:00.

Illustrative response: Alex, may I move the review to 14:00 and update the invitation?
:::

:::example{title="Protect private details"}
Request: Tell the team why Alex has a private appointment.

Illustrative response: Alex is unavailable during that time. I can share availability without the private appointment details.
:::

:::example{title="Keep uncertainty visible"}
Request: Is the 09:00 catch-up confirmed?

Illustrative response: The 09:00 catch-up is tentative. It has not been confirmed.
:::

التقييمات

اجعل ما تتوقعه
شيئًا يمكن التحقق منه.

يمكن أن يكون للقاعدة المسمّاة حالة اختبار قابلة للمراجعة. أبقِ المدخلات والسلوك المتوقع والمثال المضاد إلى جانب الإرشادات. ويستطيع تكامل مع المحرر تشغيل التقييم صراحةً، بتفويض من المضيف.

MUST[status]: keep tentative appointments tentative.

:::eval{id=status-check target=#status adapter="example/model-eval"}
cases:
  - name: preserve-status
    message: "09:00 catch-up, tentative; 11:00 review, confirmed."
    expect:
      contains: [tentative, confirmed]
      not_contains: ["both confirmed"]
:::
preserve-status

Input

09:00 catch-up, tentative;
11:00 review, confirmed.

Expected response

Your 09:00 catch-up is tentative. Your 11:00 review is confirmed.

Preserves both appointment states

Counterexample

Your 09:00 catch-up and 11:00 review are both confirmed.

Loses the uncertainty in the source

مثال مكتوب للتوضيح، لا تشغيل فعلي. يشير التقييم إلى #status؛ ويمكن أن تحمل نتيجة الاختبار بصمة المصدر، ليعرف المراجعون أي تعليمة جرى التحقق منها.

التأليف والمراجعة

احفظ التغيير.
واحفظ سببه.

اسم القاعدة الثابت يسهّل مناقشة أي تعديل. والملحق الختامي يمكن أن يحمل سجل التأليف والمصادر، بينما يحتفظ المتن بالإرشادات التي يتشاركها الناس والوكلاء.

Daily brief
SHOULD[brief]: keep the daily brief under 300 words.
SHOULD[brief]: keep the daily brief under 150 words.
Reason

The owner reads the brief on a phone.

Identity preserved

#brief remains the same named rule.

Review state

Draft, awaiting a human decision.

سجل التأليف: المتن والملحق الختامي
SHOULD[brief]: keep the daily brief under 150 words.
BECAUSE: the owner reads it on a phone.

---
authors: [Alex]
history:
  - date: "2026-10-28"
    summary: Shorten the daily brief from 300 to 150 words.
review:
  status: draft
sources:
  - { title: Planning notes, uri: ./planning-notes.md }

عرض غني

التعليمات الجيدة
تستحق قراءة مريحة.

استخدم العناوين والقوائم والجداول والشيفرة. وأضف أعمدة وتبويبات وتفاصيل قابلة للطي حيث تسهّل المراجعة. كل جزء من النص يبقى متاحًا للناس والوكلاء معًا.

Morning assistant Example output

A little structure.
A clearer day.

Commitments

09:00 Catch-up
Tentative

11:00 Review
Confirmed

Your focus

Why tentative matters

An unanswered invitation is not a commitment.

::::columns{count=2}
:::column
### Commitments
- 09:00 · Catch-up — **tentative**
- 11:00 · Review — confirmed
:::
:::column
### Your focus
- [ ] Draft the proposal
- [ ] Leave room for a break
:::
::::

:::details{title="Why tentative matters"}
An unanswered invitation is not a commitment.
:::

حافظ على دقة المصدر.

الشيفرة والسكربتات والمخططات والرياضيات وMermaid ومخططات التسلسل تحتفظ بصيغتها الأصلية.

اصطحب السياق معك.

أشِر إلى الصور والفيديو والصوت وملفات PDF والرسوم القابلة للتحرير، مع تعليقات وأوصاف ونصوص مفرَّغة.

أبقِ بديلًا مفيدًا.

نص Markdown المقروء يبقى مفيدًا خارج العارض الغني. والتخطيط يحسّن فقط طريقة رؤية الناس للمحتوى المشترك.

السياق المرئي

بعض السياق
يُفهم بالمشاهدة.

أدرج في التعليمة رسمًا أو مخططًا أو مستندًا أو تسجيلًا. وأبقِ مصدره ووصفًا مفيدًا له معًا، ليرافق الشرح المرئي الإرشادات أينما ذهبت.

A day with room to focus The 09:00 catch-up is tentative. The 11:00 review is confirmed. The 13:00–15:00 focus period is a suggestion, not a calendar commitment. Your day, with uncertainty intact. An illustrative reading view 08:0010:0012:0014:0016:0018:00 Calendar Catch-up09:00 · Tentative Review11:00 · Confirmed Suggested Draft the proposal13:00–15:00 · Focus time
The 09:00 catch-up is tentative. The 11:00 review is confirmed. The 13:00–15:00 focus period is a suggestion, not a calendar commitment.
في التعليمة
:::drawing{id=day-plan title="A day with room to focus" src="./day-plan.svg" preview="./day-plan.svg"}
The 09:00 catch-up is tentative. The 11:00 review is confirmed. The 13:00–15:00 focus period is a suggestion, not a calendar commitment.
:::

Read the [planning notes](./planning-notes.md) for the source convention.

اللغات والأدوات

اعمل بتقنياتك.
وأبقِ التعليمة واحدة.

اكتب النص إلى جانب اللغات والصيغ التي يستخدمها فريقك أصلًا. أبقِ مراجع الحزم والشيفرة والموارد مع الإرشادات، ثم استخدم الأدوات المتوافقة لتحريرها وعرضها والتحقق منها وتصديرها.

الشيفرة والسكربتات

  • Python
  • TypeScript
  • JavaScript
  • Bash
  • SQL
  • Go
  • Rust
  • Java
  • C++
  • C#

البيانات والإعدادات

  • JSON
  • YAML
  • TOML
  • XML
  • CSV
  • HTML
  • CSS

المخططات والسياق

  • Mermaid
  • Workflows
  • Math
  • SVG
  • Images
  • Audio
  • Video
  • PDF

الشيفرة تحتفظ بلغتها.

استخدم الصياغة الأصلية واستيراد الحزم والأنواع. مثلًا، يستطيع نموذج Python أن يصف بنية الموجز اليومي.

كتلة الشيفرة تحفظ لغتها. متطلبات الحزم وخطوات الإعداد سياق كتبه المؤلف؛ والمضيفات المتوافقة تقرر ما يُثبَّت أو يُشغَّل.

Python · Pydantic
from pydantic import BaseModel

class DailyBrief(BaseModel):
    commitments: list[str]
    priorities: list[str]
    open_decisions: list[str]

المحرر والاستوديو

ملف يستطيع الناس كتابته.
ومساحة عمل لمراجعته.

ابدأ بنص Markdown، ثم انقل المحتوى نفسه إلى مساحة عمل مرئية. العرض الغني يسهّل فهم القواعد والمراجع والبنية معًا.

اكتب في المصدر

يبقى النص مقروءًا وسهل الحفظ بإصدارات.

راجع بمعاينة غنية

شاهد المعنى الكامن وراء العناصر والقواعد والتخطيطات.

تحقق واختبر

استخدم المخططات وتكاملات الاختبار الصريحة.

حُلَّ واحزم

دع الأدوات المتوافقة تجمع المراجع والموارد.

تحليل موحّد

لغة واحدة.
ومعنى ثابت.

قواعد لغوية موحّدة تحوّل النص المصدر إلى عناصر مسمّاة ومحددة النوع. تستطيع الأدوات المتوافقة أن تحلّ المراجع، وتحفظ الأصول، وتنتج تمثيلات متوقعة للوكلاء. وواجهات المستخدم تعرض البنية نفسها بقواعد واضحة وتخطيطات مقروءة وعناصر تحكم مفيدة.

المصدر

نص Markdown مقروء

→
التحليل

بنية محددة الأنواع

→
الحلّ

المراجع والأصول

→
العرض

الوكلاء والناس

المتطلَّب نفسه كما كتبه المؤلف

Muststatus

keep tentative appointments tentative.

العارض يغيّر طريقة العرض. أما هوية القاعدة وقوتها فتبقيان صريحتين.

النموذج الموحّد
{
  "format": "instruction/1",
  "metadata": {
    "front": {},
    "back": {}
  },
  "body": [
    {
      "type": "directive",
      "kind": "must",
      "form": "keyword",
      "attrs": {
        "id": "status"
      },
      "children": [
        {
          "type": "markdown",
          "source": "keep tentative appointments tentative.\n"
        }
      ]
    }
  ]
}

حواجز الحماية وعقود المخرجات

حدِّد الحدود.
وصِف النتيجة.

حاجز الحماية يلفت الانتباه إلى حدّ. وعقد المخرجات يصف ما ينبغي أن تتضمنه الإجابة المفيدة، مع مخطط حين تكون البنية مهمة. يراجع الناس ما هو متوقع، ويتلقى الوكلاء الإرشادات الدقيقة كما كُتبت.

:::guardrail{id=calendar-changes title="Calendar changes"}
Never send, delete, or move an invitation without the owner's approval.
:::

Guardrail

Calendar changes

Never send, delete, or move an invitation without the owner’s approval.

عقد مخرجات منظَّم
:::data{id=brief-shape format=json}
{"type":"object","required":["commitments","priorities"],"properties":{"commitments":{"type":"array"},"priorities":{"type":"array"}}}
:::

:::output{response-format=json schema=#brief-shape title="Daily brief"}
Preserve event status in commitments.
Keep suggestions separate in priorities.
:::
Daily briefJSON output
{
  "commitments": [
    { "time": "09:00", "status": "tentative" }
  ],
  "priorities": ["Draft the proposal"]
}

Commitments and suggestions stay separate.

الإضافات

مساحة لمفرداتك
الخاصة.

تستطيع الإضافات أن تضيف أنواع كتل، وعناصر ضمن السطر، وعارضات، ومحلِّلات مراجع، وتكاملات اختبار. نطاقات الأسماء تُبقي الإضافات واضحة. والتصريح المرقَّم بإصدار يخبر القارئ بما يلزم، والبديل الاحتياطي يُبقي المحتوى مفيدًا.

---
spec: "1"
extensions:
  charts:
    id: dev.example/charts
    version: "1.0.0"
    required: false
---

:::charts:metric{label="Focus tasks" value=1}
Recommend **one** achievable focus task.
:::

With the extension

Focus tasks
1achievable priority

Recommend one achievable focus task.

charts:metric · dev.example/charts @ 1.0.0

Without it: the Markdown fallback

Recommend one achievable focus task.

The authored instruction remains available.

The presentation changes.
The instruction stays intact.

مستندات قابلة للنقل

الإرشادات.
وكل ما يحيط بها.

البيانات التمهيدية تصف التعليمة. والمتن يحمل معناها. والملحق الختامي يحفظ سجل التأليف والمصادر في آخر المستند. أشِر إلى الموارد بعنوان URL أو بمسار محلي، أو اجمعها معًا في حزمة واحدة.

morning-assistant.md
---
spec: "1"
title: Morning assistant
version: "1.0.0"
---

# Morning assistant

Prepare a useful daily brief.

MUST[status]: keep tentative appointments tentative.
BECAUSE: an invitation is not a commitment.

---
authors: [Alex]
history:
  - summary: Preserve appointment status.
sources:
  - { title: Team guidance, uri: ./team.md }
01

الهوية والإعدادات

الإصدار، والمعاملات، والمراجع، والإضافات، ووجهات التصدير.

02

متن واحد مشترك

تعليمات وسياسات وأشخاص ومهارات ووسائط ومسارات عمل. يقرؤه الناس والوكلاء.

03

سجل التأليف

المؤلفون، والسجل، والمصادر، ومعلومات المراجعة بعد فاصل بسيط ---.

04

حزمة مكتفية بذاتها

morning-assistant/
├── instruction.md
├── team.md
├── skills/prioritize/SKILL.md
├── workflows/morning-brief.json
└── assets/brief.svg

تستطيع أداة متوافقة أن تحلّ المراجع وتصدّر الملفات التي تحتاجها الوجهة. وتبقى بيانات الاعتماد خارج الحزمة.

كيف يعمل

تعليمتك.
تصل حيث تُطلب.

البداية ملف. يستطيع وكيلك أن يتلقاه محليًا، أو يقرأه من سجل، أو يحدّثه عند وصول حدث. اختر طريقة تسليم لترى كيف يصل المستند إلى الوكيل.

ابدأ بالملف الذي تملكه أصلًا.

احتفظ بملف instruction.md داخل مشروع أو أرفقه بجلسة. اضبط مضيف الوكيل ليحمّله، أو صدِّره إلى ملف التعليمات الذي يتوقعه ذلك الوكيل.

  1. 01اختر تعليمة محلية
  2. 02حمِّلها في سياق الوكيل
  3. 03احفظ مصدرها في نظام إدارة الإصدارات
instruction.md · محتوى الملف
# Daily assistant

Prepare a short brief from my calendar.

:::policy{id=calendar}
MUST[status]: preserve tentative event status.
NEVER[send]: send invitations without approval.
:::

اكتشاف الملف وتحميله تلقائيًا يعتمدان على الوكيل. والتصدير المتوافق يحفظ الإرشادات بالصيغة التي يتوقعها.

الصيغة تحمل الإرشادات. والمضيف يقرر كيف يحمّلها ويتحقق منها وينفّذها.

ربط وكيل

الأسئلة الشائعة

أمور قليلة
تستحق أن تعرفها.

من ملفك الأول إلى وكيل مرتبط.

ناقش المواصفة
ما هو instruction.md؟

مواصفة مفتوحة مبنية على Markdown لتعليمات ذكاء اصطناعي قابلة لإعادة الاستخدام. مستند واحد يستطيع أن يصف غرض الوكيل، والإرشادات المفصَّلة، والقواعد، والمهارات، والمراجع، ومسارات العمل، بمعنى منظَّم للقارئات المتوافقة وعرض غني للناس.

لماذا لا يكفي Markdown العادي؟

Markdown العادي أساس مفيد. ويضيف instruction.md معنى صريحًا: المتطلَّب يمكن أن يكون له معرِّف ومبرِّر، ومرجع MCP يمكن أن يحمل نطاق أدوات، والكتلة المشتركة يمكن أن تُورَّث مع حفظ أصلها. يراجع الناس التفاصيل نفسها التي يحلّلها القارئ المتوافق.

هل يفهم كل وكيل في القائمة المواصفة كاملة؟

الدعم متفاوت. قد يتلقى الوكيل نص Markdown مقروءًا، أو تصديرًا بصيغة تعليماته الخاصة، أو محتوى عبر تكامل MCP. أما الكتل محددة النوع، والمراجع المحلولة، والعرض الغني، وتنفيذ مسارات العمل فتحتاج إلى أدوات متوافقة. دليل الوكلاء ليس شهادة بالمطابقة الكاملة للمواصفة.

ما علاقة ذلك بملفات AGENTS.md وCLAUDE.md وSKILL.md؟

هذه الملفات تخدم أعرافًا قائمة للوكلاء والمهارات. ويقدّم instruction.md مصدرًا أغنى قابلًا لإعادة الاستخدام، يستطيع أن يشير إلى المهارات وأن يُكيَّف مع صيغة تعليمات الوكيل المستهدف. ويظل الوكيل المستقبِل يتبع قواعده الخاصة في الاكتشاف وتسلسل التعليمات.

هل أحتاج إلى محرر instruction.md أو خدمته؟

يمكنك كتابة ملف محلي في أي محرر نصوص وحفظه في نظام إدارة الإصدارات. محرر الويب والأدوات المتوافقة تضيف المعاينة، والتحقق، وحلّ المراجع، والتكاملات. والسجل المستضاف خيار واحد للتسليم؛ والمستند يبقى قابلًا للنقل.

هل تحميل التعليمات المفصَّلة مكلف؟

الصيغة تتيح التفاصيل التي تحتاجها المهمة، من دون أن تفرض تحميل كل مورد في كل تشغيل. المقاطع المسمّاة ومراجع المهارات والحزم تتيح للأدوات المتوافقة أن تختار السياق المناسب وتحلّه. والمضيف يحدّد ما يصل إلى النموذج ومقدار السياق الذي يستهلكه.

هل كتابة MUST أو التصريح بإذن أداة يفرض تطبيقه؟

المستند يعبّر عن متطلبات المؤلف ونطاق الأدوات المقصود. وعلى مضيف الوكيل أن يفرض التفويض، وبوابات الموافقة، وضوابط الوصول. قاعدة Markdown وحدها لا تمنح وصولًا ولا تضمن أن يلتزم بها النموذج.

هل تعمل الشيفرة والجداول الزمنية ومسارات العمل عند فتح الملف؟

فتح التعليمة أو عرضها لا ينفّذ شيئًا. يستطيع محرر مرتبط أن يقدّم اختبارات وتقييمات صريحة. أما التنفيذ في بيئة الإنتاج، والجدولة، والعزل، والموافقات البشرية فمن شأن بيئة تشغيل خارجية مخوَّلة.

هل تتحدّث التعليمات من دون إعادة نشر الوكيل؟

يستطيع مضيف متوافق أن يتابع مرجعًا حيًّا ويحدّثه عبر إشعارات MCP أو تكامل آخر. والإصدار المثبَّت يبقى ثابتًا. المضيف يتحكم في وقت التحقق من التحديث وتطبيقه، فالحدث ليس أمرًا بقبول المحتوى الجديد دون تدقيق.

هل أستطيع توسيع اللغة وإبقاء كل شيء مكتفيًا بذاته؟

الإضافات ذات نطاقات الأسماء تستطيع أن تضيف عناصر وكتلًا وعارضات ومحلِّلات مراجع وتكاملات اختبار. والملفات المحلية وعناوين URL تستطيع أن توفّر الموارد المساندة؛ والحزمة تجمع هذه المواد. تصرّح الإضافات بمتطلباتها وتحفظ محتوى احتياطيًا مفيدًا.

ابدأ بتعليمة واضحة

مستند واحد.
نقطة انطلاق أفضل لوكيلك.

تعليمات غنية للوكلاء. عرض واضح للناس. معيار مشترك.