vibe-coding-college-specs/.agents/skills/quera-lesson-author/SKILL.md

name, description

name	description
quera-lesson-author	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)

# [عنوان درس‌نامه]

[مقدمه جذاب و قلاب داستانی: چرا این موضوع برای کسی که می‌خواهد با هوش مصنوعی محصول بسازد حیاتی است؟]

---

## [عنوان بخش اول: مفهوم اصلی به زبان ساده]

[توضیح شفاف همراه با استعاره‌های روزمره و مقایسه‌های ملموس]

```mermaid
flowchart LR
    A[ایده اولیه] --> B[پرامپت ساختاریافته]
    B --> C[کد تولید شده با AI]
    C --> D[بررسی و تست خروجی]

Note

[نکته تکمیلی درباره عملکرد هوش مصنوعی یا پیش‌زمینه مورد نیاز]

---

[عنوان بخش دوم: پیاده‌سازی عملی و کار با ابزار]

[گام‌های عملی استفاده از ادیتور/ابزار به همراه تصویرسازی ذهنی]

Tip

پرامپت پیشنهادی برای ادیتور:

[متن دقیق و تمیز پرامپت آماده استفاده]

---

[عنوان بخش سوم: خطرات و توهم‌های رایج هوش مصنوعی]

Warning

مراقب این تله باشید: [توضیح خطایی که ایجنت‌ها ممکن است در این مرحله مرتکب شوند و نحوه هدایت مجدد آن‌ها]

---

جمع‌بندی و گام بعدی

در این درس یاد گرفتیم که:

• نکته ۱: [خلاصه نکته کلیدی]
• نکته ۲: [خلاصه نکته کلیدی]
• نکته ۳: [خلاصه نکته کلیدی]

در درس بعدی به سراغ [عنوان درس بعد] می‌رویم تا یاد بگیریم چگونه ...