قواعد ایجنت و بازبینی تغییرات
محدودیت‌های Skill، جلوگیری از پرداخت دوباره، حفاظت از کش و هویت و بازبینی تحویل مصرفی و نتیجه آزمون.
Skill راهنماست، نه تضمین خودکار صحت کد. توسعه‌دهنده باید نتیجه را با source نسخه واقعی و آزمون پلتفرم بررسی کند. اگر نسخه اپ با baseline فرق دارد، ایجنت باید تفاوت را گزارش کند و به API آینده یا قدیمی تکیه نکند.
کارهایی که ایجنت نباید انجام دهد
- تغییر امضای public را به تغییر تصادفی خرید، cache namespace، retry، زمان‌بندی بازیابی یا schema داده تبدیل نکند.
- برای رفع خطای شبکه، storage، pending journal یا موجودی را پاک نکند و حساب تازه نسازد.
- از خطای شبکه، lookup null، sync خالی یا event نامرتبط، شکست قطعی خرید نتیجه نگیرد و پرداخت دوم شروع نکند.
- نتیجه مشتری قبلی یا تلاش متعلق به app/store دیگر را به نشست جدید وارد نکند.
- پیش از commit ماندگار موجودی confirm نکند؛ confirm را داخل handler اجرا نکند و دو مالک هم‌زمان برای grant نسازد.
- متد RevenueCat یا wrapper میزبان را صرف شباهت نام، متد رسمی SDK اینپی‌فای فرض نکند.
- محدودیت پل وب را با client دوم JS، فراخوانی MethodChannel، کلاس src یا HTTP دست‌نویس دور نزند.
- بدون درخواست صریح، نسخه SDK را منتشر، backend را مستقر، migration production را اجرا یا OTP/خرید واقعی ایجاد نکند.
مرز پلتفرم‌ها را بررسی کنید
جدول قابلیت‌ها بخشی از قرارداد است: iOS این نسخه StoreKit و history اندروید ندارد؛ پل Flutter Web برخی متدهای JS و forwarding policy را ندارد. کلید محلی تلاش iOS هم تضمین deduplication سرور Direct نیست. ایجنت نباید این تفاوت‌ها را با فرض مشترک پنهان کند.
تحویل و نتیجه آزمون
اعطای مصرفی باید در تراکنش ماندگار با uniqueness وابسته به app/customer/source/deliveryId باشد. آزمون restart و شکست confirm باید عدم grant دوباره را ثابت کند. timeout پس از پرداخت را با همان checkout/attempt دنبال کنید. دسترسی اشتراک از CustomerInfo فعال می‌آید، نه flag محلی یا پیام بانکی.
ایجنت باید بگوید چه چیزی analyzer/unit test شده و چه چیزی روی دستگاه/استور بررسی نشده است. اجرای موفق build، مدرک خرید زنده یا استقرار backend نیست. اطلاعات حساس را برای «اثبات» در خروجی منتشر نکند.
نگه‌داری Skill
منبع در مخزن Flutter است. با هر نسخه SDK، baseline، امضای facade، backendهای واقعی و payload خرید بررسی و مثال‌ها دوباره type-check شوند. راهنمای جدید نباید برای اپ قدیمی قرارداد تازه جعل کند.