إنتقل إلى المحتوى الرئيسي

حين تعني نسبة 92% أشياء مختلفة

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

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

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

نسبتان مئويتان، سؤالان مختلفان​

يمنح Sweepy درجة لإعلان وظيفي مقابل سيرة ذاتية بطريقتين مختلفتين.

الطريقة الأولى هي المُقيّم الحتمي، وكل عملية مسح تشغّله. يأمر sweepy بفتح شاشة البدء، ويمنح START SWEEP درجة لكل بطاقة يعثر عليها المسح. ويعيد sweepy --run تشغيل آخر ملف تعريف محفوظ دون فتح المعالج. تقارن هذه الجولة مستندين. تعدّ الكلمات المشتركة بين السيرة الذاتية والإعلان، وتخلط تداخل المتطلبات بنسبة 60% مع تداخل الكلمات المفتاحية بنسبة 40%، ثم تقيس النتيجة وفق resume.keywords_weight. ولا يُحتسب أي مصطلح إلا إذا ظهر في الجانبين. ولا يستنتج المُقيّم أبدًا ما إذا كان القارئ قادرًا على أداء الوظيفة.

الطريقة الثانية هي تقييم الوكيل، وهو متاح عبر بروتوكول سياق النموذج (MCP). يقرأ الوكيل السيرة الذاتية المحلَّلة والإعلان معًا، ثم يستنتج مدى ملاءمة القارئ للدور. ويرسل نسبته المئوية الخاصة عبر submit_judgments.

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

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

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

من شاشة البدء إلى النتائج​

يجري المسار على هذا النحو: شاشة البدء ← معالج الإعداد ← المسح ← النتائج. وعندما يتجاوز المسح حد استدعاء الأداة لدى العميل، ينتقل إلى حالة قابلة للاستعلام تبقى حيّة حتى تنتهي الجولة.

وتتبع البطاقات من 3 إلى 8 هذا الترتيب. وتغطي البطاقة 2 الدرجة، وهي لا توجد إلا بعد انتهاء المسح، وهي الحالة التي تبني إليها بقية الصفحة. وتطرح البطاقة 1 المشكلة، وتطرح البطاقة 9 القيد الكامن خلف كل نص بينهما.

عرض الإطار يقتطع النصوص الطويلة​

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

وتدفع النصوص ثمن سياقها. يبلّغ Could not parse salary %r. Enter a number like 65000, 65,000, or 65k. عما فشل وعما يجب كتابته بدلًا منه، مع استبدال %r بالمدخل المرفوض. ويفعل Current profile: none loaded / build one to start الشيء نفسه مع ملف تعريف غائب. يمكن لواجهة رسومية أن تضع النصف الثاني من أي من الجملتين في تلميح منبثق. أما هنا فيضمّ السطر النصفين.

التسمية بوصفها الشرح الوحيد​

تعلن تسمية الدرجة من كتب الرقم. وتقول الوثائق ذلك بصراحة: «بطاقة MATCH تعكس حكمًا. وبطاقة KEYWORD OVERLAP تعكس كلمات مشتركة.» وتُطبع تسمية واحدة على بطاقة بجانب درجة واحدة. فيعرف القارئ أي ادعاء بين يديه قبل فتح الإعلان.

وتخبر كل كلمة القارئ أيضًا بنوع المقارنة التي أنتجت الرقم. KEYWORD OVERLAP تتناول مستندين. وMATCH تتناول شخصًا ووظيفة. والقارئ الذي يتوقع أن يتطابق الرقمان يسيء قراءة أحدهما.

تتبع التسمية الكاتب لا الواجهة. فبإمكان وكيل إرسال حكم دون نسبة مئوية. وتبقى تلك البطاقة تقرأ KEYWORD OVERLAP، لأن المسح كتب ذلك الرقم. ومسار التنفيذ يعيش خارج البطاقة. ويعلّم اسم ملف التقرير جولة MCP بالعلامة mcp، ويطبع رأس السجل طريقة التنفيذ.

وتتبع تسمية البطاقات القاعدة نفسها. BUILD PROFILE تعلن الفعل، وعنوانها الفرعي Set up your job search يطرح المصطلح الداخلي لصالح هدف القارئ. وتقول LOAD PROFILE النص Open a search you saved، وهو يصف ما تفعله البطاقة.

ما كتبته وكيف تحققت منه​

الدور: الكاتب الوحيد لنصوص المنتج التي تقتبسها دراسة الحالة هذه. كتبت العناوين الفرعية لشاشة البدء وأسئلة المعالج، ثم رسائل التقدم ونص التحقق. وجاءت تسميات مصدر الدرجة وmessage الخاص بتسليم MCP الذي يمرره العميل في النهاية. وأدرت البناء باستخدام Copilot وGemini، وفق إرشادات الوكلاء على مستوى المستودع وبوابة جودة في CI. وتحققت من نصوص المنتج الحرفية مقابل الشيفرة المصدرية لـ Sweepy.

عاير الثقة، ثم تصرّف​

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

الأسئلة الخمسة عشر بالترتيب​

يمرّ المعالج بخمس عشرة خطوة. وتظهر الأسئلة الخمسة عشر العليا بالترتيب، وتُعرض أسئلة نعم أو لا كمُحدِّد نعم/لا.

أسئلة المعالج
? What is your name?
>

? What job titles are you looking for?
(Separate multiple titles with a comma)
>

? Where do you want to work? (City, State):
>

? Do you want to see remote-only roles? (Y/n)

? Do you want to include hybrid roles? (Y/n)

? What is the path to your resume PDF?
>

? What is your minimum target salary? (Leave blank to skip):
>

? Which boards do you want to search? Pick from any engine; downloaded engines are labeled.

? Do you want to add custom platforms or ATS domains? (Y/n)

? Enter must-have skills or keywords to prioritize
(comma-separated, leave blank to extract from resume):
>

? What export formats do you want?
[x] PDF Report
[x] CSV Spreadsheet
[ ] JSON Data

? Add job-tracking columns to the CSV? (date applied, status, interview stage,
offer, follow-up date, contact, notes) (Y/n)

? Do you want to configure multiple resume tracks
(e.g. Tech Writer vs UX Writer)? (Y/n)

? Do you have a portfolio, writing samples, or case studies to submit
with applications? (Y/n)

? Enable debug logging? (Logs are saved under logs/ in the application
directory): (Y/n)

أين تتحقق من النصوص​