কখনও কি আপনার নন-টেক বন্ধুকে পুল রিকোয়েস্ট কী, তা বোঝানোর চেষ্টা করেছেন এবং ক্রিসপি ক্রিমের কনভেয়ার বেল্টের মতো তাদের চোখ চকচক করতে দেখেছেন? এখন ভাবুন তাদের বলছেন যে একটি AI শুধুমাত্র আপনার রেপো বুঝতে পারে না, আপনার জন্য PR-ও খুলতে পারে। ২০২৫-এ স্বাগতম, যেখানে আপনার কোড এডিটর কিছুটা কো-পাইলট, কিছুটা ব্যাকসিট ড্রাইভার, এবং - যদি আপনি এটি সঠিকভাবে সেটআপ করেন - তাহলে বেশ ভালো ইন্টার্ন।
এই গাইড আপনাকে দেখাবে কীভাবে GitHub-কে Claude Code-এর সাথে কানেক্ট করে স্বয়ংক্রিয়ভাবে পুল রিকোয়েস্ট তৈরি করতে হয়। আমরা ধাপে ধাপে সেটআপ, বাস্তব-বিশ্বের ওয়ার্কফ্লো এবং এড়াতে কয়েকটি গর্ত সহ "Huh?" থেকে "Ship it" পর্যন্ত যাব। আপনি GitHub-কে ওয়্যারিং করবেন, Claude Code-কে কী ঘটছে তা দেখতে দেবেন এবং এটিকে PR খুলতে এবং আপডেট করতে দেবেন যা আপনি অ্যালগরিদমিক ডেভিলের সাথে চুক্তি করেছেন এমন অনুভূতি ছাড়াই মার্জ করতে পারবেন।
মাথা উঁচু করুন: আপনি এখানে দুটি প্রধান পথ দেখতে যাচ্ছেন—Claude Code-এর GitHub Actions ইন্টিগ্রেশন ব্যবহার করা এবং মডেল কন্টেক্সট প্রোটোকল (MCP) সার্ভার ব্যবহার করে Claude-কে GitHub API-তে নিরাপদ, সুযোগ-সুবিধা দেওয়া। কোনটি আপনার বেছে নেওয়া উচিত? আপনি যদি GitHub-এ সরাসরি প্লাগ-এন্ড-প্লে PR সহায়তা চান, তাহলে Actions রুট আপনার সেরা বাজি। আপনি যদি স্থানীয়, চ্যাট-চালিত রেপো কন্ট্রোল চান গ্র্যানুলার অনুমতি সহ, MCP হল আপনার পাওয়ার টুল।
আমরা যা তৈরি করছি
- নিরাপদে GitHub-কে Claude Code-এর সাথে কানেক্ট করুন।
- Claude-কে আপনার রেপো বিশ্লেষণ করতে, পরিবর্তন প্রস্তাব করতে এবং PR খুলতে দিন।
- পর্যালোচনা, লেবেল, চেকলিস্ট এবং এমনকি ফলো-আপ কমিটগুলি স্বয়ংক্রিয় করুন।
- গার্ড্রেইল যুক্ত করুন যাতে এটি আপনার পুরো মনোরেপোকে "final_final_v2" তে পুনরায় নামকরণ না করে।
আপনার যা দরকার হবে
- একটি GitHub রেপো যা আপনি নিয়ন্ত্রণ করেন (অথবা এমন একটি শাখা যা আপনি কান্না না করে ভাঙতে পারেন)।
- Actions এবং সিক্রেট কনফিগার করার জন্য রেপো অ্যাডমিন অ্যাক্সেস।
- আপনার অ্যাকশন বা ওয়ার্কফ্লোর প্রয়োজন হলে একটি Claude API কী।
ধাপ ১: আপনার রেপোতে GitHub Actions সক্ষম করুন
- আপনার রিপোজিটরি → সেটিংস → অ্যাকশন → সাধারণ এ যান।
- "Allow all actions and reusable workflows" সক্ষম করুন (অথবা আপনার সংস্থার অনুমোদিত ক্রিয়াকলাপগুলিতে সীমাবদ্ধ করুন যদি আপনার সুরক্ষা কর্মীরা ইতিমধ্যে আপনাকে সন্দেহের চোখে দেখে)।
অপশন ১: ইস্যু-চালিত PR
- আপনি যখন একটি বিশেষ লেবেল (যেমন, ai-pr) দিয়ে একটি ইস্যু খোলেন, তখন ওয়ার্কফ্লোটি চলে।
- এটি ইস্যু প্রম্পট পড়ে (যেমন, “ডার্ক মোড টগল যুক্ত করুন”), একটি নতুন শাখা তৈরি করে, Claude ব্যবহার করে ফাইল সম্পাদনা করে, কমিট পুশ করে এবং একটি বিস্তারিত সারসংক্ষেপ সহ একটি PR খোলে।
অপশন ২: একটি বিদ্যমান PR-এ মন্তব্য-চালিত সম্পাদনা
- আপনি যখন মন্তব্য করেন @claude অনুগ্রহ করে সেটিংস মোডাল রিফ্যাক্টর করুন, তখন ওয়ার্কফ্লোটি চলে।
- এটি ডিফ্র বিশ্লেষণ করে, পরিবর্তনের প্রস্তাব দেয় এবং PR শাখায় আপডেট পুশ করে।
- ইন্টিগ্রেশন এবং ব্যবহারের ক্ষেত্রগুলির একটি দ্রুত গাইড আপনাকে বাস্তব দলগুলিতে স্বয়ংক্রিয় করার জন্য কী উপযুক্ত (এবং কী নয়) তার একটি পাখির চোখের দৃশ্য দেয়।
- আপনি যদি ভিজ্যুয়াল লার্নার হন, তাহলে এই ওয়াকথ্রু আপনাকে শুরু থেকে শেষ পর্যন্ত অ্যাকশনে অটো-জেনারেটেড AI PR দেখায়।
আপনার যা দরকার হবে
- Claude Desktop বা একটি IDE ইন্টিগ্রেশন যা MCP টুলিং সমর্থন করে।
- একটি GitHub MCP সার্ভার যা আপনি স্থানীয়ভাবে চালান, একটি টোকেন দিয়ে কনফিগার করা যা সুযোগগুলিকে সীমিত করে।
- একটি ব্যক্তিগত অ্যাক্সেস টোকেন (PAT) শুধুমাত্র সেই সুযোগগুলির সাথে যা আপনার সত্যিই প্রয়োজন (যেমন, repo:status, public_repo, pull_request write)।
ধাপ ১: একটি GitHub MCP সার্ভার ধরুন
- একটি অফিসিয়াল ওপেন-সোর্স সার্ভার রয়েছে যা নির্বাচিত GitHub API অপারেশনগুলি প্রকাশ করে (ইস্যু অনুসন্ধান করুন, শাখা তৈরি করুন, PR খুলুন ইত্যাদি)। এটি কনফিগারযোগ্য যাতে আপনি শুধুমাত্র আপনার প্রয়োজনীয় জিনিসগুলি সক্ষম করেন, যা AI বিভ্রান্তি কমায় এবং নিরাপত্তাকে খুশি রাখে। MCP সার্ভার এবং উদাহরণের একটি বিস্তৃত দৃশ্যের জন্য, কেন্দ্রীয় ডিরেক্টরি দেখুন।
ধাপ ২: সার্ভারের সাথে কথা বলার জন্য আপনার ক্লায়েন্ট কনফিগার করুন
- আপনার ক্লায়েন্ট কনফিগার ফাইলে (যেমন, আপনার AI অ্যাপের জন্য একটি JSON কনফিগার), GitHub MCP সার্ভার নিবন্ধন করুন, পরিবেশের ভেরিয়েবলের মাধ্যমে আপনার টোকেন পাস করুন এবং অনুমোদিত রেপো হোয়াইটলিস্ট করুন।
- পেশাদার টিপ: টোকেনটি আপনার সিস্টেম কীচেইন বা একটি ডটেনভ ফাইলে রাখুন, আপনার কনফিগার ফাইলে নয়। আপনার পরবর্তী সর্ব-হাতের মিটিংয়ে সতর্কতামূলক উদাহরণ হবেন না।
ধাপ ৩: টুল সারফেস এরিয়া পরীক্ষা করুন
- Claude-কে খোলা ইস্যু তালিকাভুক্ত করতে, একটি নির্দিষ্ট ফাইল পড়তে বা একটি শাখা তৈরি করতে বলুন। যাচাই করুন যে এটি এমন কিছু করতে পারবে না যা আপনি স্পষ্টভাবে অনুমতি দেননি।
- আপনি বেসিক কমান্ডগুলির সুস্থতা পরীক্ষা করার পরেই create_pull_request সক্ষম করা উচিত।
ধাপ ৪: Claude কে একটি PR প্রস্তাব এবং খুলতে দিন
- প্রম্পট উদাহরণ: “রেপো org/app-frontend এ, একটি নতুন শাখা feat/dark-toggle তৈরি করুন, SettingsPanel.tsx এ ডার্ক মোডের জন্য একটি সেটিংস টগল প্রয়োগ করুন, পরীক্ষা আপডেট করুন এবং QA-এর জন্য একটি চেকলিস্ট সহ একটি PR খুলুন।”
- সার্ভারটি অর্কেস্ট্রেট করে: রেপো স্টেট পড়ে, পরিবর্তন লেখে (যদি আপনি স্থানীয় ফাইল টুল কনফিগার করে থাকেন), একটি শাখা পুশ করে, আপনার টেমপ্লেট দিয়ে একটি PR খোলে এবং একটি সারসংক্ষেপ পোস্ট করে।
বাস্তব কথোপকথন: গার্ড্রেইল যা আপনার আসলে প্রয়োজন
- শুধুমাত্র পঠনযোগ্য ড্রাই রান: লেখার অ্যাক্সেস দেওয়ার আগে Claude-কে একটি ইউনিফাইড ডিফ্র (git diff) তৈরি করতে দিন। আপনি এটি দেখার পরে মার্জ করুন।
- টেমপ্লেটেড PR বডি: ঝুঁকির নোট, পরীক্ষার পরিকল্পনা এবং রোলআউট পদক্ষেপ অন্তর্ভুক্ত করুন। বটকে টেমপ্লেটটি সম্পূর্ণ করতে দিন; মানুষ দিয়ে এটি পর্যালোচনা করান।
- লেবেলিং নিয়ম: জিনিসগুলি আবিষ্কারযোগ্য এবং সৎ রাখতে ai-generated এবং needs-tests-এর মতো লেবেলগুলি স্বয়ংক্রিয়ভাবে প্রয়োগ করুন।
- শাখার নামকরণ: শাখা সুরক্ষা বিধি সহ একটি উপসর্গ (ai/ বা bot/) প্রয়োজন। রোবটদেরও ইউনিফর্ম দরকার।
উপাখ্যানের সময়: আমি একটি AI কে “auth বাগ ঠিক করতে” বলেছিলাম। এটি প্রমাণীকরণ সরিয়ে এটিকে “ঠিক” করেছে। উৎপাদনশীলতার জন্য দারুণ! আক্ষরিক অর্থে অন্য সবকিছুর জন্য ভয়ানক। সুযোগগুলি সংকীর্ণ রাখুন, প্রম্পটগুলি নির্দিষ্ট করুন এবং CI পরীক্ষাগুলি অর্থবহ করুন।
- আপনি একটি ইস্যু খোলেন: “Debounce util: CI-তে 200ms সীমানায় ফ্লেক করুন।” আপনি এটিকে ai-pr ট্যাগ করেন।
- ওয়ার্কফ্লো ট্রিগার করে। এটি debounce.ts এবং সম্পর্কিত পরীক্ষাগুলি অনুসন্ধান করে।
- Claude একটি ডিফ্র প্রস্তাব করে: jest.useFakeTimers দিয়ে টাইমার সামঞ্জস্য করে, দাবীগুলিতে একটি মার্জিন যোগ করে, ডক্স আপডেট করে।
- বট একটি PR খোলে: শিরোনাম, সারসংক্ষেপ, যুক্তি, পরীক্ষার পরিকল্পনা এবং ঝুঁকির রেটিং সহ।
- আপনি ডিফ্র পর্যালোচনা করেন, পিছনে ঠেলেন: “যখন delay=0 হয় তখন প্রান্তিক কেস।”
- আপনি মন্তব্য করেন @claude অবিলম্বে ফ্লাশ দিয়ে delay=0 পরিচালনা করুন; পরীক্ষা যোগ করুন। ওয়ার্কফ্লো পুনরায় চলে, একটি কমিট পুশ করে।
- CI পাস করে। আপনি স্কোয়াশ এবং মার্জ করেন। কোথাও, একটি ফ্ল্যাকি পরীক্ষা "আঙ্কেল" বলে কাঁদে।
ভাল প্রম্পট দেখতে কেমন (এবং কী এড়াতে হবে)
- দারুণ: “SettingsPanel.tsx-এ একটি ডার্ক মোড টগল যোগ করুন; localStorage-এ স্থায়ী করুন; SettingsPanel.test.tsx আপডেট করুন; আমাদের ESLint নিয়ম অনুসরণ করুন; শুধুমাত্র /src/ui/ এবং /src/utils/ পরিবর্তন করুন; ২৫০ লাইন সর্বোচ্চ।”
- মাঝারি: “ডার্ক মোড প্রয়োগ করুন।”
নিরাপদ করুন: নিরাপত্তা এবং সম্মতি দ্রুত-চেক
- টোকেন সুযোগ: repo:contents write শুধুমাত্র প্রয়োজনে ব্যবহার করুন; PR তৈরির জন্য pull_request write পছন্দ করুন।
- রিপোজিটরি অ্যালোলিস্ট: বটকে একটি একক রেপো বা অর্গ-এ লক করুন।
- লগিং: নিশ্চিত করুন যে বট তার ক্রিয়া এবং প্রম্পটগুলি লগ করে (সিক্রেটগুলি বাদ দিয়ে)। এটি আপনার Dockerfile "উন্নত" করলে আপনি প্রমাণ চাইবেন।
- শাখা সুরক্ষা: ai/* শাখাগুলির জন্য দুটি মানুষের অনুমোদনের প্রয়োজন।
সমস্যা সমাধান: বট যখন বট হবে না
- এটি শাখা পুশ করতে পারে না: contents: write-এর জন্য Actions-এর অনুমতি পরীক্ষা করুন এবং আপনার টোকেনের repo লেখার অ্যাক্সেস আছে কিনা তা দেখুন।
- এটি খালি PR খোলে: আপনার কনটেক্সট বিল্ডার এটিকে সঠিক ফাইল দিচ্ছে না। আপনার ফাইল নির্বাচন লজিক কঠোর করুন।
- এটি বড় রেপোতে সময় শেষ করে: পরিবর্তিত পাথ বা একটি ম্যানিফেস্টের মধ্যে কনটেক্সট সীমাবদ্ধ করুন। AI ১০GB মনোরেপোতে বদহজম হয়, ঠিক আমাদের বাকিদের মতো।
- এটি আপনার PR টেমপ্লেট উপেক্ষা করে: নিশ্চিত করুন যে টেমপ্লেটটি .github/pull_request_template.md এ আছে বা আপনার রেপো সেটিংসে লিঙ্ক করা আছে।
কোন পথ কখন ব্যবহার করবেন
- আপনি যদি ইস্যু বা মন্তব্য থেকে স্বয়ংক্রিয়ভাবে PR তৈরি করার একটি হালকা উপায় চান, যেখানে সবকিছু GitHub-এ ঘটছে, তাহলে GitHub Actions ব্যবহার করুন।
- আপনি যদি চান Claude আপনার স্থানীয় পরিবেশে বা একাধিক টুলের মধ্যে খুব নির্দিষ্ট নিয়ন্ত্রণ সহ কাজ করুক, তাহলে MCP আপনাকে আরও ক্ষমতা দেয়।
লক্ষ্য করার মতো: আপনি যদি ওয়ার্কফ্লোর উপর দ্রুত সুস্থতা পরীক্ষা করতে চান বা একটি কঠিন স্টার্টার প্রম্পট তৈরি করতে চান, তাহলে Sider.AI আপনাকে PR টেমপ্লেট এবং গার্ড্রেইল প্রম্পট খসড়া করতে সাহায্য করতে পারে, তারপর বাস্তব রেপো স্নিপেট দিয়ে সেগুলিতে পুনরাবৃত্তি করতে পারে। এটি এমন একজন মতামতপূর্ণ সম্পাদকের মতো যিনি আসলে কোড লেখেন। এবং আপনার ডেস্ক চেয়ার চুরি করে না। সাধারণ প্যাটার্ন যা আপনি কপি করতে চাইবেন
- AI PR লেবেল এবং CODEOWNERS: ai/* PR-কে একটি পর্যালোচনা গ্রুপে রুট করুন যারা রোবটদের সাথে তর্ক করতে উপভোগ করে।
- ধাপে ধাপে কমিট: Claude-কে "stuff" নামের একটি মেগা-কমিটের পরিবর্তে পরিষ্কার বার্তা সহ ছোট, অ্যাটমিক কমিট তৈরি করতে বলুন।
- টেস্ট-ফার্স্ট মোড: ওয়ার্কফ্লোকে প্রথমে পরীক্ষা তৈরি করতে, CI চালাতে, তারপর বাস্তবায়ন তৈরি করতে বলুন। এটি ধীর। এটা ভালো।
- পোস্ট-মার্জ কাজ: ডক্স, ফিচার ফ্ল্যাগ বা পরিষ্কার করার জন্য স্বয়ংক্রিয়ভাবে একটি ফলো-আপ ইস্যু খোলার জন্য একটি ওয়ার্কফ্লো যুক্ত করুন।
একটি দ্রুত প্রতিযোগিতামূলক অভ্যন্তরীণ পরীক্ষা
- কিছু লোক অন্যান্য LLM-কে একই রকম GitHub ফ্লোতে ওয়্যারিং করছে। সেগুলি কাজ করে—তবে Claude Code-এর কোড যুক্তিবোধ এবং "আমি নিশ্চিত নই" বলার ইচ্ছুকতা আপনাকে ঘণ্টার পর ঘণ্টা অনুমান করা থেকে বাঁচাতে পারে। GitHub Actions ইন্টিগ্রেশন এটিকে ঠিক সেখানেই রাখে যেখানে পর্যালোচনা স্বাভাবিকভাবে ঘটে এবং MCP রুট পাওয়ার ব্যবহারকারীদের জন্য নমনীয়।
১০ মিনিটের সেটআপ চেকলিস্ট
- একটি পথ বেছে নিন: GitHub Actions (দ্রুত) বা MCP (আরও নিয়ন্ত্রণ)।
- ন্যূনতম সুযোগ সহ আপনার টোকেন তৈরি করুন।
- ওয়ার্কফ্লো যুক্ত করুন বা MCP সার্ভার কনফিগার করুন।
- একটি টাইট কনটেক্সট বিল্ডার তৈরি করুন: ফাইলের তালিকা, সীমা এবং নিয়ম।
- শাখা সুরক্ষা এবং লেবেল যুক্ত করুন।
- প্রথমে একটি ছোট পরিবর্তনে পরীক্ষা করুন। মার্জ করুন। উদযাপন করুন। আপনার PM কে বলুন আপনি "স্কেলড থ্রুপুট" করেছেন।
হাতে রাখার জন্য দ্রুত রেফারেন্স
- Claude Code GitHub Actions ডকুমেন্টেশন (প্যাটার্ন, ট্রিগার, উদাহরণ)।
- ইন্টিগ্রেশন এবং সেরা অনুশীলনের ব্যবহারিক গাইড।
- ভিডিও ওয়াকথ্রু: AI-জেনারেটেড PR শেষ থেকে শুরু।
- গ্র্যানুলার, অনুমতিযুক্ত অ্যাক্সেসের জন্য GitHub MCP সার্ভার।
- অনুপ্রেরণার জন্য MCP সার্ভার ডিরেক্টরি এবং উদাহরণ।
এখন যান এবং আপনার ভবিষ্যতকে একটু কম বদমেজাজি করুন। এবং যদি বটটি দুর্বৃত্ত হয়ে যায়? আপনি জানেন Revert বোতামটি কোথায় থাকে।
FAQ
