Blog Draft

---
name: blog-draft
description: نوشتن پیش‌نویس پست وبلاگ از ایده‌ها و منابع. زمانی استفاده شود که کاربر می‌خواهد پست وبلاگ بنویسد، از پژوهش محتوا تولید کند یا مقاله پیش‌نویس کند. از پژوهش، طوفان فکری، طرح کلی و پیش‌نویس تکراری با کنترل نسخه راهنمایی می‌کند.
---

## ورودی کاربر

```text
$ARGUMENTS
```

**باید** پیش از ادامه، ورودی کاربر را در نظر بگیرید. کاربر باید ارائه دهد:
- **ایده/موضوع**: مفهوم یا مضمون اصلی پست وبلاگ
- **منابع**: نشانی‌ها، فایل‌ها یا ارجاع‌ها برای پژوهش (اختیاری اما توصیه‌شده)
- **مخاطب هدف**: پست وبلاگ برای چه کسی است (اختیاری)
- **لحن/سبک**: رسمی، خودمانی، فنی و غیره (اختیاری)

**مهم**: اگر کاربر درخواست به‌روزرسانی یک **پست وبلاگ موجود** را دارد، از گام‌های ۰ تا ۸ بگذرید و مستقیماً از **گام ۹** شروع کنید. ابتدا فایل(های) پیش‌نویس موجود را بخوانید، سپس فرایند تکرار را ادامه دهید.

## جریان اجرا

این گام‌ها را به ترتیب دنبال کنید. **گام‌ها را رد نکنید و بدون تأیید کاربر (در جایی که مشخص شده) ادامه ندهید.**

### گام ۰: ایجاد پوشه پروژه

1. نام پوشه را با قالب `YYYY-MM-DD-short-topic-name` تولید کنید
   - از تاریخ امروز استفاده کنید
   - از موضوع یک نامک کوتاه و مناسب نشانی (حروف کوچک، خط تیره، حداکثر ۵ واژه) بسازید

2. ساختار پوشه را ایجاد کنید:
   ```
   blog-posts/
   └── YYYY-MM-DD-short-topic-name/
       └── resources/
   ```

3. پیش از ادامه، ایجاد پوشه را با کاربر تأیید کنید.

### گام ۱: پژوهش و جمع‌آوری منابع

1. زیرپوشه `resources/` را در دایرکتوری پست وبلاگ ایجاد کنید

2. برای هر منبع ارائه‌شده:
   - **نشانی‌ها**: اطلاعات کلیدی را دریافت و به‌صورت فایل‌های مارک‌داون در `resources/` ذخیره کنید
   - **فایل‌ها**: بخوانید و در `resources/` خلاصه کنید
   - **موضوعات**: برای گردآوری اطلاعات به‌روز از جست‌وجوی وب استفاده کنید

3. برای هر منبع، یک فایل خلاصه در `resources/` بسازید:
   - `resources/source-1-[short-name].md`
   - `resources/source-2-[short-name].md`
   - و غیره.

4. هر خلاصه باید شامل موارد زیر باشد:
   ```markdown
   # منبع: [عنوان/نشانی]

   ## نکات کلیدی
   - نکته ۱
   - نکته ۲

   ## نقل‌قول‌ها/داده‌های مرتبط
   - نقل‌قول یا آمار ۱
   - نقل‌قول یا آمار ۲

   ## ارتباط با موضوع
   توضیح مختصر درباره ارتباط
   ```

5. خلاصه پژوهش را به کاربر ارائه دهید.

### گام ۲: طوفان فکری و شفاف‌سازی

1. بر اساس ایده و منابع پژوهش‌شده، ارائه دهید:
   - **مضامین اصلی** شناسایی‌شده از پژوهش
   - **زاویه‌های بالقوه** برای پست وبلاگ
   - **نکات کلیدی** که باید پوشش داده شوند
   - **شکاف‌های** اطلاعاتی که نیاز به شفاف‌سازی دارند

2. پرسش‌های شفاف‌ساز بپرسید:
   - نکته اصلی که می‌خواهید خوانندگان با آن روبه‌رو شوند چیست؟
   - آیا نکات مشخصی از پژوهش هست که می‌خواهید برجسته کنید؟
   - طول هدف چیست؟ (کوتاه: ۵۰۰ تا ۸۰۰ واژه، متوسط: ۱۰۰۰ تا ۱۵۰۰، بلند: بیش از ۲۰۰۰)
   - آیا نکاتی هست که می‌خواهید حذف کنید؟

3. **پیش از ادامه، منتظر پاسخ‌های کاربر بمانید.**

