72 lines
4.0 KiB
Markdown
72 lines
4.0 KiB
Markdown
---
|
||
name: course-sdd-planner
|
||
description: >-
|
||
Use this skill when planning, structuring, or generating specification documents (spec.md)
|
||
for chapters and lessons in the Vibe Coding course for Quera College.
|
||
---
|
||
|
||
# Course SDD Planner (طراحی و تدوین مشخصات درس‌نامه‌ها)
|
||
|
||
این مهارت راهنمای تدوین سند مشخصات (`spec.md`) برای هر درس‌نامه در متدولوژی Spec-Driven Development است. قبل از نوشتن هرگونه محتوای متنی، باید این سند ایجاد و تایید شود.
|
||
|
||
---
|
||
|
||
## ساختار فایل `spec.md` برای درس‌نامه‌ها
|
||
|
||
هر درس‌نامه باید در مسیر `chapters/ch<XX>-<name>/<YY>-<slug>/spec.md` دارای این قالب باشد:
|
||
|
||
```markdown
|
||
# مشخصات درس‌نامه: [عنوان درس‌نامه]
|
||
- **شناسه در سیلابس:** L<X>.<Y>
|
||
- **فصل:** [شماره و نام فصل]
|
||
- **نوع محتوا:** 📘 درس‌نامه متنی
|
||
- **زمان تقریبی مطالعه:** [مثلاً ۱۰ دقیقه]
|
||
- **پیش‌نیازهای مستقیم:** [شناسه درس‌های قبلی یا "ندارد"]
|
||
|
||
---
|
||
|
||
## ۱. اهداف یادگیری (Learning Objectives - Bloom's Taxonomy)
|
||
دانشجو پس از مطالعهٔ این درس باید بتواند:
|
||
- [ ] **درک کند (Understand):** [مفهوم کلیدی ۱]
|
||
- [ ] **به‌کار ببندد (Apply):** [مهارت یا پرامپت عملی ۱]
|
||
- [ ] **تحلیل/ارزیابی کند (Evaluate):** [تشخیص خروجی صحیح از خطای هوش مصنوعی]
|
||
|
||
---
|
||
|
||
## ۲. محدوده و مرزهای محتوا (Scope & Boundaries)
|
||
- **آنچه باید پوشش داده شود (In-Scope):**
|
||
- نکته الف
|
||
- نکته ب
|
||
- **آنچه نباید وارد آن شویم (Out-of-Scope - جلوگیری از سردرگمی):**
|
||
- مباحث پیچیده و نامرتبط که جلوتر تدریس می‌شوند.
|
||
|
||
---
|
||
|
||
## ۳. مفاهیم کلیدی و کلمات تخصصی (Key Concepts & Terms)
|
||
| اصطلاح انگلیسی | معادل فارسی مصوب | توضیح یک‌خطی ساده |
|
||
| :--- | :--- | :--- |
|
||
| Prompt | پرامپت (درخواست/دستور) | پیامی که به هوش مصنوعی می‌دهیم تا خروجی تولید کند |
|
||
|
||
---
|
||
|
||
## ۴. جایگاه‌های تصاویر و نمودارها (Visual & Diagram Placeholders)
|
||
> **نکته:** در تدوین مشخصات، نیازی به طراحی پرامپت تصویر یا کد دیاگرام نیست. صرفاً مکان، نام فایل پیشنهادی و شرح کوتاهی از آنچه باید به تصویر کشیده شود مشخص می‌گردد تا ایجنت نویسنده با ابزارهای خود (پکیج diagrams یا قالب SVG) آن را بسازد.
|
||
- **تصویر کاور:** `images/cover.png` — [شرح مختصر ایده بصری کاور درس‌نامه]
|
||
- **نمودار ۱:** `images/[diagram-slug-1].png` — **موضوع:** [شرح مختصر از مفهوم، چرخه، معماری یا فرآیندی که باید ترسیم شود]
|
||
- **نمودار ۲:** `images/[diagram-slug-2].png` — **موضوع:** [شرح مختصر از مفهوم یا مقایسه بصری]
|
||
|
||
---
|
||
|
||
## ۵. پرامپت‌ها و ابزارهای مورد استفاده در درس
|
||
- **ابزار هدف:** (Cursor / Claude Code / Lovable / Supabase / ...)
|
||
- **پرامپت طلایی نمونه:** [متن پرامپت پیشنهادی که در درس آموزش داده می‌شود]
|
||
|
||
---
|
||
|
||
## ۶. معیارهای پذیرش درس‌نامه (Acceptance Criteria)
|
||
- [ ] آیا لحن صمیمی و ساده برای غیربرنامه‌نویسان رعایت شده است؟
|
||
- [ ] آیا اصطلاحات انگلیسی به همراه معادل فارسی آورده شده‌اند؟
|
||
- [ ] آیا حداقل یک باکس هشدار توهم هوش مصنوعی یا نکته طلایی وجود دارد؟
|
||
- [ ] آیا پرامپت نمونه تست‌شده و بدون خطا کار می‌کند؟
|
||
```
|