skill

إلى التذاكر

قسم خطة أو مواصفات أو المحادثة الحالية إلى مجموعة من تذاكر "tracer-bullet"، حيث تحدد كل تذكرة حوافها المعيقة، وتنشرها في أداة التتبع المكونة (الحواف كنص في ملف واحد لكل تذكرة محليا، أو روابط حظر أصلية على أداة تتبع حقيقية).

mattpocock625,610+ تثبيتموثوق

نبذة

# إلى التذاكر

قسم خطة أو مواصفات أو محادثة إلى مجموعة من **التذاكر**: شرائح عمودية "tracer-bullet"، تحدد كل منها التذاكر التي **تعيقها**.

يجب أن يكون قد تم تزويدك بمفردات متتبع المشكلات وتصنيف الفرز. إذا لم يكن الأمر كذلك، اطلب من المستخدم تشغيل `/setup-matt-pocock-skills`.

## العملية

### 1. جمع السياق

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

### 2. استكشاف قاعدة الكود (اختياري)

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

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

### 3. صياغة الشرائح العمودية

قسم العمل إلى تذاكر **tracer bullet**.

<vertical-slice-rules>

- تقطع كل شريحة مسارا ضيقا ولكنه كاملا عبر كل طبقة (المخطط، API، واجهة المستخدم، الاختبارات): عمودي، وليس شريحة أفقية لطبقة واحدة - الشريحة المكتملة قابلة للعرض أو التحقق منها بمفردها - كل شريحة بحجم مناسب لتناسب نافذة سياق جديدة واحدة - يجب أن تتم أي إعادة هيكلة مسبقة أولا

</vertical-slice-rules>

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

**إعادة الهيكلة الواسعة هي استثناء للتقسيم العمودي.** **إعادة الهيكلة الواسعة** هي تغيير ميكانيكي واحد (إعادة تسمية عمود، إعادة كتابة رمز مشترك) تتوزع **منطقة تأثيره** عبر قاعدة الكود بأكملها، بحيث يؤدي تعديل واحد إلى كسر آلاف مواقع الاستدعاء دفعة واحدة ولا يمكن لأي شريحة عمودية أن تهبط بشكل سليم. لا تجبرها على أن تكون "tracer bullet"؛ قم بتسلسلها على أنها **توسيع-تقليص**. أولا التوسيع: أضف النموذج الجديد بجانب القديم حتى لا ينكسر شيء. ثم قم بترحيل مواقع الاستدعاء على دفعات بحجم منطقة التأثير (لكل حزمة، لكل دليل)، كل دفعة تذكرتها الخاصة التي تعيقها عملية التوسيع، مع الحفاظ على CI سليما دفعة تلو الأخرى لأن النموذج القديم لا يزال موجودا. أخيرا التقليص: احذف النموذج القديم بمجرد عدم وجود أي مستدعي متبق، في تذكرة تعيقها كل دفعة ترحيل. عندما لا تستطيع الدفعات حتى البقاء سليمة بمفردها، حافظ على التسلسل ولكن دعها تشترك في فرع تكامل تعيق جميعها تذكرة تكامل وتحقق نهائية؛ يتم الوعد بالسلامة هناك فقط.

### 4. استجواب المستخدم

قدم التقسيم المقترح كقائمة مرقمة. لكل تذكرة، أظهر:

- **العنوان**: اسم وصفي قصير - **معيق بواسطة**: أي تذاكر أخرى (إن وجدت) يجب إكمالها أولا - **ما تقدمه**: السلوك الشامل الذي تنجزه هذه التذكرة

اسأل المستخدم:

- هل الدقة مناسبة؟ (خشنة جدا / دقيقة جدا) - هل الحواف المعيقة صحيحة: هل تعتمد كل تذكرة فقط على التذاكر التي تعيقها حقا؟ - هل يجب دمج أو تقسيم أي تذاكر أخرى؟

كرر حتى يوافق المستخدم على التقسيم.

### 5. نشر التذاكر في المتتبع المكون

