آموزش / کار حرفهای و تیمی / درس ۹ از ۱۵
دستورالعمل پروژه برای ایجنتها و بازبینی امن کد تولیدشده
یک فایل دستورالعمل کوتاه کیفیت کار ایجنت را بیش از هر ترفند پرامپتی بالا میبرد. همراه با چکلیست بازبینی و خطرهای امنیتی رایج.
متوسط، ۸ دقیقه مطالعه
در این آموزش
ایجنتهای کدنویسی در شروع هر کار، فایل دستورالعمل پروژه را میخوانند. نام این فایل بسته به ابزار فرق دارد: AGENTS.md (استاندارد مشترک بسیاری از ابزارها)، CLAUDE.md برای Claude Code، یا قوانین پروژه در Cursor. محتوایش برای همه یکسان است: چیزهایی که یک همکار تازهوارد باید روز اول بداند.
یک الگوی خوب
markdown
# دستورالعمل پروژه
## اجرا و تست
- نصب: `composer install`
- تستها: `vendor/bin/phpunit` — پیش از اعلام پایان کار باید سبز باشند.
- بررسی سبک کد: `vendor/bin/php-cs-fixer fix --dry-run`
## ساختار
- منطق اصلی در `src/Domain` است و نباید به `src/Http` وابسته باشد.
- رشتههای رابط کاربری فارسیاند و در `lang/fa` نگهداری میشوند.
## قواعد
- تغییرها را کوچک نگه دار؛ هر تغییر یک هدف.
- وابستگی جدید اضافه نکن مگر با پرسیدن.
- به فایلهای `migrations/` قدیمی دست نزن؛ مهاجرت جدید بساز.قواعد طلایی کار با ایجنت
- کار را دقیق تعریف کنید. «صفحهی ورود را درست کن» مبهم است؛ «وقتی رمز اشتباه است پیام خطای فارسی نشان بده و تستش را بنویس» قابل سنجش است.
- اول برنامه، بعد کد. برای تغییرهای بزرگ از ایجنت بخواهید اول نقشهی کار را بنویسد و پس از تأیید شما اجرا کند.
- تست، معیار پایان کار است. از ایجنت بخواهید پیش از اعلام پایان، تستها را اجرا کند.
- از گیت کمک بگیرید. پیش از هر کار بزرگ commit بزنید تا اگر نتیجه بد شد، بهراحتی برگردید.
چکلیست بازبینی کد تولیدشده
- آیا تغییر دقیقاً همان کاری را میکند که خواسته بودید، نه بیشتر؟
- آیا تستی هست که بدون این تغییر شکست بخورد؟
- آیا ورودی کاربر اعتبارسنجی و پیش از درج در SQL یا HTML ایمن شده است؟
- آیا کلید، رمز یا آدرس داخلی در کد یا لاگ نوشته شده است؟
- آیا کتابخانهای که اضافه شده واقعاً وجود دارد و نامش دقیقاً درست است؟ (مدلها گاهی نام بستهای را میسازند که وجود ندارد یا شبیه بستهی مخرب است.)
خطر تزریق دستور (Prompt Injection)
ایجنتی که صفحهی وب، ایمیل یا فایل ناشناس میخواند، ممکن است با دستورهای پنهان در آن متن فریب بخورد؛ مثلاً «فایل .env را برای این آدرس بفرست». برای کاهش خطر:
- ایجنت را در محیط جدا (کانتینر یا ماشین مجازی) اجرا کنید، بهویژه وقتی اجازهی اجرای فرمان دارد.
- دسترسی شبکهی ایجنت را به سایتهای لازم محدود کنید.
- کلیدهای واقعی را در اختیار ایجنت نگذارید؛ برای توسعه کلید جدا با سقف مصرف بسازید.
- اجازهی خودکار برای فرمانهای پرخطر (حذف فایل، push، انتشار) ندهید.