74 lines
2.6 KiB
Markdown
74 lines
2.6 KiB
Markdown
---
|
||
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]
|
||
> **مراقب این تله باشید:**
|
||
> [توضیح خطایی که ایجنت‌ها ممکن است در این مرحله مرتکب شوند و نحوه هدایت مجدد آن‌ها]
|
||
|
||
---
|
||
|
||
## جمع‌بندی و گام بعدی
|
||
|
||
در این درس یاد گرفتیم که:
|
||
- **نکته ۱:** [خلاصه نکته کلیدی]
|
||
- **نکته ۲:** [خلاصه نکته کلیدی]
|
||
- **نکته ۳:** [خلاصه نکته کلیدی]
|
||
|
||
> در درس بعدی به سراغ **[عنوان درس بعد]** می‌رویم تا یاد بگیریم چگونه ...
|
||
```
|