صفحه ۲۰ از ۴۹، پروژههای عملی
پروژه 04. استفاده از بازخورد زمان اجرا برای اصلاح رفتار ایجنت
درسهای مرتبط: درس 07. ترسیم مرزهای شفاف وظایف برای ایجنتها · درس 08. استفاده از فهرست ویژگیها برای محدود کردن کارهای ایجنت فایلهای الگو: templates/
کاری که انجام میدهید#
مشاهدهپذیری زمان اجرا (لاگهای راهاندازی، لاگهای واردسازی/نمایهسازی، وضعیتهای خطا) و محدودیتهای معماری را برای جلوگیری از نقض مرز لایهها اضافه کنید. یک باگ زمان اجرا در سیستم بکارید تا ایجنت آن را رفع کند.
شما پروژههای starter/ و solution/ موجود در مخزن را مقایسه میکنید: نسخهی starter دارای عیبیابی ضعیف است و اسکریپت محافظت از معماری ندارد، در حالی که راهکار شامل لاگهای ساختاریافته، بررسیهای مرزی و رفع باگ است.
ابزارها#
- Claude Code یا Codex
- Git
- Node.js + Electron
سازوکار هارنس#
بازخورد زمان اجرا + کنترل محدوده + نمایهسازی افزایشی
استفاده از پروژههای موجود در مخزن#
مسیر مخزن: projects/project-04/
| دایرکتوری | شامل چه مواردی است | آنچه باید مقایسه شود |
|---|---|---|
starter/ |
کد پروژه 03 با عیبیابی ضعیف. یک نقص کاشتهشده در نمایهسازی میتواند باعث شکست خرد کردن فایلهای بزرگ شود، و هیچ اسکریپتی برای بررسی معماری وجود ندارد. | ایجنت چقدر زمان صرف میکند تا علت ریشهای را بدون سیگنالهای زمان اجرا پیدا کند. |
solution/ |
لاگر ساختاریافته، اسکریپت و مستندات مرزهای معماری، منطق خرد کردن اصلاحشده، و clean-state-checklist.md. |
آیا لاگها و بررسیهای مرزی رفع عیب را سریعتر و با تهاجم کمتر همراه میسازند یا خیر. |
فایلهای ملموس برای بررسی عبارتند از:
projects/project-04/solution/src/services/logger.ts،
projects/project-04/solution/scripts/check-architecture.sh،
projects/project-04/solution/docs/ARCHITECTURE.md، و
projects/project-04/solution/src/services/indexing-service.ts.