skill

المرشد

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

mattpocock763,794+ تثبيتموثوق

نبذة

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

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

## خطط، لا تفعل

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

يعمل مع

claude appclaude codeclaude apicursorcodexwindsurfclinezed

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

ثبت باستخدام `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.

هل المرشد مجانية؟

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

أصول ذات صلة

مختارات أخرى في الإنتاجية والمكتب.

كل بدائل المرشد ←
skillclaude_appclaude_codeclaude_api
npx skills add vercel-labs/skills
البحث عن المهارات
يساعد المستخدمين على اكتشاف وتثبيت مهارات الوكلاء عندما يطرحون أسئلة مثل "كيف أفعل X؟"، "ابحث عن مهارة ل X"، "هل توجد مهارة يمكنها..."، أو يعبرون عن ا…3,611,572+
skillclaude_appclaude_codeclaude_api
npx skills add heygen-com/hyperframes
استخدام الوسائط
احصل على أو أنشئ أي وسائط لفيديو HyperFrames - موسيقى، مؤثرات صوتية، صور، أيقونات، شعارات، تعليق صوتي، صورة رمزية (avatar) وفيديو مولد، نصوص، قصاصات،…1,260,249+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
تحسين هيكلة قاعدة الأكواد
افحص قاعدة بيانات برمجية بحثا عن فرص للتحسين والتعميق، وقدمها كتقرير HTML مرئي، ثم تعمق في الفرصة التي تختارها.1,215,298+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
تسليم المهام
لخص المحادثة الحالية في وثيقة تسليم ليتابعها وكيل آخر.946,569+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
فرز أولي
نقل المشكلات وطلبات السحب الخارجية عبر آلة حالة لأدوار الفرز، وتصنيفها، والتحقق منها، والتدقيق فيها عند الحاجة، وكتابة ملخصات جاهزة للوكلاء.881,979+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
تعليم
علم المستخدم مهارة أو مفهوما جديدا ضمن مساحة العمل هذه.778,928+

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

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

المزيد في الإنتاجية والمكتب