صفحه ۲۲ از ۴۹، پروژههای عملی
پروژه 06. ساخت یک هارنس کامل برای ایجنت (پروژه پایانی)
درسهای مرتبط: درس 11. مشاهدهپذیر ساختن زمان اجرای ایجنت · درس 12. بر جای گذاشتن یک تحویل تمیز در پایان هر نشست فایلهای الگو: templates/
کاری که انجام میدهید#
این پروژه پایانی (capstone) دوره است. تمام آموختههای پنج پروژه اول را گردهم آورید، یک بنچمارک کامل اجرا کنید، سپس یک بازبینی پاکسازی برای اطمینان از قابلیت نگهداری کیفیت انجام دهید.
از یک مجموعه وظایف چندویژگی ثابت استفاده کنید که کل برش محصول را پوشش میدهد: وارد کردن سند، نمایهسازی، پرسش و پاسخ مبتنی بر ارجاع، مشاهدهپذیری زمان اجرا، و وضعیت خوانا و قابل راهاندازی مجدد مخزن. ابتدا با خط پایه هارنس ضعیف اجرا کنید، سپس با قویترین هارنس خود، و پس از آن پاکسازی و اجرای دوباره را پیاده نمایید. در نهایت، یک آزمایش مطالعه حذفی (ablation study) هارنس انجام دهید — هر بار یک مؤلفه را حذف کنید تا ببینید کدامیک واقعاً اهمیت دارند.
ابزارها#
- Claude Code یا Codex
- Git
- Node.js + Electron
- الگوی سند کیفیت
- راهنمای ارزیاب (evaluator rubric)
- تمام مؤلفههای هارنس گردآوریشده از پنج پروژه اول
سازوکار هارنس#
هارنس کامل: تمام سازوکارها + مشاهدهپذیری + مطالعه حذفی
استفاده از پروژههای موجود در مخزن#
مسیر مخزن: projects/project-06/
| دایرکتوری | شامل چه مواردی است | آنچه باید مقایسه شود |
|---|---|---|
starter/ |
کد محصول تقریباً کامل با سطح هارنس عمداً ضعیف: یک AGENTS.md اولیه، بدون feature_list.json، بدون session-handoff.md، بدون چکلیست وضعیت تمیز. |
مشاهدات دستی خط پایه هارنس ضعیف. نسخهی starter عمداً فاقد اسکریپتهای بنچمارک است. |
solution/ |
سطح کامل هارنس: AGENTS.md، CLAUDE.md، feature_list.json، init.sh، session-handoff.md، clean-state-checklist.md، مستندات کیفیت/ارزیاب، اسکریپتهای بنچمارک و اسکنر پاکسازی. |
اجرای projects/project-06/solution/scripts/benchmark.sh و projects/project-06/solution/scripts/cleanup-scanner.sh، سپس مقایسه شواهد سند کیفیت. |
برخلاف پروژههای پیشین، نسخهی starter پروژه پایانی فاقد بیشتر ویژگیهای محصول نیست. شکاف اصلی، هارنس عملیاتی پیرامون برنامه است.