ما در آیتی هلو از شهریور ۱۴۰۲ کارمون رو با عشق به کتاب و یادگیری شروع کردیم. تخصص ما چاپ کتابهای تخصصی به زبان اصلیه و با استفاده از تکنولوژیهای روز و مواد اولیه باکیفیت، مطمئن میشیم که هر کتاب از نظر ظاهر و محتوا در بهترین سطح قرار بگیره.
هدفمون اینه که دسترسی به منابع علمی و آموزشی معتبر رو برای همه سادهتر کنیم و در این مسیر، همراه و همکار خوبی برای شما باشیم.
Build scalable Al coding systems with Skills, MCP, Hooks, agent orchestration, and SDK patterns
در چند سال گذشته، بخش بزرگی از صنعت هوش مصنوعی حول یک پرسش اساسی میچرخید: کدام مدل هوش مصنوعی قدرتمندتر است؟ این پرسش در زمان خود اهمیت زیادی داشت، اما با نزدیک شدن مدلهای پیشرو به یکدیگر، عامل تعیینکننده در کیفیت یک سامانه هوشمند دیگر صرفاً خود مدل نبود. تفاوت اصلی به ساختاری منتقل شد که مدل را احاطه میکند؛ یعنی زمینهای که در اختیار آن قرار میگیرد، ابزارهایی که میتواند استفاده کند، محیطی که در آن اجرا میشود و محدودیتها و سازوکارهای کنترلی که بر عملکرد آن اعمال میشود.
کتاب حاضر این ساختار پیرامونی را با مفهوم Harness معرفی میکند و یک ایده مرکزی را در تمام بخشهای خود دنبال میکند:
عامل هوشمند را میتوان حاصل ترکیب Model + Harness دانست.
وقتی مدلها تا حد زیادی به کالاهای قابل جایگزینی تبدیل میشوند، بخش مهم مهندسی به ساخت Harness منتقل میشود؛ ساختاری که مشخص میکند عامل چه چیزی را میبیند، چه کاری میتواند انجام دهد، به چه ابزارهایی دسترسی دارد، چگونه اجرا میشود و چه محدودیتهایی باید رعایت کند.
در این میان، Claude Code نمونهای روشن از این رویکرد است. Claude Code در ظاهر یک دستیار برنامهنویسی مبتنی بر خط فرمان است، اما در سطح عمیقتر میتوان آن را یک Harness کامل و قابل بررسی دانست. فایل CLAUDE.md برای تزریق زمینه و دستورالعملها، Skills و Sub-agents برای گسترش قابلیتها، Hooks و Permissionها برای اعمال کنترل و حالت Headless، ابزار Agent SDK و Plugins برای انتقال این قابلیتها به محیطهای اجرایی واقعی مورد استفاده قرار میگیرند.
هدف این کتاب صرفاً آموزش کار با Claude Code نیست. هدف اصلی آن آموزش شیوهای برای فکر کردن درباره معماری عاملهای هوشمند و ساخت Harnessهایی است که بتوانند این عاملها را به شکل قابل اعتماد، کنترلشده و قابل توسعه به کار بگیرند.
یک مدل زبانی به تنهایی فقط بخشی از یک سامانه عاملمحور است. مدل میتواند استدلال کند، متن تولید کند یا بر اساس زمینهای که دریافت کرده تصمیم بگیرد، اما برای تبدیل شدن به یک عامل کاربردی به محیط و ابزار نیاز دارد.
اینکه عامل چه اطلاعاتی دریافت کند، به چه ابزارهایی دسترسی داشته باشد، چه اقداماتی اجازه انجام آنها را داشته باشد و در چه محیطی اجرا شود، میتواند تفاوت بزرگی در نتیجه ایجاد کند.
کتاب Harness را در چهار لایه اصلی بررسی میکند:
زمینه، ابزارها، اجرا و حاکمیت.
این چهار لایه در فصلهای مختلف کتاب از مفاهیم پایه تا ساخت سامانههای عملی دنبال میشوند و در نهایت به یک معماری کامل برای استفاده فردی و سازمانی از عاملهای هوشمند میرسند.
عامل باید بداند در چه پروژهای فعالیت میکند، چه قواعدی باید رعایت شوند، چه اطلاعاتی برای انجام کار ضروری است و کدام دستورالعملها بر رفتار آن حاکم هستند.
کلمات کلیدی:در Claude Code، سازوکارهایی مانند CLAUDE.md و سلسلهمراتب حافظه برای مدیریت همین بخش مورد استفاده قرار میگیرند. کتاب نشان میدهد چگونه میتوان زمینه را به شکل لایهای، کمحجم و هدفمند مدیریت کرد تا اطلاعات صحیح در زمان مناسب بارگذاری شوند.
عامل بدون ابزارهای مناسب نمیتواند به محیط واقعی متصل شود. ابزارها میتوانند امکان تعامل با دادهها، سرویسها، سامانهها و محیطهای خارجی را فراهم کنند.
در کتاب، این موضوع از طریق Skills، MCP و ابزارهای سفارشی Agent SDK بررسی میشود.
عامل باید در یک محیط واقعی اجرا شود. این اجرا میتواند تعاملی و از طریق خط فرمان باشد یا به صورت خودکار در یک فرایند CI/CD انجام شود.
حالت Headless و اتصال Claude Code به GitHub Actions، GitLab و Jenkins از جمله موضوعاتی هستند که کتاب برای همین لایه بررسی میکند.
هرچه عامل قدرتمندتر شود، کنترل آن اهمیت بیشتری پیدا میکند. اینکه عامل اجازه انجام چه کاری را دارد و چگونه میتوان از اجرای اقدامات خطرناک جلوگیری کرد، بخش مهمی از طراحی Harness است.
کتاب در این زمینه به Permissionها، Hooks، امنیت، هزینه، اشکالزدایی، مقیاسپذیری و همکاری تیمی میپردازد.
Claude Code در این کتاب صرفاً به عنوان یک ابزار برنامهنویسی معرفی نمیشود. نویسنده آن را نمونهای عملی برای درک معماری Harness میداند.
این نگاه باعث میشود مطالب کتاب محدود به یک ابزار خاص نباشند. ممکن است جزئیات Claude Code، نام مدلها، گزینههای خط فرمان یا قیمتگذاری در طول زمان تغییر کنند، اما اصول بنیادی مانند مدیریت زمینه، جداسازی قابلیتها، کنترل دسترسی عامل، محدود کردن اقدامات و تعیین مرز میان «آنچه عامل میتواند ببیند» و «آنچه میتواند انجام دهد» پایدارتر هستند.
هدف کتاب این است که خواننده بعد از مطالعه، فقط کاربر Claude Code نباشد؛ بلکه بتواند معماری Harness یک عامل هوشمند را تحلیل و طراحی کند.
این کتاب یک بررسی کلی یا فهرست قابلیتهای Claude Code نیست. رویکرد آن کاملاً مهندسی و عملی است.
هر سازوکار از یک مسئله واقعی شروع میشود، در کد پیادهسازی میشود و تا جایی ادامه پیدا میکند که یا در عمل جواب بدهد یا محدودیتهای آن مشخص شود.
فصلها نیز به شکل زنجیرهای روی یکدیگر ساخته شدهاند. ابتدا چهار لایه اصلی Harness معرفی میشوند و سپس این لایهها برای ساخت سامانههای پیچیدهتر ترکیب میشوند؛ از اجرای خودکار و Agentهای سفارشی گرفته تا Pluginهای قابل اشتراکگذاری و شیوههای همکاری تیمی.
یکی از نخستین مشکلات هنگام کار جدی با عاملهای هوشمند، مدیریت Context است. اگر اطلاعات مورد نیاز عامل بیش از حد زیاد باشد، زمینه شلوغ میشود و اگر اطلاعات ضروری در اختیار آن قرار نگیرد، کیفیت تصمیمگیری کاهش پیدا میکند.
کتاب در فصل دوم به ساختار CLAUDE.md و حوزههای مختلف حافظه در Claude Code میپردازد و نشان میدهد چگونه میتوان زمینه را کمحجم، لایهبندیشده و با ترتیب بارگذاری مناسب طراحی کرد.
این فصل به یکی از اصول مهم مهندسی Harness میپردازد: اطلاعات بیشتر همیشه به معنای زمینه بهتر نیست.
در یک سامانه عاملمحور، قرار نیست تمام قابلیتها هر بار از ابتدا توضیح داده شوند. مفهوم Skills امکان بستهبندی قابلیتهای قابل استفاده مجدد را فراهم میکند.
کتاب Skills را به عنوان بستههای قابلیتی اعلامی بررسی میکند که در فایل SKILL.md تعریف میشوند. خواننده یاد میگیرد چگونه این قابلیتها را طراحی، محدودهبندی و فعال کند تا عامل بتواند در زمان مناسب قابلیت صحیح را انتخاب کند.
هدف Skills این است که دانش و فرایندهای تکرارشونده از حالت دستورهای پراکنده خارج شوند و به قابلیتهایی قابل استفاده مجدد تبدیل شوند.
با پیچیدهتر شدن وظایف، سپردن تمام کارها به یک عامل واحد همیشه بهترین ساختار نیست. مفهوم Sub-agent امکان تقسیم یک مسئله بزرگ به وظایف متمرکزتر را فراهم میکند.
کتاب به موضوعاتی مانند تفکیک وظایف، Delegation، جداسازی Context و ترکیب نتایج میپردازد.
یکی از نکات مهم این بخش، Context Isolation است؛ یعنی هر عامل فرعی میتواند زمینه مناسب برای وظیفه خود را داشته باشد و از شلوغ شدن زمینه عامل اصلی جلوگیری شود.
این رویکرد برای طراحی جریانهای کاری پیچیده اهمیت زیادی دارد، زیرا مسئله بزرگ به بخشهای مشخصتر تقسیم میشود و نتایج آنها میتوانند به شکلی کنترلشده با یکدیگر ترکیب شوند.
یکی از تفاوتهای مهم میان یک دستورالعمل ساده و یک محدودیت واقعی، امکان اعمال اجباری آن است.
کتاب در فصل پنجم سازوکار Hooks را بررسی میکند؛ مکانیزمی مبتنی بر رویداد که میتواند دستورالعملهای نرم را به Guardrailهای اجرایی تبدیل کند.
برای مثال، اگر عملی خطرناک باشد، Hook میتواند پیش از اجرای آن وارد عمل شود و مانع انجام عملیات شود.
این بخش نشان میدهد که امنیت یک عامل فقط با توصیه به عامل برای «مراقب بودن» ایجاد نمیشود؛ بخشی از کنترل باید در خود محیط اجرایی اعمال شود.
عاملهای هوشمند زمانی کاربرد بیشتری پیدا میکنند که بتوانند با ابزارها و منابع خارجی ارتباط برقرار کنند.
در فصل ششم، کتاب Model Context Protocol یا MCP را به عنوان سازوکاری برای اتصال Claude Code به ابزارها، منابع داده و اعتبارنامههای خارجی بررسی میکند.
این بخش کمک میکند مفهوم Harness از یک محیط محدود به خط فرمان فراتر برود و به ساختاری تبدیل شود که عامل میتواند در یک محیط واقعی با سرویسها و منابع مختلف تعامل داشته باشد.
Claude Code میتواند از محیط تعاملی خط فرمان خارج شود و در جریانهای کاری خودکار مورد استفاده قرار گیرد.
فصل هفتم به Headless Mode و یکپارچهسازی با CI/CD میپردازد. موضوعاتی مانند اجرای بدون تعامل، محدودیت بودجه و تعداد نوبتها و ساخت Pipelineهای کامل در GitHub Actions، GitLab و Jenkins بررسی میشوند.
این مرحله اهمیت زیادی دارد، زیرا استفاده جدی از عاملهای هوشمند در یک سازمان فقط به اجرای دستی آنها توسط یک توسعهدهنده محدود نمیشود.
در مرحله بعد، کتاب از استفاده از Claude به عنوان یک ابزار عبور میکند و وارد ساخت Agent درون برنامه میشود.
Agent SDK امکان کنترل و هماهنگی Claude از طریق کد را فراهم میکند. کتاب موضوعاتی مانند ابزارهای سفارشی با دکوراتور @tool، خروجی ساختاریافته، لایههای Permission و ساخت یک سرویس کامل مبتنی بر SDK را بررسی میکند.
این بخش برای مهندسانی اهمیت دارد که میخواهند Agent را مستقیماً در معماری نرمافزاری خود قرار دهند، نه اینکه صرفاً از آن به عنوان یک ابزار جانبی استفاده کنند.
وقتی یک مهندس برای خودش مجموعهای از Skills، Sub-agents، Hooks و اتصالهای MCP میسازد، سؤال بعدی این است که چگونه میتوان این تنظیمات را در اختیار دیگر اعضای تیم قرار داد.
فصل نهم به Plugin Ecosystem میپردازد و نشان میدهد چگونه این اجزا میتوانند در قالب Plugin بستهبندی و توزیع شوند.
کتاب همچنین مفهوم بازارهای خصوصی را بررسی میکند تا تنظیماتی که یک مهندس ایجاد کرده است، بتواند به یک استاندارد مشترک برای کل تیم تبدیل شود.
این انتقال از ابزار شخصی به دارایی مشترک تیمی، یکی از گامهای مهم در مقیاسدادن به مهندسی عاملها است.
استفاده یک نفر از یک عامل هوشمند با استفاده یک سازمان از آن تفاوت زیادی دارد.
در سطح تیمی، موضوعاتی مانند هزینه، امنیت، اشکالزدایی، مقیاسپذیری، دستورالعملهای مشترک و همکاری میان اعضای تیم مطرح میشوند.
فصل دهم به همین مسائل میپردازد و تلاش میکند نشان دهد چگونه میتوان استفاده از Claude Code را از یک مهارت فردی به یک شیوه مهندسی قابل مدیریت در سطح سازمان تبدیل کرد.
در سراسر کتاب سه شخصیت در قالب گفتوگوهای کوتاه حضور دارند.
Xiaobing مهندسی است که Claude Code را در پروژههای واقعی به کار میگیرد. Xiaoxue از زاویه تحلیل داده به مسائل نگاه میکند و پرسشهایی را مطرح میکند که در عمل ممکن است برای یک متخصص ایجاد شوند. Kage نیز نقش یک راهنمای فنی باتجربه را دارد که به آنها کمک میکند درباره تصمیمهای معماری فکر کنند.
این گفتوگوها صرفاً برای جذابیت متن نیستند. هر گفتوگو یک تنش یا تصمیم طراحی را مطرح میکند و فصل مربوطه سپس آن مسئله را در قالب کد و پیادهسازی بررسی میکند.
این کتاب برای مهندسان نرم افزار، معماران فنی و رهبران تیمهای مهندسی نوشته شده است؛ بهخصوص افرادی که قبلاً از دستیارهای برنامهنویسی هوش مصنوعی استفاده کردهاند و اکنون میخواهند استفاده از آنها را به شکل جدیتر، قابل اعتمادتر و در مقیاس تیمی دنبال کنند.
اگر تجربه استفاده از Claude Code یا ابزارهای مشابه را دارید و همزمان قدرت و محدودیتهای آنها را دیدهاید، این کتاب تلاش میکند سازوکارهای پشت این ابزارها را برایتان روشن کند.
برای مطالعه کتاب، آشنایی عملی با خط فرمان، Git و حداقل یک زبان برنامهنویسی لازم است. مثالها بیشتر بر Python، JavaScript، TypeScript و Shell تکیه دارند.
در مقابل، داشتن دانش قبلی درباره Agent Frameworkها یا ساختار داخلی مدلهای زبانی ضروری نیست. کتاب این مفاهیم را از اصول اولیه معرفی میکند.
برای اجرای مثالهای کتاب به یک نصب فعال از Claude Code و دسترسی به Claude نیاز دارید. این دسترسی میتواند از طریق کلید API مربوط به Anthropic یا اشتراک مناسب Claude فراهم شود.
از آنجا که Claude Code بر Node.js اجرا میشود، یک نسخه جدید از Node.js مورد نیاز است. Python 3.10 یا بالاتر و Git نیز در مثالها مورد استفاده قرار میگیرند.
همچنین آشنایی با خط فرمان و یک ویرایشگر کد ضروری است.
مواردی مانند Skills، Sub-agents، Hooks، MCP Serverها و Agent SDK در طول کتاب معرفی و راهاندازی میشوند؛ بنابراین ساختار آموزشی کتاب از یک نصب ساده شروع شده و مرحلهبهمرحله به معماریهای پیچیدهتر میرسد.
فصل اول معماری فنی Claude Code را بررسی میکند و مفهوم اصلی Model + Harness را معرفی میکند. چهار لایه Context، Tools، Execution و Governance نیز در این فصل تعریف میشوند.
این فصل به ساختار CLAUDE.md، سلسلهمراتب حافظه و نحوه مدیریت Context میپردازد و بر طراحی زمینهای لایهای و کمحجم تمرکز دارد.
در این فصل قابلیتهای قابل استفاده مجدد و فایل SKILL.md بررسی میشوند و خواننده با نحوه طراحی و فعالسازی Skills آشنا میشود.
فصل چهارم به تقسیم کار میان عاملها، جداسازی Context، واگذاری وظایف و ترکیب نتایج اختصاص دارد.
این فصل نشان میدهد چگونه میتوان از Hooks برای اعمال کنترلهای واقعی استفاده کرد و جلوی یک عملیات خطرناک را پیش از اجرا گرفت.
Model Context Protocol در این فصل به عنوان راهکاری برای اتصال Claude Code به ابزارها، دادهها و اعتبارنامههای خارجی بررسی میشود.
اجرای خودکار Claude Code، محدودیت بودجه و تعداد نوبتها و اتصال آن به GitHub Actions، GitLab و Jenkins در این فصل بررسی میشوند.
این فصل وارد ساخت Agentهای سفارشی میشود و ابزارهای سفارشی، خروجی ساختاریافته، Permissionها و ساخت یک سرویس مبتنی بر SDK را بررسی میکند.
Skills، Sub-agents، Hooks و MCP در قالب Pluginهای قابل توزیع ترکیب میشوند و نحوه تبدیل تنظیمات فردی به دارایی مشترک تیمی بررسی میشود.
فصل پایانی بخش اصلی کتاب به هزینه، امنیت، اشکالزدایی، مقیاسپذیری، دستورالعملها و همکاری تیمی اختصاص دارد.
پس گفتار دوباره به استعاره اصلی کتاب و مفهوم Harness بازمیگردد و آن را در چارچوب گستردهتر روششناسی و الگوهای طراحی عاملها قرار میدهد.
یکی از ایدههای اصلی کتاب این است که تغییر مدل به تنهایی مشکل مهندسی عامل را حل نمیکند.
مدلها ممکن است در طول زمان تغییر کنند، اما بسیاری از مشکلات بنیادی ثابت باقی میمانند. Context میتواند بیش از حد بزرگ شود، تزریق دستورالعمل همچنان یک مسئله است، عامل همچنان باید به ابزارهای مناسب دسترسی داشته باشد و مرز میان «آنچه عامل میتواند مشاهده کند» و «آنچه اجازه دارد انجام دهد» همچنان اهمیت دارد.
از همین رو کتاب تلاش میکند خواننده را از وابستگی به یک ابزار خاص دور کند.
Claude Code موضوع عملی کتاب است، اما Harness موضوع اصلی آن است.
این تفاوت مهم است. یادگیری چند دستور Claude Code میتواند برای یک ابزار مشخص مفید باشد، اما درک اصول Context، Tools، Execution و Governance میتواند در طراحی Agentهای دیگر نیز قابل استفاده باشد.
هرچه عاملها قدرتمندتر شوند، مسئله فقط این نیست که آیا میتوانند یک کار را انجام دهند یا نه. مسئله این است که در چه محیطی، با چه اطلاعاتی، با چه ابزارهایی و تحت چه محدودیتهایی آن کار را انجام میدهند.
این کتاب تلاش میکند این نگاه را از سطح استفاده روزمره به سطح مهندسی منتقل کند.
از مدیریت CLAUDE.md و Skills گرفته تا Sub-agents، Hooks، MCP، Headless Mode، CI/CD، Agent SDK و Pluginها، هر بخش قطعهای از یک Harness بزرگتر است.
در نهایت، خواننده با یک مجموعه دستور پراکنده برای کار با Claude Code مواجه نیست؛ بلکه با یک چارچوب فکری برای طراحی و مدیریت عاملهای هوشمند روبهرو میشود.
اگر نسل جدید توسعه نرم افزار بیش از گذشته با Agentها انجام شود، توانایی طراحی محیطی که Agent در آن فعالیت میکند به اندازه انتخاب خود مدل اهمیت پیدا خواهد کرد.
کتاب حاضر دقیقاً روی همین بخش متمرکز است: ساخت محیطی که بتواند توانایی مدل را به یک جریان کاری مهندسیشده، قابل کنترل و قابل استفاده در پروژههای واقعی تبدیل کند.
کتاب Claude Code و مهندسی Harness برای توسعهدهندگانی نوشته شده است که میخواهند از مرحله استفاده ساده از دستیارهای هوش مصنوعی عبور کنند و وارد مرحله ساخت جریانهای کاری و Agentهای جدی شوند.
در این مسیر، ابتدا معماری Harness و چهار لایه اصلی آن معرفی میشوند، سپس مدیریت Context، قابلیتهای قابل استفاده مجدد، Sub-agents، Guardrailها و اتصال ابزارها بررسی میشوند. در ادامه، کتاب به اجرای Headless، CI/CD، ساخت Agentهای سفارشی با Agent SDK و ایجاد Pluginهای قابل اشتراکگذاری میرسد و در نهایت مسئله استفاده تیمی و سازمانی از Claude Code را بررسی میکند.
ارزش اصلی کتاب در یادگیری یک ابزار خاص خلاصه نمیشود؛ بلکه در یادگیری اصولی است که پشت آن ابزار قرار دارند.
با مطالعه این کتاب، Claude Code میتواند نقطه شروعی برای درک معماری Agentها باشد؛ معماریای که در آن مدل، تنها یکی از اجزای سیستم است و Harness مسئول تبدیل قابلیت مدل به یک سامانه عملی، کنترلشده و قابل اتکا است.
نمونه چاپ کتاب موجود نیست.
نظرات کاربران (0)