### گام ۳: پیشنهاد طرح کلی

1. یک طرح کلی ساختاریافته ایجاد کنید شامل:

   ```markdown
   # طرح کلی پست وبلاگ: [عنوان]

   ## اطلاعات فراداده
   - **مخاطب هدف**: [چه کسی]
   - **لحن**: [سبک]
   - **طول هدف**: [تعداد واژه]
   - **نکته اصلی**: [پیام کلیدی]

   ## ساختار پیشنهادی

   ### قلاب/مقدمه
   - ایده قلاب آغازین
   - زمینه‌سازی
   - بیان تز

   ### بخش ۱: [عنوان]
   - نکته کلیدی الف
   - نکته کلیدی ب
   - شواهد پشتیبان از [منبع]

   ### بخش ۲: [عنوان]
   - نکته کلیدی الف
   - نکته کلیدی ب

   [برای همه بخش‌ها ادامه دهید...]

   ### نتیجه‌گیری
   - خلاصه نکات کلیدی
   - فراخوان به اقدام یا اندیشه پایانی

   ## منابع برای استناد
   - منبع ۱
   - منبع ۲
   ```

2. طرح کلی را به کاربر ارائه دهید و **درخواست تأیید یا اصلاح کنید**.

### گام ۴: ذخیره طرح کلی تأییدشده

1. پس از تأیید طرح کلی توسط کاربر، آن را در فایل `OUTLINE.md` در پوشه پست وبلاگ ذخیره کنید.

2. تأیید کنید که طرح کلی ذخیره شده است.

### گام ۵: ثبت طرح کلی (در صورت وجود مخزن git)

1. بررسی کنید که آیا دایرکتوری فعلی یک مخزن git است.

2. اگر بله:
   - فایل‌های جدید را مرحله‌بندی کنید: پوشه پست وبلاگ، منابع و OUTLINE.md
   - یک کامیت با پیام `docs: Add outline for blog post - [topic-name]` بسازید
   - به مخزن راه دور ارسال کنید

3. اگر مخزن git نیست، از این گام بگذرید و کاربر را مطلع کنید.

### گام ۶: نوشتن پیش‌نویس

1. بر اساس طرح کلی تأییدشده، پیش‌نویس کامل پست وبلاگ را بنویسید.

2. دقیقاً از ساختار OUTLINE.md پیروی کنید.

3. شامل کنید:
   - مقدمه‌ای جذاب با قلاب
   - سرتیترهای بخش شفاف
   - شواهد و مثال‌های پشتیبان از پژوهش
   - گذارهای روان بین بخش‌ها
   - نتیجه‌گیری قوی با نکته کلیدی
   - **استنادها**: همه مقایسه‌ها، آمارها، نقاط داده و ادعاهای واقعی **باید** به منبع اصلی استناد دهند

4. پیش‌نویس را با نام `draft-v0.1.md` در پوشه پست وبلاگ ذخیره کنید.

5. قالب:
   ```markdown
   # [عنوان پست وبلاگ]

   *[اختیاری: زیرعنوان یا شعار]*

   [محتوای کامل با استنادهای درون‌خطی...]

   ---

   ## منابع
   - [1] عنوان منبع ۱ - نشانی یا استناد
   - [2] عنوان منبع ۲ - نشانی یا استناد
   - [3] عنوان منبع ۳ - نشانی یا استناد
   ```

6. **الزامات استناد**:
   - هر نقطه داده، آمار یا مقایسه **باید** استناد درون‌خطی داشته باشد
   - از ارجاع‌های شماره‌دار [1]، [2] و غیره یا استنادهای نام‌دار [نام منبع] استفاده کنید
   - استنادها را به بخش منابع در انتها پیوند دهید
   - مثال: «پژوهش‌ها نشان می‌دهند ۶۵٪ توسعه‌دهندگان TypeScript را ترجیح می‌دهند [1]»
   - مثال: «React در سرعت رندر ۲۰٪ از Vue پیشی می‌گیرد [React Benchmarks 2024]»

### گام ۷: ثبت پیش‌نویس (در صورت وجود مخزن git)

1. بررسی کنید که در مخزن git هستید.

2. اگر بله:
   - فایل پیش‌نویس را مرحله‌بندی کنید
   - یک کامیت با پیام `docs: Add draft v0.1 for blog post - [topic-name]` بسازید
   - به مخزن راه دور ارسال کنید

3. اگر مخزن git نیست، بگذرید و کاربر را مطلع کنید.

### گام ۸: ارائه پیش‌نویس برای بازبینی

1. محتوای پیش‌نویس را به کاربر ارائه دهید.