انشر التذاكر المعتمدة. **كيفية** ذلك تعتمد على المتتبع الذي تم تكوينه بواسطة `/setup-matt-pocock-skills`؛ التذاكر هي نفسها في كلتا الحالتين، فقط شكل الحواف المعيقة يتغير:

- **الملفات المحلية** ← اكتب ملفا واحدا لكل تذكرة تحت `.scratch/<feature-slug>/issues/<NN>-<slug>.md`، مرقمة من `01` بترتيب التبعية (المعوقات أولا). تسرد "معيق بواسطة" في كل ملف الأرقام/العناوين التي تعتمد عليها. استخدم قالب ملف التذكرة لكل تذكرة أدناه: تذكرة واحدة لكل ملف، وليس ملفا مدمجا واحدا أبدا. - **متتبع مشكلات حقيقي (GitHub, Linear, …)** ← انشر مشكلة واحدة لكل تذكرة بترتيب التبعية (المعوقات أولا) بحيث يمكن لحواف حظر كل تذكرة الإشارة إلى معرفات حقيقية. استخدم علاقة الحظر الأصلية للمنصة حيثما توجد؛ وإلا قم بتعيين "معيق بواسطة" لكل تذكرة إلى المشكلات المعيقة. إذا كان المصدر مشكلة موجودة، فاجعل كل تذكرة مشكلة فرعية لها (عملية وثيقة المتتبع). طبق تصنيف الفرز `ready-for-agent` ما لم يطلب خلاف ذلك؛ التذاكر قابلة للاستيلاء عليها بواسطة الوكيل بطبيعتها.

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

لا تغلق أو تعدل أي مشكلة رئيسية.

<local-ticket-template>

# <NN>: <عنوان التذكرة>

**ما يجب بناؤه:** السلوك الشامل الذي تنجزه هذه التذكرة، من منظور المستخدم، وليس قائمة تنفيذ طبقة تلو الأخرى.

**معيق بواسطة:** أرقام/عناوين التذاكر التي تعيق هذه التذكرة، أو "لا شيء (يمكن البدء فورا)".

**الحالة:** ready-for-agent

- [ ] معيار القبول 1 - [ ] معيار القبول 2

</local-ticket-template>

<issue-template>

## الأصل

مرجع إلى المشكلة الأصلية في المتتبع (إذا كان المصدر مشكلة موجودة، وإلا احذف هذا القسم).

## ما يجب بناؤه

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

## معايير القبول

- [ ] المعيار 1 - [ ] المعيار 2

## معيق بواسطة

- مرجع لكل معيق </issue-template>

التثبيت

شغل هذا الأمر

npx skills add mattpocock/skills

يعمل مع

claude appclaude codeclaude apicursorcodexwindsurfclinezed

خطوات التثبيت

ثبت باستخدام `npx skills add mattpocock/skills`، أو استنسخ المستودع وانسخ مجلد `skills/engineering/to-tickets` إلى دليل مهارات Claude الخاص بك.

عرض المصدر

أسئلة شائعة

ما هي مهارة إلى التذاكر؟

قسم خطة أو مواصفات أو المحادثة الحالية إلى مجموعة من تذاكر "tracer-bullet"، حيث تحدد كل تذكرة حوافها المعيقة، وتنشرها في أداة التتبع المكونة (الحواف كنص في ملف واحد لكل تذكرة محليا، أو روابط حظر أصلية على أداة تتبع حقيقية).

كيف أثبت إلى التذاكر؟

شغل هذا الأمر في الطرفية:

npx skills add mattpocock/skills
مع أي أدوات ذكاء اصطناعي تعمل إلى التذاكر؟

تعمل مع claude_app، claude_code، claude_api، cursor، codex، windsurf، cline، zed.

من طور إلى التذاكر؟

طورها mattpocock.

هل إلى التذاكر مجانية؟

نعم، يمكنك استخدامها مجانا.

أصول ذات صلة

مختارات أخرى في خدمة العملاء.

كل بدائل إلى التذاكر ←

افحص قبل التثبيت

شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.

المزيد في خدمة العملاء