يُستخدم عند اتخاذ قرارات معمارية، أو تغيير واجهات برمجة التطبيقات العامة، أو ميزات الشحن، أو عندما تحتاج إلى تسجيل السياق الذي سيحتاجه المهندسون والوكلاء المستقبليون لفهم قاعدة التعليمات البرمجية.
ثبّت مهارة الذكاء الاصطناعي documentation-and-adrs بسرعة في بيئة التطوير لديك عبر سطر الأوامر
المصدر: addyosmani/agent-skills.
Document decisions, not just code. The most valuable documentation captures the why — the context, constraints, and trade-offs that led to a decision. Code shows what was built; documentation explains why it was built this way and what alternatives were considered. This context is essential for future humans and agents working in the codebase.
When NOT to use: Don't document obvious code. Don't add comments that restate what the code already says. Don't write docs for throwaway prototypes.
ADRs capture the reasoning behind significant technical decisions. They're the highest-value documentation you can write.
يُستخدم عند اتخاذ قرارات معمارية، أو تغيير واجهات برمجة التطبيقات العامة، أو ميزات الشحن، أو عندما تحتاج إلى تسجيل السياق الذي سيحتاجه المهندسون والوكلاء المستقبليون لفهم قاعدة التعليمات البرمجية. المصدر: addyosmani/agent-skills.
حقول وأوامر مستقرة للاقتباس في أنظمة الذكاء الاصطناعي والبحث.
npx skills add https://github.com/addyosmani/agent-skills --skill documentation-and-adrsيُستخدم عند اتخاذ قرارات معمارية، أو تغيير واجهات برمجة التطبيقات العامة، أو ميزات الشحن، أو عندما تحتاج إلى تسجيل السياق الذي سيحتاجه المهندسون والوكلاء المستقبليون لفهم قاعدة التعليمات البرمجية. المصدر: addyosmani/agent-skills.
افتح الطرفية أو أداة سطر الأوامر لديك مثل Terminal أو iTerm أو Windows Terminal انسخ ونفّذ هذا الأمر: npx skills add https://github.com/addyosmani/agent-skills --skill documentation-and-adrs بعد التثبيت، سيتم إعداد المهارة تلقائيا في بيئة البرمجة بالذكاء الاصطناعي لديك وتصبح جاهزة للاستخدام في Claude Code أو Cursor أو OpenClaw
https://github.com/addyosmani/agent-skills