skill
المرشد
خطط لجزء كبير من العمل (أكبر مما يمكن أن تستوعبه جلسة وكيل واحدة) كخريطة مشتركة لتذاكر القرارات على متتبع المشكلات الخاص بك، وقم بحلها واحدة تلو الأخرى حتى يصبح الطريق إلى الوجهة واضحا.
نبذة
لقد وصلت فكرة فضفاضة، أكبر من أن تعالج في جلسة وكيل واحدة، ومحاطة بالضباب: الطريق من هنا إلى **الوجهة** غير مرئي بعد. تهدف عملية تحديد المسار إلى إيجاد هذا الطريق، وليس الاندفاع نحو الوجهة. تحدد هذه المهارة الطريق ك**خريطة مشتركة** في متتبع المشكلات الخاص بالمستودع، ثم تعمل على **تذاكر القرارات** الخاصة بها (الأسئلة التي يكون حلها قرارا، وليست أجزاء من بناء يجب تنفيذه) واحدة تلو الأخرى حتى يتضح المسار.
تختلف الوجهة باختلاف الجهد، وتسميتها هي أول عمل في رسم الخريطة: فهي تشكل كل تذكرة. قد تكون مواصفات لتسليمها والتكرار عليها، أو قرارا يجب تأمينه قبل بدء التخطيط، أو تغييرا يتم إجراؤه في مكانه مثل ترحيل بنية بيانات. الخريطة لا تعتمد على المجال: عمل هندسي، محتوى دورة تدريبية، أي شيء يناسب الشكل.
## خطط، لا تفعل
Wayfinder هو **تخطيط** افتراضيا: كل تذكرة تحل قرارا، وتكتمل الخريطة عندما يتضح الطريق، ولا يتبقى شيء لتقرره قبل أن يذهب شخص ما ويفعل الشيء. عادة ما تكون الرغبة في مجرد القيام بالعمل هي الإشارة إلى أنك وصلت إلى حافة الخريطة وحان وقت التسليم. يمكن لجهد ما تجاوز هذا في **ملاحظاته**، حاملا التنفيذ إلى الخريطة نفسها، ولكن في غياب ذلك، أنتج قرارات، لا مخرجات.
## الإشارة بالاسم
كل خريطة وتذكرة هي مشكلة، لذا لها **اسم**: عنوانها. في كل ما يقرأه الإنسان (السرد، قرارات الخريطة حتى الآن)، أشر إليها بهذا الاسم، وليس أبدا بمعرف مجرد، أو رقم، أو slug. جدار من `#42, #43, #44` غير مقروء؛ الأسماء تقرأ بلمحة. المعرف و URL لا يختفيان؛ الاسم يغلف رابطه، لكنهما يركبان _داخل_ الاسم، ولا يحلان محله أبدا.
## الخريطة
الخريطة هي مشكلة واحدة في متتبع المشكلات الخاص بهذا المستودع، موسومة ب `wayfinder:map`، وهي الأثر الأساسي. تذاكرها هي مشكلات فرعية للخريطة.
الخريطة هي **فهرس**، وليست مخزنا. تسرد القرارات المتخذة وتشير إلى التذاكر التي تحتوي على تفاصيلها؛ يعيش القرار في مكان واحد بالضبط، تذكرته، لذا لا تعيد الخريطة صياغته أبدا، بل تلخصه وتربطه فقط.
**المكان الذي تعيش فيه الخريطة وتذاكرها الفرعية والحظر واستعلامات الواجهة الأمامية ماديا يعتمد على المتتبع.** يجب أن يكون متتبع المشكلات قد تم توفيره لك. إذا لم يكن كذلك، اطلب من المستخدم تشغيل `/setup-matt-pocock-skills`. استشر قسم "عمليات تحديد المسار" في وثائق المتتبع لمعرفة كيفية تعبير هذا المستودع عنها. إذا لم يتم توفير متتبع، فافترض متتبع markdown المحلي.
### جسم الخريطة
الخريطة بأكملها بدقة منخفضة، يتم تحميلها مرة واحدة لكل جلسة. التذاكر المفتوحة **غير** مدرجة: إنها مشكلات فرعية مفتوحة، يتم العثور عليها بالاستعلام.
```markdown ## الوجهة
<ما يبدو عليه الوصول إلى نهاية هذه الخريطة: المواصفات، القرار، أو التغيير الذي يسعى هذا الجهد لإيجاد طريقه إليه. سطر أو سطران؛ كل جلسة تتجه نحوه قبل اختيار تذكرة.>
## ملاحظات
<المجال؛ المهارات التي يجب على كل جلسة استشارتها؛ التفضيلات الدائمة لهذا الجهد>
## القرارات حتى الآن
<!-- الفهرس: سطر واحد لكل تذكرة مغلقة، يكفي للحكم على الصلة، ثم تكبير الرابط للحصول على التفاصيل التي تحتويها التذكرة -->
- [<عنوان التذكرة المغلقة>](الرابط): <ملخص من سطر واحد للإجابة>
## لم يتم تحديده بعد
<!-- انظر "ضباب الحرب": ضباب ضمن النطاق لا يمكنك إصدار تذكرة له بعد؛ يتطور مع تقدم الواجهة الأمامية -->
## خارج النطاق
<!-- انظر "خارج النطاق": العمل الذي تم اعتباره خارج الوجهة؛ مغلق، لا يتطور أبدا --> ```
### التذاكر
كل تذكرة هي **مشكلة فرعية** للخريطة؛ معرف مشكلة المتتبع هو هويتها. جسمها هو السؤال، بحجم جلسة وكيل واحدة تتسع ل 100 ألف رمز:
```markdown ## السؤال
<القرار أو التحقيق الذي تحله هذه التذكرة> ```
تحمل كل تذكرة تسمية `wayfinder:<type>`، واحدة من `research`، `prototype`، `grilling`، `task` (انظر [أنواع التذاكر](#ticket-types)). تسميات `wayfinder:` هي التسميات الوحيدة التي تحملها الخريطة وتذاكرها، وليست أبدا تسمية فرز مثل `ready-for-agent`: إنها قرارات، وليست أعمال تنفيذ.
تعلن الجلسة عن **مطالبتها** بتذكرة عن طريق تعيينها للمطور الذي يقود الخريطة، **أولا**، قبل أي عمل، بحيث تتخطاها الجلسات المتزامنة. هذا المعين _هو_ المطالبة: التذكرة المفتوحة غير المعينة هي غير مطالب بها.
يستخدم الحظر علاقة التبعية **الأصلية** للمتتبع: وهو أمر أساسي لأنه يعرض الواجهة الأمامية _بصريا_ في واجهة المستخدم الخاصة بالمتتبع، بحيث يرى الإنسان ما يمكن أخذه دون فتح الخريطة. فقط المتتبع الذي يفتقر إلى الحظر الأصلي يعود إلى اتفاقية الجسم. تكون التذكرة **غير محظورة** عندما تكون كل تذكرة تحظرها مغلقة؛ **الواجهة الأمامية** هي الأطفال المفتوحون، غير المحظورين، غير المطالب بهم، حافة المعروف.
الإجابة ليست جزءا من الجسم؛ يتم تسجيلها عند الحل (انظر [العمل من خلال الخريطة](#work-through-the-map)). يتم ربط الأصول التي تم إنشاؤها أثناء حل تذكرة من المشكلة، ولا يتم لصقها.
## أنواع التذاكر
كل تذكرة إما **HITL** (البشر في الحلقة، يتم العمل _مع_ إنسان يتحدث عن نفسه) أو **AFK**، يديرها الوكيل وحده. تذكرة HITL لا تحل إلا من خلال هذا التبادل المباشر؛ لا يحل الوكيل أبدا محل جانب الإنسان (الوكيل الذي يجيب على أسئلته الخاصة قد كسر ال)
التثبيت
شغل هذا الأمر
npx skills add mattpocock/skillsيعمل مع
خطوات التثبيت
ثبت باستخدام `npx skills add mattpocock/skills`، أو استنسخ المستودع وانسخ مجلد `skills/engineering/wayfinder` إلى دليل مهارات Claude الخاص بك.
أسئلة شائعة
ما هي مهارة المرشد؟
خطط لجزء كبير من العمل (أكبر مما يمكن أن تستوعبه جلسة وكيل واحدة) كخريطة مشتركة لتذاكر القرارات على متتبع المشكلات الخاص بك، وقم بحلها واحدة تلو الأخرى حتى يصبح الطريق إلى الوجهة واضحا.
كيف أثبت المرشد؟
شغل هذا الأمر في الطرفية:
npx skills add mattpocock/skillsمع أي أدوات ذكاء اصطناعي تعمل المرشد؟
تعمل مع claude_app، claude_code، claude_api، cursor، codex، windsurf، cline، zed.
من طور المرشد؟
طورها mattpocock.
هل المرشد مجانية؟
نعم، يمكنك استخدامها مجانا.
npx skills add vercel-labs/skills
npx skills add heygen-com/hyperframes
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add mattpocock/skills
افحص قبل التثبيت
شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.
مختبر وكلاء الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
فحص أمني تلقائي للموقع
الأمان
اختبار جودة المحتوى العربي بالذكاء الاصطناعي
جودة المحتوى
كاشف منصة الموقع
الترحيل
محلل سرعة الصفحة
الأداء
تدقيق الظهور في محركات الذكاء الاصطناعي
الظهور في الذكاء الاصطناعي
مولد ملف llms.txt
الظهور في الذكاء الاصطناعي
منشئ البيانات المنظمة
الظهور في الذكاء الاصطناعي
مقياس سهولة القراءة بالعربية
جودة المحتوى
حاسبة تكاليف الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
محلل العناوين العربية
جودة المحتوى