2. بازخورد بخواهید:
   - برداشت کلی؟
   - بخش‌هایی که نیاز به گسترش یا کاهش دارند؟
   - تنظیمات لحن لازم است؟
   - اطلاعات مفقود؟
   - ویرایش یا بازنویسی مشخص؟

3. **منتظر پاسخ کاربر بمانید.**

### گام ۹: تکرار یا نهایی‌سازی

**اگر کاربر درخواست تغییر کند:**
1. همه اصلاحات درخواستی را یادداشت کنید
2. با تنظیمات زیر به گام ۶ بازگردید:
   - شماره نسخه را افزایش دهید (v0.2، v0.3 و غیره)
   - همه بازخوردها را اعمال کنید
   - با نام `draft-v[X.Y].md` ذخیره کنید
   - گام‌های ۷ و ۸ را تکرار کنید

**اگر کاربر تأیید کند:**
1. نسخه نهایی پیش‌نویس را تأیید کنید
2. در صورت درخواست کاربر، به‌صورت اختیاری به `final.md` تغییر نام دهید
3. فرایند ایجاد پست وبلاگ را خلاصه کنید:
   - تعداد کل نسخه‌های ساخته‌شده
   - تغییرات کلیدی بین نسخه‌ها
   - تعداد واژه نهایی
   - فایل‌های ایجادشده

## پیگیری نسخه

همه پیش‌نویس‌ها با نسخه‌بندی افزایشی نگه داشته می‌شوند:
- `draft-v0.1.md` - پیش‌نویس اولیه
- `draft-v0.2.md` - پس از نخستین دور بازخورد
- `draft-v0.3.md` - پس از دومین دور بازخورد
- و غیره.

این امکان پیگیری تحول پست وبلاگ و بازگشت در صورت نیاز را فراهم می‌کند.

## ساختار فایل‌های خروجی

```
blog-posts/
└── YYYY-MM-DD-topic-name/
    ├── resources/
    │   ├── source-1-name.md
    │   ├── source-2-name.md
    │   └── ...
    ├── OUTLINE.md
    ├── draft-v0.1.md
    ├── draft-v0.2.md (در صورت تکرار)
    └── draft-v0.3.md (در صورت تکرار بیشتر)
```

## نکاتی برای کیفیت

- **قلاب**: با یک پرسش، واقعیت غافلگیرکننده یا موقعیت قابل هم‌ذات‌پنداری شروع کنید
- **جریان**: هر بند باید به بند بعدی متصل شود
- **شواهد**: ادعاها را با داده‌های پژوهش پشتیبانی کنید
- **استنادها**: **همیشه** برای موارد زیر به منبع استناد دهید:
  - همه آمارها و نقاط داده (مثلاً «بر اساس [منبع]، ۷۵٪ از...»)
  - مقایسه بین محصولات، خدمات یا رویکردها (مثلاً «X دو برابر سریع‌تر از Y عمل می‌کند [منبع]»)
  - ادعاهای واقعی درباره روندهای بازار، یافته‌های پژوهش یا محک‌ها
  - از استناد درون‌خطی با قالب [نام منبع] یا [نویسنده، سال] استفاده کنید
- **صدا**: لحن یکنواخت را در سراسر متن حفظ کنید
- **طول**: تعداد واژه هدف را رعایت کنید
- **خوانایی**: از بندهای کوتاه و فهرست‌های نقطه‌ای در جای مناسب استفاده کنید
- **فراخوان به اقدام**: با یک فراخوان شفاف یا پرسشی اندیشه‌برانگیز پایان دهید

## یادداشت‌ها

- همیشه در نقاط بازرسی مشخص‌شده منتظر تأیید کاربر بمانید
- همه نسخه‌های پیش‌نویس را برای تاریخچه نگه دارید
- وقتی نشانی ارائه می‌شود، برای اطلاعات به‌روز از جست‌وجوی وب استفاده کنید
- اگر منابع ناکافی هستند، منابع بیشتر از کاربر بخواهید یا پژوهش تکمیلی پیشنهاد دهید
- لحن را بر اساس مخاطب هدف تنظیم کنید (فنی، عمومی، کسب‌وکار و غیره)

---

**آخرین به‌روزرسانی**: ۴ اوت ۲۰۲۶
**نسخه Claude Code**: 2.1.220
**منابع**:
- https://code.claude.com/docs/en/skills
**مدل‌های سازگار**: Claude Fable 5.2, Claude Fable 5.1, Claude Fable 5, Claude Opus 5.5, Claude Opus 5, Claude Sonnet 5.5, Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 5.5, Claude Haiku 4.5