initial commit

.agents/skills/quera-lesson-author/SKILL.md

@@ -0,0 +1,73 @@
+---
+name: quera-lesson-author
+description: >-
+  Use this skill when drafting or refining full document-based lessons (lesson.md)
+  from an approved spec.md file, following Quera College pedagogical and formatting rules.
+---
+
+# Quera Lesson Author (نگارش درس‌نامه‌های متنی کوئرا کالج)
+
+این مهارت راهنمای تبدیل یک سند مشخصات تایید شده (`spec.md`) به متن نهایی و جذاب درس‌نامه (`lesson.md`) است.
+
+---
+
+## چک‌لیست قبل از نگارش
+1. آیا فایل `spec.md` در پوشهٔ درس وجود دارد و اهداف آن مشخص است؟
+2. آیا شیوه‌نامه نگارش فارسی کوئرا (`.agents/rules/quera-styleguide.md`) بررسی شده است؟
+
+---
+
+## ساختار نگارشی درس‌نامه (`lesson.md`)
+
+```markdown
+# [عنوان درس‌نامه]
+
+[مقدمه جذاب و قلاب داستانی: چرا این موضوع برای کسی که می‌خواهد با هوش مصنوعی محصول بسازد حیاتی است؟]
+
+---
+
+## [عنوان بخش اول: مفهوم اصلی به زبان ساده]
+
+[توضیح شفاف همراه با استعاره‌های روزمره و مقایسه‌های ملموس]
+
+```mermaid
+flowchart LR
+    A[ایده اولیه] --> B[پرامپت ساختاریافته]
+    B --> C[کد تولید شده با AI]
+    C --> D[بررسی و تست خروجی]
+```
+
+> [!NOTE]
+> [نکته تکمیلی درباره عملکرد هوش مصنوعی یا پیش‌زمینه مورد نیاز]
+
+---
+
+## [عنوان بخش دوم: پیاده‌سازی عملی و کار با ابزار]
+
+[گام‌های عملی استفاده از ادیتور/ابزار به همراه تصویرسازی ذهنی]
+
+> [!TIP]
+> **پرامپت پیشنهادی برای ادیتور:**
+> ```text
+> [متن دقیق و تمیز پرامپت آماده استفاده]
+> ```
+
+---
+
+## [عنوان بخش سوم: خطرات و توهم‌های رایج هوش مصنوعی]
+
+> [!WARNING]
+> **مراقب این تله باشید:**
+> [توضیح خطایی که ایجنت‌ها ممکن است در این مرحله مرتکب شوند و نحوه هدایت مجدد آن‌ها]
+
+---
+
+## جمع‌بندی و گام بعدی
+
+در این درس یاد گرفتیم که:
+- **نکته ۱:** [خلاصه نکته کلیدی]
+- **نکته ۲:** [خلاصه نکته کلیدی]
+- **نکته ۳:** [خلاصه نکته کلیدی]
+
+> در درس بعدی به سراغ **[عنوان درس بعد]** می‌رویم تا یاد بگیریم چگونه ...
+```