技能 pr-description
📝

pr-description

安全 🌐 網路存取⚙️ 外部命令

إنشاء أوصاف شاملة لطلبات السحب

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

支援: Claude Codex Code(CC)
⚠️ 68
1

下載技能 ZIP

2

在 Claude 中上傳

前往 設定 → 功能 → 技能 → 上傳技能

3

開啟並開始使用

測試它

正在使用「pr-description」。 Create a PR description for my refactor that changes session storage to Redis

預期結果:

  • # PR Title: Refactor session storage to use Redis backend
  • ## Summary - 2-3 sentences about the change
  • ## Data Flow Diagram - Mermaid diagram showing session flow
  • ## Changes - List of modified files and why
  • ## Testing - Commands run and results
  • ## Notes for Reviewers - Key areas to focus on

正在使用「pr-description」。 Document a bug fix for the payment processing timeout

預期結果:

  • # PR Title: Fix payment processing timeout bug
  • ## Summary - Problem and solution explained
  • ## Changes - Root cause and fix details
  • ## Testing - Commands run to verify fix
  • ## Edge cases covered - Timeout scenarios tested

正在使用「pr-description」。 Write a PR description for a new API endpoint

預期結果:

  • # PR Title: Add user profile API endpoint
  • ## Summary - Purpose of the new endpoint
  • ## Data Flow - How data flows through the endpoint
  • ## Changes - New files and modifications
  • ## Testing - Integration tests passed

安全審計

安全
v5 • 1/16/2026

Documentation-only skill containing markdown guidance and templates. No executable code exists. Static findings are false positives: the 'weak cryptographic algorithm' detections are SHA-256 hashes in metadata (safe by design), and 'external_commands' detections are markdown code block examples showing testing commands, not actual shell execution. The skill only provides templates and does not access files, git, or networks.

2
已掃描檔案
330
分析行數
2
發現項
5
審計總數
審計者: claude 查看審計歷史 →

品質評分

38
架構
100
可維護性
87
內容
19
社群
100
安全
83
規範符合性

你能建構什麼

توثيق PRs للميزات

إنشاء أوصاف مفصلة لطلبات السحب لِفروع الميزات تساعد المراجعين على فهم التغييرات المعقدة بسرعة.

مراجعة توثيق PR

ضمان أن PRs المقدمة تحتوي على أدلة اختبار كاملة ومخططات وملخصات تغييرات واضحة قبل المراجعة.

توحيد قوالب PR

إرساء معايير توثيق PR متسقة عبر الفريق باستخدام قوالب وإرشادات مدمجة.

試試這些提示

PR لميزة جديدة
أنشئ وصف طلب سحب لميزتي التي تضيف مصادقة المستخدم باستخدام JWT tokens. أدرج مخطط تدفق البيانات ونتائج الاختبار وملاحظات للمراجعين.
PR لإصلاح خطأ
اكتب وصف PR لإصلاح مشكلة مهلة تسجيل الدخول. اعرض ما الذي تغيّر، وكيف تم اختباره، وأي حالات طرفية تم تغطيتها.
PR لإعادة هيكلة
أنشئ وصف PR لإعادة هيكلة استعلامات قاعدة البيانات. أدرج مخطط ER يوضح العلاقات الجديدة وتحسينات الأداء المقاسة.
PR لميزة كبيرة
أنشئ وصف PR شامل لإعادة تصميم نظام الدفع. أدرج تدفق البيانات الكامل وجميع أوامر الاختبار التي تم تشغيلها والتغييرات الكاسرة الملاحظة.

最佳實務

  • أدرج الأوامر الدقيقة التي تم تشغيلها أثناء الاختبار لإثبات أن التغييرات تعمل
  • أضف مخططات Mermaid للتغييرات المعمارية أو البيانية المعقدة
  • اشرح سياق العمل وسبب التغييرات، وليس مجرد ما الذي تغيّر

避免

  • ترك قسم الاختبار فارغا أو بعبارات مبهمة مثل tests passed
  • تخطي مخطط تدفق البيانات للتغييرات المعمارية المعقدة
  • استخدام عناوين عامة مثل Update files بدلا من عناوين PR وصفية

常見問題

ما الأدوات التي تعمل معها هذه المهارة؟
يعمل مع Claude وCodex وClaude Code. يوفر مطالبات وقوالب تعمل في أي مساعد برمجة بالذكاء الاصطناعي.
ما الحد الأقصى لطول وصف PR؟
لا يوجد حد ثابت، ولكن اجعل الأقسام قابلة للمسح البصري باستخدام نقاط تعداد. يجب أن تستخدم الأوصاف الطويلة عناوين للتنقل.
هل يمكنني حفظ أوصاف PR في ملفات؟
نعم، توفر المهارة نمط تسمية: pr_description_<title>_<timestamp>.md. يختار المستخدمون موقع الملف الخاص بهم.
هل يتم الوصول إلى شفرتي أو بياناتي؟
لا. هذه المهارة توفر إرشادات وقوالب فقط. لا تقرأ الملفات ولا تصل إلى مستودعات git ولا تجري اتصالات شبكية.
لماذا أوصاف PR الخاصة بي ليست مفصلة؟
مشكلات شائعة: غياب أوامر الاختبار، عدم وجود مخططات للتغييرات المعقدة، أو عدم شرح سياق العمل. توفر المهارة قوالب لمعالجة هذه الفجوات.
كيف يختلف هذا عن قوالب PR في GitHub؟
قوالب GitHub هي ملفات ثابتة في المستودع. هذه المهارة تُنشئ أوصافا ديناميكية مع مخططات Mermaid وتتكيف مع تغييراتك المحددة.

開發者詳情

檔案結構

📄 SKILL.md