skill
إعداد الرواتب
يجهز كشف الراتب للتشغيل دون أن يحرم أحد من حقوقه: يسحب بيانات الحضور والغياب من Gusto أو QuickBooks Payroll أو جدول بيانات محمل، ويجمع ساعات العمل العادية والإضافية والإجازات المدفوعة لكل موظف، ويعلم كل التناقضات التي يكتشفها — الضربات المفقودة والارتفاعات المفاجئة في الساعات الإضافية وتغييرات الأجور والتعيينات والإنهاءات الوسط-دورية والساعات خارج الجدول — ويحضر العملية لموافقة المالك سطرا تلو الآخر قبل تحرك أي مبلغ. يتم دائما رفع التناقضات، لا تصحح بصمت. بعد أن يشغل المالك النظام، يتم إنشاء بنود دفتر اليومية...
نبذة
# تحضير الرواتب
احصل على الساعات الصحيحة قبل أن يتقاضى أي شخص راتبه.
الرواتب هي سير العمل المالي الذي لا يترك مجالا للخطأ. فاتورة خاطئة تصحح في الأسبوع القادم. راتب خاطئ هو شخص لا يستطيع دفع الإيجار، وهي أسرع طريقة لصاحب العمل لفقدان فريقه. كل شيء في هذه المهارة مبني حول هذا عدم التوازن: الآلة تجمع وتتحقق، صاحب العمل يقرر.
## الخطوة 1 — حل مشكلة الفترة قبل أي شيء آخر
تأكد من تواريخ بدء وانتهاء فترة الدفع وتاريخ الدفع ومن هو مشمول في هذا الدفع. الخطأ في الفترة يكرر أو يتخطى أسبوع راتب أحدهم، وهو خطأ سهل الحدوث بشكل مفاجئ عندما تقع فترة ما بين نهاية الشهر.
تأكد من قائمة الموظفين أيضا: الموظفون الجدد الذين بدأوا في منتصف الفترة، أي شخص تم إنهاء خدمته، أي شخص في إجازة. انظر إلى `reference/timesheet_intake.md`.
## الخطوة 2 — احصل على جداول الوقت
**مع توصيل Gusto**، أولا اسأل Gusto نفسه ما الذي يعوق الطريق: استدع فحص حجب الرواتب فيه (`list_payroll_blockers`) قبل بناء أي شيء. إذا عادت عوائق، ترجم كل واحدة إلى لغة إنجليزية واضحة — ماذا تعني، من يصلحها، وأين. على سبيل المثال: "check payments unsupported" يعني أن هذه الشركة تدفع بشيك ورقي، وهو ما لا يمكن للتكامل أن يرحله، لذا يقوم صاحب العمل بهذا الجزء مباشرة في Gusto؛ "bank account not connected via Plaid" يعني أن صاحب العمل يوصل البنك في إعدادات Gusto؛ "hourly employees unsupported" قد تحجب على مستوى الحساب حتى عندما يكون هذا الدفع برواتب فقط. العوائق هي إشارة توجيه، وليست فشلا — الدفع بني وتحقق منه هنا على أي حال، والمسلمة تصبح ورقة الدفع مع قائمة العوائق مرفقة.
ثم احصل على مدخلات الفترة، كل واحدة من أداتها الخاصة. **الساعات:** `list_time_records` لفترة الدفع؛ اقرأ حقل `source` فيه قبل أي شيء آخر. `native` يعيد الورديات مع ساعة البدء والانتهاء والفترات؛ `third_party` يعيد جداول الوقت من شريك تتبع الوقت لدى الشركة، و `get_time_sheet` يعطي بنود السطر لكل يوم من أي واحدة منها (يرفض معرفات الورديات الأصلية)؛ `none` يعني أن Gusto لا يمسك بساعات لهذه الشركة، لذا مسار جدول البيانات أدناه يوفرها. **الإجازات:** `list_time_off_requests` للفترة مع `status: approved` — كل يوم معتمد يدفع كإجازة أو إجازة مرضية، وليس أبدا كيوم عمل، وطلب معلق هو علم، وليس يوم مدفوع. **الأرصدة:** `get_time_off_balances`، وهو ما يقرأه فحص "PTO beyond available balance" في الخطوة 4. **المعدلات والتصنيفات:** قائمة الموظفين من `list_employees` مع تعويضات كل شخص. تأتي المعدلات من Gusto، وليس من جدول الوقت أبدا. أشكال الاستدعاء لهذه موجودة في `../../shared/connector-call-shapes.md`.
**توقيع مفقود يمكن لصاحب العمل ملؤه.** عندما تعلم الخطوة 4 عن وردية بلا ساعة انتهاء وصاحب العمل يعطي الأوقات الفعلية، `record_time` يكتبها — فقط الأوقات التي ذكرها صاحب العمل، معروضة لهم أولا، وكـ `update` للوردية الموجودة بدلا من إدخال ثان. المعاملات التي ترفض إذا كانت مفقودة (المنطقة الزمنية، الوظيفة على تتبع Gusto الخاص، معرف أي عنصر يعتبر الوردية) والفخ الذي يقرأ مرة أخرى (ساعات العامل المقاول المؤكدة تعود بأوقات توقيع فارغة؛ لا تكتب مرة أخرى) موجودة في صف `record_time` من `../../shared/connector-call-shapes.md`. اقرأ هذا الصف قبل الاستدعاء. هذه هي الطريقة الوحيدة التي تغير بها المهارة توقيعا؛ وقت مفترض لا يكتب أبدا.
**ثم أثبت أن المصدر يعيد بيانات المصدر قبل أن يتم رحل أي شيء.** احصل على قائمة الموظفين (`list_employees`) والجداول الزمنية (`list_pay_schedules`). شركة تبلغ عن عدد الموظفين بينما أي من هذه القوائم يعود فارغا، أو استدعاء حجب يرجع خطأ بدلا من الإجابة، هي مصدر رواتب متصل لكن غير مسلم. توقف عن مسار الرحل، قل ذلك في سطر واحد ("Gusto is connected but returned no employees or pay schedules, so I cannot stage a run against it")، وقدم مسار جدول البيانات أدناه. لا تبني أبدا دفعة من قائمة موظفين فارغة، ولا تتعامل أبدا مع شارة الاتصال الأخضر كإثبات على أن البيانات موجودة.
**مع توصيل QuickBooks Payroll**، احصل على نفس الحقول من هناك. فشلان مختلفان يبدوان متشابهان هنا، وصاحب العمل يسمعهما بشكل مختلف. **مصدر فارغ** (قوائم Gusto تعود بلا صفوف على شركة تبلغ عن عدد موظفين) هو فجوة بيانات: قل ذلك واستخدم ورقة الدفع. **مصدر يناقض نفسه** هو عيب في الأداة: `qbo_payroll_get_company_payroll_readiness` يجيب `has_employees: false` و `run_payroll_ready: false` بينما `qbo_payroll_get_employees` على نفس الشركة يعيد `total_count` من 50 لا يمكن أن يكونا صحيحين معا. هذا مستقل عن حجم البيانات التي تمتلكها الشركة. عندما يحدث ذلك، استخدم قائمة الموظفين للقائمة (هو الاستدعاء الذي أعاد الصفوف)، لا ترحل دفعة بينما الجاهزية تقول غير جاهز، وقل كلا الرقمين لصاحب العمل في سطر واحد حتى يكون التناقض مسجلا بدلا من أن يكون مخفيا وراء "not ready". ثم خذ مسار جدول البيانات أدناه مع هذه القائمة: ورقة دفع متحققة منها يدخلها صاحب العمل في QuickBooks Payroll هي النتيجة، نفس الشيء بالنسبة لمصدر فارغ. هذا مصدر من الدرجة الأولى، وليس
التثبيت
شغل هذا الأمر
git clone https://github.com/anthropics/knowledge-work-plugins && cp -r knowledge-work-plugins/small-business/skills/payroll-prep ~/.claude/skills/يعمل مع
خطوات التثبيت
استنسخ المستودع وانسخ مجلد `small-business/skills/payroll-prep` إلى دليل مهارات Claude الخاص بك. متوافق مع Claude Code و Cursor و Codex وأي وكيل متوافق مع Agent Skills.
أسئلة شائعة
ما هي مهارة إعداد الرواتب؟
يجهز كشف الراتب للتشغيل دون أن يحرم أحد من حقوقه: يسحب بيانات الحضور والغياب من Gusto أو QuickBooks Payroll أو جدول بيانات محمل، ويجمع ساعات العمل العادية والإضافية والإجازات المدفوعة لكل موظف، ويعلم كل التناقضات التي يكتشفها — الضربات المفقودة والارتفاعات المفاجئة في الساعات الإضافية وتغييرات الأجور والتعيينات والإنهاءات الوسط-دورية والساعات خارج الجدول — ويحضر العملية لموافقة المالك سطرا تلو الآخر قبل تحرك أي مبلغ…
كيف أثبت إعداد الرواتب؟
شغل هذا الأمر في الطرفية:
git clone https://github.com/anthropics/knowledge-work-plugins && cp -r knowledge-work-plugins/small-business/skills/payroll-prep ~/.claude/skills/مع أي أدوات ذكاء اصطناعي تعمل إعداد الرواتب؟
تعمل مع claude_app، claude_code، claude_api، cursor، codex، windsurf، cline، zed.
من طور إعداد الرواتب؟
طورها Anthropic، وتصدر بترخيص Apache-2.0.
هل إعداد الرواتب مجانية؟
نعم، يمكنك استخدامها مجانا وفق ترخيص Apache-2.0.
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
الظهور في الذكاء الاصطناعي
منشئ البيانات المنظمة
الظهور في الذكاء الاصطناعي
مقياس سهولة القراءة بالعربية
جودة المحتوى
حاسبة تكاليف الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
محلل العناوين العربية
جودة المحتوى