طلب سحب

استخدم هذا القالب لكتابة نص طلب السحب (PR body):

```markdown ## ملخص

<رسم بياني، رسم تخطيطي للاختلاف، أو شجرة>

## دليل

- **قبل:** <لقطة شاشة/مخرجات/تشغيل اختبار فاشل> **بعد:** <لقطة شاشة/مخرجات/تشغيل اختبار ناجح>

## خطر الدمج

**الباب:** <باتجاه واحد أو باتجاهين>

<اختياري: وصف>

**نطاق التأثير:** <وصف من كلمة واحدة>

<اختياري: تداعيات محتملة للدمج> ```

## الأقسام

تجاوز جميع المقدمات واجعل النثر موجزا. استخدم لغة المجال الخاصة بالمستخدم من `GLOSSARY.md`.

### ملخص

اختر أصغر عرض يوضح النقطة الرئيسية بوضوح.

- أظهر المنطق أو الخوارزمية كشفرة زائفة:

```text on(save) if content is unchanged return cached result write new content return fresh result ```

- أظهر تدفق التحكم في وقت التشغيل كشجرة استدعاء:

```text submitForm createSession persistPrompt launchAgent navigateToSession ```

- أظهر بنية واجهة المستخدم كشجرة مكونات، بما في ذلك حدود الحالة والوحدات التي تهم:

```text <SessionPage> (apps/example/src/routes/session.tsx) useSessionEvents() <SessionToolbar> <RunSkillButton> (packages/ui) ```

- أظهر مسؤولية الملف أو إعادة هيكلة واسعة النطاق كشجرة ملفات ضحلة:

``` src/ ├── commands/ # parses user actions ├── sessions/ # owns session state └── transport/ # sends API requests ```

- أظهر تفاعل المكونات، تدفق التحكم، أو تدفق البيانات باستخدام Mermaid:

```mermaid sequenceDiagram participant User participant UI participant Daemon User->>UI: choose command UI->>Daemon: send expanded prompt Daemon-->>UI: stream result ```

- استخدم `diff` عندما تكون النقطة هي ما يتغير والشكل المحيط موجود بالفعل. طابق شكل ال diff مع الموضوع.

لتغيير مكون:

```diff <SessionPage> useSessionEvents() <SessionToolbar> + <RunSkillButton /> <SessionTimeline> + <SkillResultCard /> ```

لتغيير تخطيط الملف:

```diff src/ ├── commands/ +│ └── show-me.ts # expands the slash command ├── sessions/ -└── transport.ts +└── transport/ + ├── client.ts + └── stream.ts ```

لتغيير شجرة استدعاء أو مكدس استدعاء:

```diff submitForm createSession persistPrompt + expandSkillMention launchAgent - navigateToSession + navigateToSession + subscribeToEvents ```

لتغيير حالة أو تدفق تحكم:

```diff on(save) - write content + if content is unchanged + return cached result + write new content + invalidate cache ```

- أظهر الكتلة بأكملها عندما يكون معظمها جديدا، أو عندما يخفي السياق المحذوف الملكية أو الترتيب، أو عندما يحتاج المستخدم إلى شكل مستهدف قابل للنسخ:

```ts function expandSkill(command: string): string { const skillName = command.slice(1); return `use the ${skillName} skill`; } ```

#### إرشادات

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

يمكنك استخدام واحد من هذه، أو عدة منها، ومن غير المرجح أن تستخدمها جميعا. استخدم حكمك ولا ترهق المستخدم.

### دليل

دليل ملموس على أن التغيير يعمل. أظهر قبل وبعد.

لقطات الشاشة هي الأفضل - عندما تكون البيئة مهيأة لذلك والتغيير مرئي.

الدليل القائم على التنفيذ هو من الدرجة الثانية. نتائج الاختبار، مخرجات وحدة التحكم. أظهر الاختبار الدقيق الذي يفشل الآن وينجح، باستخدام الشفرة الزائفة.

### خطر الدمج

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

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