146 lines
5.0 KiB
Markdown
146 lines
5.0 KiB
Markdown
---
|
|
name: prompt-writer
|
|
description: تولید فایل پرامپت .md برای یک قابلیت یا باگفیکس در پروژه ClinicPro. استفاده کن وقتی کاربر میگوید «یک پرامپت بنویس»، «پرامپت بساز»، «write a prompt»، «برام پرامپت بنویس برای X». این skill پروژه را تحلیل میکند، سپس یک فایل .md کامل در .claude/prompt/ میسازد و دستور اجرا را نمایش میدهد.
|
|
---
|
|
|
|
## نحوه دریافت ورودی
|
|
|
|
کاربر موضوع یا مشکل را توضیح میدهد. اگر توضیح کافی نبود، یک سوال کوتاه بپرس.
|
|
|
|
---
|
|
|
|
## مراحل اجرا
|
|
|
|
### مرحله ۱ — درک موضوع
|
|
|
|
قبل از نوشتن پرامپت:
|
|
|
|
1. **موضوع را تحلیل کن**: باگفیکس است یا قابلیت جدید؟
|
|
2. **فایلهای مرتبط را شناسایی کن**:
|
|
- Backend: `src/` — Controllers، Services، Entities، Repositories
|
|
- Frontend: `assets/admin/pages/`، `assets/admin/components/`
|
|
- مستندات: `docs/api/`
|
|
3. **APIهای موجود را بررسی کن**: `ddev exec php bin/console debug:router | grep api`
|
|
4. **کد مرتبط را بخوان**: فقط فایلهایی که مستقیم به موضوع مربوطند
|
|
|
|
### مرحله ۲ — نامگذاری فایل
|
|
|
|
نام فایل: `kebab-case`، توصیفی، کوتاه.
|
|
|
|
مثالها:
|
|
- `fix-invitation-accept.md`
|
|
- `doctor-dashboard-stats.md`
|
|
- `clinic-gallery-upload.md`
|
|
- `appointment-sms-notification.md`
|
|
|
|
### مرحله ۳ — ساخت فایل پرامپت
|
|
|
|
فایل را در `.claude/prompt/<name>.md` بساز با این ساختار:
|
|
|
|
---
|
|
|
|
```markdown
|
|
# <عنوان واضح>
|
|
|
|
## زمینه
|
|
|
|
<یک پاراگراف: چرا این تغییر لازم است؟ وضعیت فعلی چیست؟>
|
|
|
|
## مشکل / هدف
|
|
|
|
<توضیح دقیق مشکل یا قابلیت مورد نیاز>
|
|
|
|
## فایلهای مرتبط
|
|
|
|
| فایل | نقش |
|
|
|------|-----|
|
|
| `src/...` | ... |
|
|
| `assets/admin/...` | ... |
|
|
|
|
## وضعیت فعلی
|
|
|
|
<کد یا رفتار فعلی — فقط بخش مرتبط>
|
|
|
|
```php / tsx
|
|
// کد فعلی مشکلدار یا ناقص
|
|
```
|
|
|
|
## وظایف
|
|
|
|
### ۱. <اولین وظیفه>
|
|
|
|
<توضیح دقیق + راهحل پیشنهادی>
|
|
|
|
```php / tsx
|
|
// نمونه کد یا pseudocode
|
|
```
|
|
|
|
### ۲. <دومین وظیفه>
|
|
|
|
...
|
|
|
|
## نکات مهم
|
|
|
|
- <نکته معماری یا محدودیت مهم>
|
|
- <edge case که باید پوشش داده شود>
|
|
- <الگوی پروژه که باید رعایت شود>
|
|
```
|
|
|
|
---
|
|
|
|
### قوانین محتوای پرامپت
|
|
|
|
**باید داشته باشد:**
|
|
- مسیر دقیق فایلهایی که باید تغییر کنند
|
|
- وضعیت فعلی کد (کپی از کد واقعی، نه توصیف کلی)
|
|
- راهحل پیشنهادی با نمونه کد
|
|
- edge caseها
|
|
- الگوهای پروژه که باید رعایت شوند (BaseController، TanStack Query، Zod، ...)
|
|
|
|
**نباید داشته باشد:**
|
|
- توضیحات کلی و بدیهی
|
|
- کدی که از پروژه واقعی کپی نشده
|
|
- وظایف نامشخص مثل «بررسی کن» بدون مشخص کردن چه چیزی
|
|
|
|
**قوانین خاص پروژه که باید در پرامپت منعکس شود:**
|
|
- Backend: همه controllerها از `BaseController` ارث میبرند؛ پاسخها با `$this->success()` / `$this->paginated()` / `$this->error()`
|
|
- Frontend paginated: items از `data?.data`، total از `data?.meta?.totalRecords`
|
|
- Frontend single: از `data?.data` (ممکن است double-nested باشد)
|
|
- Category API: triple-nested → `data?.data?.data ?? []`
|
|
- تاریخها: Unix timestamp صحیح؛ نمایش با `formatDate()` شمسی
|
|
- اگر Entity تغییر کرد: migration لازم است
|
|
- مستندات: بعد از هر تغییر API، فایل مربوطه در `docs/api/` باید بهروز شود
|
|
|
|
### مرحله ۴ — خروجی نهایی
|
|
|
|
بعد از ساخت فایل، فقط این سه مورد را نمایش بده:
|
|
|
|
```
|
|
توضیح: <یک جمله توصیف پرامپت>
|
|
فایل پرامپت: .claude/prompt/<name>.md
|
|
دستور اجرا:
|
|
|
|
/run-prompt .claude/prompt/<name>.md
|
|
```
|
|
|
|
---
|
|
|
|
## مثال
|
|
|
|
```
|
|
کاربر: برام یک پرامپت بنویس — وقتی دکتر دعوت کلینیک را قبول میکند به لیست پزشکان اضافه نمیشود
|
|
|
|
→ بررسی میکنم...
|
|
- src/ClinicInvitation/Service/ClinicInvitationService.php خوانده شد
|
|
- متد accept() فقط status تغییر میدهد، clinic->getDoctors()->add() صدا نمیزند
|
|
- Clinic entity دارای ManyToMany $doctors است
|
|
|
|
→ فایل .claude/prompt/fix-invitation-accept.md ساخته شد
|
|
|
|
توضیح: رفع باگ پذیرش دعوت — پزشک باید پس از accept به clinic_doctors اضافه شود.
|
|
فایل پرامپت: .claude/prompt/fix-invitation-accept.md
|
|
دستور اجرا:
|
|
|
|
/run-prompt .claude/prompt/fix-invitation-accept.md
|
|
```
|