العودة لمهارات الوكيل
المحتوى والتوثيق
مساعد الكتابة التقنية
تحسين جودة التوثيق التقني وتبسيط الشروحات المعقدة للمطورين والمستخدمين.
Claude Code Copilot Cursor Gemini CLI
نظرة عامة
مساعد الكتابة التقنية يستخدم أدوات مثل Vale لتحسين جودة التوثيق التقني والتأكد من اتباع أسلوب كتابة متسق. يفحص القواعد النحوية والأسلوبية ويقترح تحسينات لجعل المحتوى أوضح وأبسط.
يستطيع الوكيل فحص ملفات Markdown ضد قواعد أسلوبية محددة (مثل Google Developer Documentation Style Guide)، اكتشاف الجمل المعقدة واقتراح تبسيطها، والتأكد من استخدام مصطلحات متسقة عبر التوثيق.
مثالية لفرق التوثيق والمطورين الذين يكتبون محتوى تقني ويريدون ضمان جودة واتساق عاليين.
يستطيع الوكيل فحص ملفات Markdown ضد قواعد أسلوبية محددة (مثل Google Developer Documentation Style Guide)، اكتشاف الجمل المعقدة واقتراح تبسيطها، والتأكد من استخدام مصطلحات متسقة عبر التوثيق.
مثالية لفرق التوثيق والمطورين الذين يكتبون محتوى تقني ويريدون ضمان جودة واتساق عاليين.
لمن هذه الأداة؟
- كتاب المحتوى التقني الذين يحسنون جودة التوثيق
- فرق التطوير التي تكتب توثيقاً داخلياً
- مطوري Open Source الذين يكتبون أدلة المستخدم
- فرق تريد أسلوب كتابة تقنية متسق
التثبيت
إعداد Claude Code
brew install vale
vale sync الإعدادات
// .vale.ini
StylesPath = .vale/styles
MinAlertLevel = suggestion
[*.md]
BasedOnStyles = Google, write-good
Google.Passive = warning
write-good.TooWordy = suggestion مهارات مشابهة
المحتوى والتوثيق
توليد التوثيق بـ Markdown
إنشاء توثيق شامل للمشروع تلقائيًا من تعليقات الكود وبنية الملفات.
Claude Code Copilot Cursor
المحتوى والتوثيق توثيق API بمعيار OpenAPI
إنشاء وتحديث مواصفات OpenAPI تلقائيًا مع واجهة تفاعلية لاستكشاف الـ API.
Claude Code Copilot Cursor
المحتوى والتوثيق مولّد ملفات README
إنشاء ملفات README احترافية تلقائيًا مع أقسام التثبيت والاستخدام والمساهمة.
Claude Code Copilot Cursor