صفحه ۲۰ از ۴۹، پروژه‌های عملی

پروژه 04. استفاده از بازخورد زمان اجرا برای اصلاح رفتار ایجنت

متنی ۵ دقیقه به‌روز شده در ۱۰ آبان ۱۴۰۵

در این صفحه
  1. کاری که انجام می‌دهید
  2. ابزارها
  3. سازوکار هارنس
  4. استفاده از پروژه‌های موجود در مخزن

درس‌های مرتبط: درس 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.