---
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]
> **مراقب این تله باشید:**
> [توضیح خطایی که ایجنت‌ها ممکن است در این مرحله مرتکب شوند و نحوه هدایت مجدد آن‌ها]

---

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

در این درس یاد گرفتیم که:
- **نکته ۱:** [خلاصه نکته کلیدی]
- **نکته ۲:** [خلاصه نکته کلیدی]
- **نکته ۳:** [خلاصه نکته کلیدی]

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