حين تعني نسبة 92% أشياء مختلفة
دراسة حالة في كتابة تجربة المستخدم حول نصوص تعلن سياقها داخل واجهة نصية بسيطة.
Sweepy أداة بحث عن عمل تعمل في الطرفية. تُرسم الواجهة بحروف الإطار والنص الملوّن، وتقرأ الإدخال من لوحة المفاتيح. على الشرح أن يسكن النص نفسه، لأن التلميح المنبثق لا يجد مكانًا يظهر فيه. تقتطع شاشة البدء سطر حالتها عند حافة الإطار بدلًا من لفّه. النص إما ينتهي داخل العرض أو يفقد نهايته.
وخرجت من ذلك قاعدة واحدة. كل نص يعلن سياقه. تسميات الدرجات تعلن من كتب الرقم. ونصوص الحالة تتبع الانضباط نفسه، من السطر السفلي في شاشة البدء إلى تلميح التنسيق في كل سؤال. والدرجة هي الحالة الصعبة، لأن النسبة المئوية تبدو مفيدة سواء عرف القارئ كيف أنتجتها الأداة أم لم يعرف.
نسبتان مئويتان، سؤالان مختلفان
يمنح Sweepy درجة لإعلان وظيفي مقابل سيرة ذاتية بطريقتين مختلفتين.
الطريقة الأولى هي المُقيّم الحتمي، وكل عملية مسح تشغّله. يأمر sweepy بفتح شاشة البدء، ويمنح START SWEEP درجة لكل بطاقة يعثر عليها المسح. ويعيد sweepy --run تشغيل آخر ملف تعريف محفوظ دون فتح المعالج. تقارن هذه الجولة مستندين. تعدّ الكلمات المشتركة بين السيرة الذاتية والإعلان، وتخلط تداخل المتطلبات بنسبة 60% مع تداخل الكلمات المفتاحية بنسبة 40%، ثم تقيس النتيجة وفق resume.keywords_weight. ولا يُحتسب أي مصطلح إلا إذا ظهر في الجانبين. ولا يستنتج المُقيّم أبدًا ما إذا كان القارئ قادرًا على أداء الوظيفة.
الطريقة الثانية هي تقييم الوكيل، وهو متاح عبر بروتوكول سياق النموذج (MCP). يقرأ الوكيل السيرة الذاتية المحلَّلة والإعلان معًا، ثم يستنتج مدى ملاءمة القارئ للدور. ويرسل نسبته المئوية الخاصة عبر submit_judgments.
عدّ الكلمات المشتركة وحكم الوكيل يجيبان عن سؤالين مختلفين. فعدّ الكلمات المشتركة يقيس التداخل لا الملاءمة، لذا يجب أن تسمّي التسمية الكاتب. يخبر العدّ مقدار النص المشترك بين السيرة الذاتية والإعلان. ويحكم الوكيل على مدى ملاءمة شخص واحد لوظيفة واحدة. قد تعيد السيرة الذاتية صياغة إعلان كلمة بكلمة ومع ذلك تصف ملاءمة ضعيفة. وقد تصف سيرة ذاتية بمفردات أخرى ملاءمة قوية. يكتشف عدّ الكلمات الحالة الأولى ويفوّت الثانية، ويستطيع الوكيل وزن الحالتين.
تعرض البطاقة درجة واحدة. أحدث كاتب هو من يضبطها، والتقييم يعيد ترتيب التقرير حول القيمة الجديدة. ويحلّ الحكم محل الدرجة الحتمية بدلًا من أن يجلس بجانبها. والنسبة المجرّدة تخفي أي الكاتبين يراه القارئ.
كان على النص أن يعلن الكاتب داخل سطر الشارة، قبل أن يفتح القارئ أي إعلان. وتتبع بقية الواجهة القاعدة نفسها.
من شاشة البدء إلى النتائج
يجري المسار على هذا النحو: شاشة البدء ← معالج الإعداد ← المسح ← النتائج. وعندما يتجاوز المسح حد استدعاء الأداة لدى العميل، ينتقل إلى حالة قابلة للاستعلام تبقى حيّة حتى تنتهي الجولة.
وتتبع البطاقات من 3 إلى 8 هذا الترتيب. وتغطي البطاقة 2 الدرجة، وهي لا توجد إلا بعد انتهاء المسح، وهي الحالة التي تبني إليها بقية الصفحة. وتطرح البطاقة 1 المشكلة، وتطرح البطاقة 9 القيد الكامن خلف كل نص بينهما.
خانة درجة واحدة، كاتبان
خانة درجة واحدة، وكاتبان محتملان. يمنح كل مسح درجة لكل بطاقة عبر عدّ التداخل الحتمي. لكن تقييم MCP يطمس ذلك الرقم باستنتاجه الخاص. ودون فرق واضح في التسمية، لا يستطيع القارئ معرفة أي كاتب ضبط الدرجة، ولا معايرة ثقته. وكانت مشكلة المحتوى هي تمييز الكاتب داخل سطر الشارة، في مساحة بضع كلمات.
التمييز بين عدّ وحكم
الملف التعريفي نفسه، والرقم نفسه، وكاتبان. ضبط وكيل البطاقة الأولى، لذا تقرأ 92% MATCH. وضبط المُقيّم الحتمي البطاقة الثانية، لذا تقرأ 92% KEYWORD OVERLAP. والتسمية تحدّد الكاتب. والقارئ الذي يرى 92% فقط لا يجد سبيلًا للتمييز بين الاثنين. ويطمس التقييم درجة التداخل في الخانة نفسها، لأن العدّ والحكم يجيبان عن سؤالين مختلفين.
- تعني
92% KEYWORD OVERLAPعدّ الكلمات المشتركة بين السيرة الذاتية والإعلان. - وتعني
92% MATCHالرقم الذي وصل إليه وكيل بالاستنتاج حول مدى ملاءمة القارئ للدور.
يكتب المسح العدّ على كل بطاقة ينتجها، سواء بدأ في الطرفية أو عبر run_sweep من خلال MCP. ولا يستبدله بـ MATCH إلا match_pct مُرسَل.
ويكرّر سطر الترتيب في PDF التسمية بين قوسين معقوفين: #1 // COMPANY | [92% MATCH] أو [92% KEYWORD OVERLAP]. ويكتب ملف CSV قيمة match_value بجانب match_kind، ليمنح القارئ الحقيقة نفسها بصيغة مقروءة آليًا. وقد تظهر درجة ثالثة بجانب درجة المطابقة. وتطبع [88% PORTFOLIO FIT] تسميتها الخاصة للسبب نفسه، لأن نماذجك تجيب عن سؤال مختلف عن سؤال سيرتك الذاتية.
تُقرأ شارة التقديم نصًا أولًا ولونًا ثانيًا. وتشير [STANDARD / QUICK APPLY] إلى تقديم عادي، وتشير [EXTENDED RESPONSES REQUIRED] إلى دور يتطلب نماذج كتابة. وتطبع البطاقة الثالثة [EXTENDED RESPONSES REQUIRED] على سطر ترتيب يسرد أيضًا مسار السيرة الذاتية. وتعمل التسميتان دون لون، وهذا مهم لإمكانية الوصول وللطرفيات التي لا تعرض اللون.
الهوية والنطاق والجاهزية في سطر واحد
يعلن Current profile: none loaded / build one to start الحالة الغائبة والخطوة التالية في سطر واحد. ويؤكد Current profile: Alex Rivera / 4 titles / Ready الاسم في الخانة الأولى والجاهزية في الأخيرة. ويفصل كل خط مائل بين إجابة وأخرى، ويُقتطع السطر عند حافة الإطار بدلًا من لفّه. وتحلّ Resume missing محل Ready عندما لا يحمل الملف التعريفي المحفوظ مسارًا لسيرة ذاتية.
في الطرفية، سطر الحالة هو السياق المستمر الوحيد. ويُقرأ كعنوان ومؤشر جاهزية في الوقت نفسه.
فعل، ثم مفعول، ثم هدف القارئ
يقترن START SWEEP بـ Run your job search now. وتطبع كل بطاقة سطرين: اسمًا وعنوانًا فرعيًا يعيد صياغة ما يفعله مفتاح Enter بكلمات القارئ. ويعرض SWEEP SETTINGS النص Ranking, cards, tracking. ويعرض SWEEPY'S TOOLBOX النص Edit profile, logs, help. ويعرض EXIT SWEEPY النص Save changes and close، وهو وعد بالحفاظ على عملك.
تبدأ بطاقات الإجراء بفعل ومفعوله. أما البقية فتصف موضعًا أو خروجًا. ويشرح العنوان الفرعي أي مصطلح داخلي بلغة واضحة. وتحدّد الأرقام المكوّنة من خانتين كل بطاقة بدلًا من ترتيب الشبكة. ويقرن الصف العلوي 01 بـ 04. وتنضم البطاقة إلى الشبكة دون إعادة ترقيم البقية. ويعمل التنقل بمفاتيح الأسهم ومفتاح Enter.
تلميحات التنسيق داخل السؤال
يبقي السؤال على سطر واحد، وعندما يهمّ التنسيق يضع القاعدة تحته بمسافة بادئة:
What job titles are you looking for?
(Separate multiple titles with a comma)
ويذكر سؤال الراتب خيار التخطي داخل السؤال نفسه:
What is your minimum target salary? (Leave blank to skip):
تظهر القاعدة في السطر الذي يقع فيه القرار. ويبقى القارئ على الشاشة. فالطرفية لا تملك تلميحًا منبثقًا يعود إليه.
تعديل إجابة دون إعادة تشغيل المعالج
يمرّ المعالج بخمس عشرة خطوة، ويعود مفتاح Esc خطوة واحدة في كل ضغطة. وتسرد شاشة المراجعة إحدى عشرة مدخلًا: ← Back، ثم Submit profile، ثم تسعة إجراءات. ويقع Edit an answer مباشرة تحت Submit profile. فالمراجعة تفصلها صف واحد عن التقديم. والقارئ الذي يريد تغيير إجابة لا يعيد تشغيل كل الأسئلة.
تسميات المراحل للخطوات الخمس
تطبع جولة في سطر الأوامر خمس مراحل مرقّمة، تعلن كل منها العمل.
[1/5] Loading profile...
[2/5] Discovering roles...
[3/5] Validating URLs...
[4/5] Scoring against resume...
[5/5] Generating reports...
تعلن أسطر السجل رقم المرحلة. أما حمولة تقدم MCP فتسمّي العنصر: step 1 من total 4 للمسمى الوظيفي الأول من أربعة، بالتسمية Discovering roles: Paralegal. ويبلّغ Scoring roles عن القائمة المختصرة أثناء عمل المُقيّم. ويرى القارئ أين وصلت الجولة وما بقي. وشريط التقدم سيوحي بمدة لا تستطيع الأداة معرفتها.
الانتظار الذي يعيد مُعرِّف مهمة
قد يستمر المسح المباشر دقيقة أو أكثر. وفي وضع MCP يعيد استدعاء الأداة حالة قيد التشغيل بدلًا من انتظار المسح كاملًا. وهذا يبقي الاستدعاء داخل مهلة العميل ويخبر المستدعي أن العمل مستمر.
ينتظر run_sweep خمسًا وأربعين ثانية افتراضيًا. ويضبط wait_seconds ذلك الانتظار، محصورًا بين 0 و600، ويخفض SWEEPY_MCP_WAIT_SECONDS السقف على المضيفات ذات الحدود الأضيق. وتتضمن حالة التشغيل job_id وكائن progress وقيمة elapsed_seconds وmessage:
{
"status": "ok",
"sweep_status": "running",
"job_id": "<job id>",
"progress": { "step": 3, "total": 5, "label": "Validating URLs" },
"elapsed_seconds": 41.2,
"debug_log": "<path>",
"message": "The sweep is still running. Call get_sweep_status to wait for it, then continue with get_jobs."
}
يستعلم العميل عن get_sweep_status باستخدام job_id حتى تصبح قيمة sweep_status هي "completed". ويواصل Sweepy العمل عبر التسليم سواء بقي العميل متصلًا أم لا. وعلى النص أن يتسع داخل المهلة وأن يُقرأ قراءة صحيحة لدى عميل يعيد الاتصال لاحقًا. فهذه حالة قيد التشغيل تبلغ عن التقدم.
الخمس والأربعون ثانية قيمة افتراضية للمنتج، يضبطها _DEFAULT_WAIT_SECONDS ويحدّها _MAX_WAIT_SECONDS. وتتغير progress وelapsed_seconds في كل جولة، وكذلك debug_log. وتسمّي message استدعاء الأداة التالي بدلًا من تكرار أرقام يملكها المستدعي أصلًا.
لا مكان لإخفاء نص ضعيف
تعتمد الواجهة على النص وحده، ويقتطع الإطار كل ما يطول. وعلى التسمية أن تقف بذاتها، لأن شيئًا آخر على الشاشة لا يشرحها. وتعلن رسائل الحالة أين يقف القارئ، دون مؤشر دوّار يستند إليه.
وتتبع قاعدة التسمية ذلك. فـ START SWEEP وLOAD PROFILE وBUILD PROFILE تبدأ بالفعل. وتعيدة عناوينها الفرعية صياغته كهدف للقارئ، فلا يحتاج أحد إلى الفكرة الداخلية عن «ملف التعريف» ليعرف ما سيأتي. وتطبّق تسمية الدرجة القاعدة نفسها على رقم. فـ KEYWORD OVERLAP تشير إلى العدّ الحتمي، وMATCH تشير إلى حكم الوكيل.
عرض الإطار يقتطع النصوص الطويلة
تضع الطرفية الشروط. فالنص هو الطبقة الوحيدة التي تشرح شيئًا، ويقتطع الإطار كل ما يطول. وعلى رسالة الخطأ أن تعلن المشكلة والحل في النص نفسه. ولا يستطيع القارئ مغادرة السطر ليقرأ سطرًا آخر.
وتدفع النصوص ثمن سياقها. يبلّغ 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)