অধ্যায় 5 · মান, রিলিজ ও সামনের পথ
AI কোডিং অ্যাসিস্ট্যান্টের সাথে সফটওয়্যার ইঞ্জিনিয়ারিং
- পৃষ্ঠা 17 / 18
- 15 মিনিট পড়া
ফারহান তাঁর এডিটরে আধখানা বাক্য টাইপ করেন, আর একটা AI কোডিং অ্যাসিস্ট্যান্ট পুরো ফাংশনটাই শেষ করে দেওয়ার প্রস্তাব দেয়। আইকো একটা চ্যাট অ্যাসিস্ট্যান্টকে একটা এরর মেসেজের ব্যাখ্যা চান আর কয়েক সেকেন্ডে পরিষ্কার উত্তর পান। কোয়ামে বুকিংয়ের নিয়মগুলোর জন্য টেস্ট কেস প্রস্তাব করতে বলেন। এই টুলগুলো এখন রোজকার সফটওয়্যার কাজের অংশ, আর কোড কীভাবে লেখা হয় তা এরা বদলে দেয়। কিন্তু এর দায় কার, সেটা বদলায় না।
আগের পাতা সফটওয়্যার রিলিজ ও রক্ষণাবেক্ষণ-এ ClinicQueue আসল রোগীদের কাছে পৌঁছেছে। এই পাতা হলো, আপনি যে পুরো লাইফ সাইকেল পড়েছেন তার সব জায়গায় AI অ্যাসিস্ট্যান্ট কীভাবে ভালোভাবে ব্যবহার করবেন: কোথায় এরা সাহায্য করে, কোথায় বিভ্রান্ত করে, কোন নিয়ম একটা টিমকে নিরাপদ রাখে, একটা কাজের ধারা আর বিশ্বাসযোগ্য কিন্তু ভুল একটা প্রস্তাব ধরার কাজ-করা উদাহরণ, আর একটা টুল যখন আপনার হয়ে কোড লিখতে পারে তখন কীভাবে শেখা চালিয়ে যাবেন। ClinicQueue-এর নিজের AI ফিচার (রিমাইন্ডার টেক্সটের খসড়া) থেকে পার্থক্যটা খেয়াল করুন: সেটা প্রোডাক্টের ভেতরের AI; এই পাতা হলো টিম যেভাবে প্রোডাক্টটা বানায় সেই প্রক্রিয়ার AI।
যা শিখবেন
- সফটওয়্যার লাইফ সাইকেলের কোথায় কোথায় AI কোডিং অ্যাসিস্ট্যান্ট সাহায্য করে, আর সাধারণত কোন কোন ভাবে বিভ্রান্ত করে।
- পাঁচটা নিয়ম: কোডের মালিক আপনি, সবকিছু রিভিউ করুন, টেস্ট চালান, কখনো গোপন তথ্য বা ব্যক্তিগত ডেটা পেস্ট করবেন না, আর লাইসেন্সের ব্যাপারে সচেতন থাকুন।
- একটা ছোট কাজের ধারা (পরিকল্পনা, ছোট করে চাওয়া, রিভিউ, টেস্ট, কমিট), আর সেটা কীভাবে বিশ্বাসযোগ্য কিন্তু ভুল একটা প্রস্তাব ধরে ফেলে।
- অ্যাসিস্ট্যান্ট ব্যবহার করার সময় কীভাবে নিজের দক্ষতা ধরে রাখবেন আর বাড়াবেন।
অ্যাসিস্ট্যান্ট কীসে ভালো, কীসে খারাপ
AI কোডিং অ্যাসিস্ট্যান্ট হলো একটা লার্জ ল্যাঙ্গুয়েজ মডেলের ওপর তৈরি টুল, যা আপনার নির্দেশ আর যে কোড সে দেখতে পায় তা থেকে কোড, টেস্ট, ব্যাখ্যা বা টেক্সট প্রস্তাব করে। তাকে যা দেওয়া হয়েছে, তার একটা সম্ভাব্য ধারাবাহিকতা সে অনুমান করে তৈরি করে, যে টেক্সট থেকে সে শিখেছে তার ধরন দেখে। এ কারণেই তার উত্তর সাধারণত সাবলীল আর প্রায়ই কাজের, আবার এ কারণেই সে আত্মবিশ্বাসের সাথে ভুলও হতে পারে: ঠিক শোনানো আর ঠিক হওয়া আলাদা জিনিস।
প্রোভাইডার নোট: এই পাতা ইচ্ছা করেই কোনো প্রোডাক্টের নাম নেয় না। অ্যাসিস্ট্যান্টগুলো কোথায় চলে, কী জমা রাখে আর তাদের লাইসেন্সের শর্ত কী, তাতে পার্থক্য আছে, আর এগুলো প্রায়ই বদলায়। কাজে একটা ব্যবহার করার আগে তার বর্তমান ডেটা ও লাইসেন্সের শর্ত আর আপনার প্রতিষ্ঠানের নীতি পড়ুন।
লাইফ সাইকেল জুড়ে
এই টিউটোরিয়ালের শুরুতে যে SDLC দেখেছেন, তার প্রতিটা কাজেই একই শক্তি আর দুর্বলতা দেখা যায়:
| কাজ | কোথায় সাহায্য করে | কীভাবে বিভ্রান্ত করতে পারে | আপনার যাচাই |
|---|---|---|---|
| রিকোয়ারমেন্ট | নাদিয়ার জন্য প্রশ্নের খসড়া; একটা ইউজার স্টোরিতে বাদ পড়া ক্ষেত্র ধরা ("রোগীর ফোন না থাকলে কী হবে?") | যুক্তিসঙ্গত শোনায় এমন রিকোয়ারমেন্ট বানিয়ে ফেলে, যা কেউ চায়নি | প্রতিটা রিকোয়ারমেন্ট তবু একজন স্টেকহোল্ডারের কাছ থেকেই আসে; টুলকে নয়, নাদিয়াকে জিজ্ঞেস করুন |
| ডিজাইন | বিকল্পগুলো (প্রতিটা এনটিটির জন্য আলাদা টেবিল নাকি একটা ভাগ করা টেবিল) আর তাদের ট্রেড-অফ ব্যাখ্যা করা | ছোট একটা ক্লিনিক অ্যাপের জন্য জটিল ডিজাইন প্রস্তাব করে; আপনার সীমাবদ্ধতা উপেক্ষা করে | সফটওয়্যার ডিজাইনের মূল কথা: রিকোয়ারমেন্ট থেকে মডিউল-এর ডিজাইন চেকলিস্টের সাথে মিলিয়ে দেখুন |
| কোড | গতানুগতিক কোড, ছোট ফাংশন, রেগুলার এক্সপ্রেশন, অপরিচিত কোড আর এরর মেসেজের ব্যাখ্যা | সূক্ষ্ম বাগসহ বিশ্বাসযোগ্য কোড; এমন ফাংশন বা প্যাকেজ যার অস্তিত্বই নেই; পুরোনো হয়ে যাওয়া পদ্ধতি | প্রতিটা লাইন পড়ুন; চালিয়ে দেখুন; যে লাইব্রেরি ব্যবহার করে তা সত্যিই আছে আর রক্ষণাবেক্ষণ হয় কি না যাচাই করুন |
| টেস্ট | টেস্ট কেস আর এজ কেস প্রস্তাব; একঘেয়ে টেস্ট কোড লেখা | এমন টেস্ট যা শুধু কোড এখন যা করে তা-ই নিশ্চিত করে, বাগসহ | প্রত্যাশিত ফল কোড থেকে নয়, রিকোয়ারমেন্ট থেকে বের করুন (সফটওয়্যারের মান, টেস্টিং ও QA পাতার মতো পার্টিশন আর বাউন্ডারি) |
| ডকুমেন্টেশন | README, docstring, রিলিজ নোটের প্রথম খসড়া | এমন ফিচারের বর্ণনা দেয় যা নেই, বা এমন ধাপ যা কাজ করে না | একটা পরিষ্কার মেশিনে README-র ধাপগুলো নিজে অনুসরণ করুন |
| রিভিউ ও রক্ষণাবেক্ষণ | বড় একটা diff-এর সারাংশ; রিফ্যাক্টরিংয়ের প্রস্তাব; পুরোনো কোডের ব্যাখ্যা | যে একটা লাইন আসলে গুরুত্বপূর্ণ সেটাই বাদ পড়ে; রিফ্যাক্টর করতে গিয়ে আচরণ বদলে ফেলে | একজন মানুষ রিভিউয়ার তবু অনুমোদন দেন; রিফ্যাক্টরিংয়ের পরেও টেস্ট পাস করতে হবে |
অ্যাসিস্ট্যান্ট ব্যবহারের পাঁচটা নিয়ম
১. কোডের মালিক আপনি
যে কোড একটা অ্যাসিস্ট্যান্ট প্রস্তাব করেছে আর আপনি কমিট করেছেন, সেটা আপনার কোড। সেটা ভুল রোগীকে রিমাইন্ডার পাঠালে "টুলটা লিখেছে" এমন উত্তর নাদিয়া মানবেন না, আর আপনারও এমন উত্তর দেওয়া উচিত নয়। শুধু সেই কোড কমিট করুন যা আপনি একজন রিভিউয়ারকে লাইন ধরে ধরে ব্যাখ্যা করতে পারেন।
২. সবকিছু রিভিউ করুন
প্রস্তাবিত কোড অন্তত একজন সহকর্মীর পুল রিকোয়েস্টের মতোই যত্ন নিয়ে রিভিউ করুন, কোড রিভিউ, ভার্সন কন্ট্রোল ও টিমের কাজের ধারা-র সেই রিভিউ চেকলিস্ট দিয়েই। যে অংশগুলো একঘেয়ে দেখায়, সেগুলোতে বাড়তি সাবধান থাকুন: তুলনা (< নাকি <=), তারিখ ও সময় সামলানো, এরর হ্যান্ডলিং, আর নিরাপত্তা বা ব্যক্তিগত ডেটা ছোঁয় এমন যেকোনো কিছু। লম্বা, পরিপাটি একটা প্রস্তাব ছোট একটার চেয়ে বেশি ঠিক হওয়ার সম্ভাবনা রাখে না।
৩. টেস্ট চালান
টেস্ট পাস না করা পর্যন্ত একটা প্রস্তাব শুধু একটা অনুমান। যেকোনো পরিবর্তন গ্রহণ করার পর আগের টেস্টগুলো চালান, আর নতুন আচরণের জন্য টেস্ট যোগ করুন। ওই অংশে এখনো টেস্ট না থাকলে আগে কয়েকটা লিখুন; তাহলে অ্যাসিস্ট্যান্টের কোডকে নিজেকে প্রমাণ করার মতো কিছু থাকে।
৪. কখনো গোপন তথ্য বা ব্যক্তিগত ডেটা পেস্ট করবেন না
অ্যাসিস্ট্যান্টে আপনি যা টাইপ বা পেস্ট করেন, টুল আর তার সেটিংসের ওপর নির্ভর করে তা আপনার কম্পিউটারের বাইরে যেতে পারে আর জমা থাকতে পারে। একটা প্রম্পটকে একজন অচেনা মানুষকে পাঠানো ইমেইলের মতো দেখুন।
| কখনো পেস্ট করবেন না | তার বদলে ব্যবহার করুন |
|---|---|
| রোগীদের আসল নাম, ফোন নম্বর, অ্যাপয়েন্টমেন্ট বা নোট | কাল্পনিক নমুনা ডেটা ("Mitu", "+000 0000 0000") |
| SMS প্রোভাইডারের API কি (key), ডেটাবেসের পাসওয়ার্ড, টোকেন | একটা প্লেসহোল্ডার নাম ("SMS_API_KEY সেটিংস থেকে পড়ুন") |
| প্রোডাকশন ডেটাবেস বা তার লগের কপি | শুধু টেবিলের কাঠামো, কাল্পনিক সারিসহ |
| কোনো ক্লায়েন্টের গোপনীয় কোড, যদি আপনার চুক্তি তা শেয়ার করা নিষেধ করে | সমস্যাটার ছোট, নতুন করে লেখা একটা উদাহরণ |
ভুল করে কোনো গোপন তথ্য পেস্ট হয়ে গেলে ধরে নিন সেটা ফাঁস হয়ে গেছে: টিম লিডকে জানান আর কি বা পাসওয়ার্ডটা বদলে ফেলুন। কেউ দেখেনি বলে আশা করা কোনো পরিকল্পনা নয়।
৫. লাইসেন্সের ব্যাপারে সচেতন থাকুন
প্রস্তাবিত কোড লাইসেন্সের আওতায় থাকা কোনো বিদ্যমান কোডের সাথে খুব মিলে যেতে পারে, আর একটা প্রস্তাব যে লাইব্রেরিগুলো ইমপোর্ট করে, তাদের প্রত্যেকের নিজস্ব লাইসেন্সের শর্ত আছে। আপনাকে আইনজীবী হতে হবে না, কিন্তু তিনটা কাজ করুন: অ্যাসিস্ট্যান্ট ব্যবহার নিয়ে আপনার প্রতিষ্ঠানের নীতি মানুন; যোগ করার আগে প্রতিটা নতুন ডিপেন্ডেন্সির লাইসেন্স যাচাই করুন (অ্যাসিস্ট্যান্ট ছাড়াও যেমন করতেন); আর এমন লম্বা প্রস্তাবে সাবধান থাকুন যা দেখে মনে হয় কোথাও থেকে কপি করা, বিশেষ করে ক্লায়েন্টের প্রজেক্টে, যেখানে আপনি প্রতিশ্রুতি দেন যে কোডটা হস্তান্তর করার অধিকার আপনার আছে।
একটা কাজের ধারা: পরিকল্পনা, ছোট করে চাওয়া, রিভিউ, টেস্ট, কমিট
একটা সহজ চক্রের মধ্য দিয়ে নিয়মগুলো অভ্যাসে পরিণত হয়। এটা এই টিউটোরিয়ালের বাকি অংশের একই শৃঙ্খলা, শুধু তার একটা ধাপে অ্যাসিস্ট্যান্ট আছে।
উদাহরণ:
1 PLAN 2 ASK SMALL 3 REVIEW 4 TEST 5 COMMIT
+-----------+ +---------------+ +----------------+ +----------------+ +---------------+
| what, why |-->| one function, |--->| read each line,|--->| run old + new |-->| small commit, |
| acceptance| | with context, | | can I explain | | tests, add | | clear message,|
| criteria | | no secrets | | it? edge cases?| | boundary tests | | normal review |
+-----------+ +---------------+ +----------------+ +----------------+ +---------------+
^ | wrong or unclear |
+-------------------------------------+-----------------------------------------+
go back: refine the plan or the request, or write it yourselfআগে পরিকল্পনা: চাওয়ার আগেই জানুন পরিবর্তনটাকে কী করতে হবে আর কীভাবে বুঝবেন যে কাজ করছে। ছোট করে চাওয়া: একবারে একটা ফাংশন বা একটা টেস্ট, প্রাসঙ্গিক প্রেক্ষাপটসহ, এমন কিছু দেয় যা আপনি সত্যিই রিভিউ করতে পারেন। রিভিউ আর টেস্ট নিয়মগুলোর মতোই। কমিট করুন ছোট ছোট ধাপে, স্বাভাবিক পুল রিকোয়েস্ট আর রিভিউয়ের মধ্য দিয়ে, যাতে একটা খারাপ প্রস্তাব খুঁজে পাওয়া আর বাতিল করা সহজ হয়।
কাজ-করা উদাহরণ: বিশ্বাসযোগ্য কিন্তু ভুল একটা প্রস্তাব
একজন ডাক্তারের নতুন স্লট আগের কোনো স্লটের সাথে মিলে (overlap) গেলে ClinicQueue-কে সেটা প্রত্যাখ্যান করতে হবে। ফারহান আগে পরিকল্পনা করেন: অ্যাকসেপ্টেন্স ক্রাইটেরিয়া বলে স্লট ১৫ মিনিটের, আর পরপর লাগানো (back-to-back) স্লট চলবে (০৯:০০ থেকে ০৯:১৫ আর ০৯:১৫ থেকে ০৯:৩০)। তারপর তিনি ছোট করে চান:
উদাহরণ:
Write a Python function overlaps(a_start, a_end, b_start, b_end) that returns True if two
appointment slots overlap. Times are "HH:MM" strings on the same day. Back-to-back slots
(one ends exactly when the other starts) do NOT overlap. Standard library only, no comments.অ্যাসিস্ট্যান্ট এক লাইনের একটা পরিপাটি ফাংশন ফেরত দেয়। দেখতে ঠিক লাগে, আর রিভিউতে এক নজরে পার পেয়ে যেত। ফারহান এক নজরে ভরসা করেন না: তিনি অ্যাকসেপ্টেন্স ক্রাইটেরিয়া থেকে, বাউন্ডারিতে, নিজের যাচাইগুলো লেখেন, ঠিক টেস্টিংয়ের পাতার মতো।
def overlaps(a_start, a_end, b_start, b_end):
"""Suggested by the assistant: do two slots overlap? Times are 'HH:MM' strings."""
return a_start <= b_end and b_start <= a_end
# Farhan's own checks, chosen at the boundaries (start of one slot = end of the other)
cases = [
("09:00", "09:15", "09:10", "09:25", True), # real overlap
("09:00", "09:15", "09:15", "09:30", False), # back to back: both allowed
("09:15", "09:30", "09:00", "09:15", False), # back to back, other order
("09:00", "09:15", "09:30", "09:45", False), # clear gap
]
def check(function):
for a_start, a_end, b_start, b_end, expected in cases:
got = function(a_start, a_end, b_start, b_end)
verdict = "ok" if got == expected else "WRONG"
print(f"{a_start}-{a_end} vs {b_start}-{b_end}: expected {expected!s:<5} got {got!s:<5} {verdict}")
check(overlaps)09:00-09:15 vs 09:10-09:25: expected True got True ok
09:00-09:15 vs 09:15-09:30: expected False got True WRONG
09:15-09:30 vs 09:00-09:15: expected False got True WRONG
09:00-09:15 vs 09:30-09:45: expected False got False okপ্রস্তাবটা পরপর লাগানো স্লটগুলোকে মিলে যাওয়া ধরে নেয়, ফলে ক্লিনিক কখনো ০৯:০০-এর পরে ০৯:১৫ বুক করতে পারত না, যেটা সবচেয়ে সাধারণ ঘটনা। কারণ হলো যেখানে < দরকার সেখানে <=: টেস্টিংয়ের পাতার বুকিং বাগের মতোই বাউন্ডারির ভুল। খেয়াল করুন, অনুরোধেই লেখা ছিল "back-to-back slots do NOT overlap"; প্রম্পটের কোনো নির্দেশ মানার সম্ভাবনা আছে, নিশ্চয়তা নেই। মাঝামাঝি একটা মান (০৯:১০) দিয়ে টেস্ট পাস করেছিল, তাই শুধু বাউন্ডারির কেসগুলোই ভুলটা ধরিয়ে দিয়েছে।
টেস্ট কাকতালীয়ভাবে পাস না করা পর্যন্ত ফারহান অ্যাসিস্ট্যান্টকে "আবার চেষ্টা করো" বলেন না। তিনি নিজে যুক্তিটা ভেবে দেখেন: দুটো স্লট মিলে যায় শুধু তখন, যখন প্রত্যেকটা অন্যটা শেষ হওয়ার আগে শুরু হয়। তারপর তিনি এটা ঠিক করেন আর একই যাচাইগুলো চালান:
def overlaps(a_start, a_end, b_start, b_end):
"""Two slots overlap only if each one starts before the other ends."""
return a_start < b_end and b_start < a_end
check(overlaps)09:00-09:15 vs 09:10-09:25: expected True got True ok
09:00-09:15 vs 09:15-09:30: expected False got False ok
09:15-09:30 vs 09:00-09:15: expected False got False ok
09:00-09:15 vs 09:30-09:45: expected False got False okতিনি চারটা কেস unittest স্যুটে সরিয়ে নেন, যাতে প্রতিটা push-এ সেগুলো চলে, আর fix: back-to-back slots no longer count as overlapping মেসেজ দিয়ে কমিট করেন। পুল রিকোয়েস্টে আইকো ফাংশন আর টেস্ট একসাথে রিভিউ করেন। ভুলটার মোট দাম: কয়েক মিনিট, রোগীদের বুক করতে না পারার এক সপ্তাহ নয়।
নিজের দক্ষতা ধরে রাখা আর বাড়ানো
একটা অ্যাসিস্ট্যান্ট আপনার বোঝার চেয়ে দ্রুত কোড তৈরি করতে পারে। আপনি শুধু গ্রহণ করে গেলে শেখা থেমে যায়, আর ঠিক সেই দক্ষতাটা হারান যা তার ভুল ধরতে লাগে: ফারহান বাগটা খুঁজে পেয়েছেন কারণ তিনি বাউন্ডারি বোঝেন আর যাচাইগুলো নিজে লিখতে পারেন।
যে অভ্যাসগুলো শেখা চালু রাখে
- গ্রহণের আগে বুঝুন। কোনো লাইন ব্যাখ্যা করতে না পারলে অ্যাসিস্ট্যান্টকে ব্যাখ্যা করতে বলুন, তারপর সেই ব্যাখ্যা ডকুমেন্টেশন বা ছোট একটা পরীক্ষা দিয়ে যাচাই করুন।
- আগে নিজে চেষ্টা, তারপর তুলনা। অনুশীলনের কাজে আগে নিজের ভার্সন লিখুন, তারপর একটা চেয়ে নিয়ে তুলনা করুন। পার্থক্যগুলো যেকোনো একটা ভার্সনের চেয়ে বেশি শেখায়।
- টেস্ট নিজে লিখুন। সঠিক মানে কী, তা ঠিক করাই ইঞ্জিনিয়ারিংয়ের মূল দক্ষতা; এটা নিজের কাছে রাখুন।
- মাঝে মাঝে এটা ছাড়া কাজ করুন। কিছু সমস্যা শুধু ডকুমেন্টেশন দিয়ে সমাধান করুন, যেভাবে ইন্টারভিউতে বা টুল বন্ধ থাকলে করবেন।
- এর ভুলগুলোর একটা তালিকা রাখুন। বারবার আসা ধরন (তারিখ, বাউন্ডারি, পুরোনো লাইব্রেরি কল) বলে দেয় পরের বার কোথায় সবচেয়ে বেশি খুঁজতে হবে।
যেখানে অভিজ্ঞদের মধ্যে মতভেদ
| দৃষ্টিভঙ্গি | যুক্তি | আপনার জন্য এর পরামর্শ |
|---|---|---|
| ব্যাপকভাবে ব্যবহার করুন | এটা গতানুগতিক কাজ সরিয়ে দেয় আর অপরিচিত কোড ব্যাখ্যা করে; একটা কাজের টুল প্রত্যাখ্যান করা কোনো গুণ নয় | পাঁচটা নিয়মের মধ্যে থেকে গতানুগতিক কোড আর ব্যাখ্যার জন্য ব্যবহার করুন |
| শিক্ষার্থীদের জন্য সীমিত রাখুন | নতুনরা এখনো এর আউটপুট বিচার করতে পারেন না, আর যে পরিশ্রম দক্ষতা গড়ে তা এড়িয়ে যেতে পারেন | নতুন বিষয়ে আগে এটা ছাড়া মূল কথা শিখুন, তারপর আরও এগোতে এটা ব্যবহার করুন |
| কিছু কাজে সীমিত রাখুন | নিরাপত্তার কোড, ব্যক্তিগত ডেটা আর ক্লায়েন্টের চুক্তিতে বিশেষ ঝুঁকি থাকে | টিম আর ক্লায়েন্টের নীতি মানুন; নিশ্চিত না হলে জিজ্ঞেস করুন |
একজন শিক্ষার্থীর জন্য যুক্তিসঙ্গত মাঝামাঝি পথ: অ্যাসিস্ট্যান্টকে ব্যাখ্যা করতে আর আপনার চিন্তা রিভিউ করতে ব্যবহার করুন, কোড তৈরি করাতে মূলত সেসব জিনিসের জন্য ব্যবহার করুন যা আপনি নিজেও লিখতে পারতেন, আর কখনো এমন কিছুর জন্য নয় যা আপনি যাচাই করতে পারবেন না। ন্যায্যতা, গোপনীয়তা, AI ব্যবহার নিয়ে সততা আর দায় কার, এমন বড় প্রশ্নগুলো আছে AI নৈতিকতা ও দায়িত্বশীল ব্যবহার: বিগিনার-এ, আর পরিষ্কার অনুরোধ লেখা ও AI-এর আউটপুট যাচাই করা আছে AI-এর জন্য প্রম্পট ইঞ্জিনিয়ারিং: বিগিনার-এ।
কাজের জায়গায় এটা কোথায় লাগে
- অনেক টিম অ্যাসিস্ট্যান্ট ব্যবহার নিয়ে একটা ছোট নীতি লেখে: কোন টুল অনুমোদিত, কোন ডেটা কখনো পেস্ট করা যাবে না, আর পুল রিকোয়েস্টে অ্যাসিস্ট্যান্ট ব্যবহারের কথা উল্লেখ করতে হবে কি না।
- যে বা যা-ই লিখুক, প্রতিটা পরিবর্তনের কোড রিভিউ একই; রিভিউয়াররা জিজ্ঞেস করেন "এটা কীভাবে টেস্ট করেছেন?"
- ইন্টারভিউ আর প্রবেশন পর্বে এখনো যাচাই করা হয় আপনি নিজে কোড নিয়ে যুক্তি করতে পারেন কি না।
- ফ্রিল্যান্সাররা তাঁদের চুক্তি দেখে নেন: কিছু ক্লায়েন্ট বাইরের সার্ভিসের সাথে কোড শেয়ার করা সীমিত করেন, বা AI ব্যবহারের কথা জানাতে বলেন।
সাধারণ ভুল
- পেশাদার দেখায় বলে একটা প্রস্তাব গ্রহণ করা। সাবলীল কোডও একটা অক্ষরে ভুল হতে পারে। সমাধান: প্রতিটা লাইন রিভিউ করুন আর বাউন্ডারি টেস্ট করুন।
- একবারে পুরো একটা ফিচার চাওয়া। ফলাফল ঠিকমতো রিভিউ করার পক্ষে খুব বড় হয়। সমাধান: আগে পরিকল্পনা, তারপর একবারে ছোট একটা টুকরো চান।
- "প্রেক্ষাপট দেওয়ার জন্য" আসল ডেটা বা কি পেস্ট করা। সমাধান: কাল্পনিক ডেটা আর প্লেসহোল্ডার ব্যবহার করুন; কোনো গোপন তথ্য ফাঁস হলে সঙ্গে সঙ্গে সেটা বদলে দিন।
- কোড আর একমাত্র টেস্ট দুটোই অ্যাসিস্ট্যান্টকে দিয়ে লেখানো। টেস্টগুলো হয়তো শুধু তার বাগটাই নিশ্চিত করবে। সমাধান: প্রত্যাশিত ফল রিকোয়ারমেন্ট থেকে নিজে বের করুন।
- টেস্ট পাস না করা পর্যন্ত বারবার চাওয়া। এমন কোড পান যা এই টেস্টগুলো পাস করে, কিন্তু কেন, তা কেউ বোঝে না। সমাধান: ফেইলিওরটা বুঝুন, তারপর নিজে ঠিক করুন বা নতুন করে লিখুন।
নিজে চেষ্টা করুন
- সহজ: আইকো একটা বাগে সাহায্য চান আর এই অনুরোধটা লেখেন: "Here is our settings file with the SMS key SMSKEY-1234-EXAMPLE and three real bookings from today's log (Mitu Akter, +880 17..., 10:30). Why does the reminder fail?" এতে কী কী ভুল আছে লিখুন, আর নিরাপদভাবে আবার লিখুন।
- মাঝারি: একটা অ্যাসিস্ট্যান্ট "একজন রোগী ১ থেকে ১৪ দিন আগে বুক করতে পারেন" নিয়মের জন্য কোড প্রস্তাব করে, আর
clinic_date_utilsনামের একটা প্যাকেজ ইমপোর্ট করে, যার নাম টিমের কেউ শোনেনি। গ্রহণ করার আগে কোন কোন যাচাই করবেন, ক্রম অনুযায়ী লিখুন। - কঠিন: রোগীদের ডেটা নিয়ে কাজ করা ClinicQueue-এ AI কোডিং অ্যাসিস্ট্যান্ট ব্যবহারের জন্য একটা ছোট নীতি লিখুন (পাঁচটা নিয়ম, প্রতিটার এক লাইনের কারণসহ)। তারপর বলুন একজন রিভিউয়ার একটা পুল রিকোয়েস্টে কীভাবে যাচাই করতে পারেন যে নীতিটা মানা হয়েছে।
উত্তর
- ভুল: এতে একটা চালু গোপন কি পেস্ট করা হয়েছে (যেটাকে এখন ফাঁস হয়ে যাওয়া ধরে বদলে ফেলতে হবে), আর রোগীদের আসল নাম, ফোন নম্বর ও অ্যাপয়েন্টমেন্টের তথ্য (ব্যক্তিগত ডেটা)। প্রাসঙ্গিক অংশের বদলে পুরো একটা ফাইলও দেওয়া হয়েছে। নিরাপদভাবে আবার লেখা: "আমাদের Python রিমাইন্ডার জব এই এররে ফেল করছে: [এরর মেসেজ, কোনো কি বা নাম বাদ দিয়ে]। এটা SMS_API_KEY নামের একটা সেটিং থেকে SMS-এর কি পড়ে। এখানে SMS পাঠানোর ফাংশনটা দিলাম, কাল্পনিক নমুনা ডেটাসহ (রোগী 'Mitu', ফোন '+000 0000 0000', 10:30)। সম্ভাব্য কারণগুলো কী?" ভালো উত্তর সব গোপন তথ্য আর ব্যক্তিগত ডেটা সরিয়ে প্লেসহোল্ডার বা কাল্পনিক মান বসায়, শুধু দরকারি কোড আর এররটা দেয়, আর বলে যে ফাঁস হওয়া কি বদলাতে হবে।
- ক্রম অনুযায়ী: (১) যাচাই করুন প্যাকেজটা সত্যিই অফিশিয়াল প্যাকেজ ইনডেক্সে আছে আর আপনি যেটা ভাবছেন সেটাই (অ্যাসিস্ট্যান্ট কখনো কখনো নাম বানিয়ে ফেলে, আর দেখতে একই রকম একটা প্যাকেজ ক্ষতিকর হতে পারে); (২) যাচাই করুন এটার রক্ষণাবেক্ষণ হয় আর এর লাইসেন্স আপনার ব্যবহারের অনুমতি দেয়; (৩) জিজ্ঞেস করুন এটা আদৌ দরকার কি না: এই নিয়মে একটা তুলনাই লাগে, স্ট্যান্ডার্ড লাইব্রেরিই যথেষ্ট, তাই সাধারণত সবচেয়ে ভালো সমাধান ইমপোর্টটা বাদ দেওয়া; (৪) কোডটা লাইন ধরে রিভিউ করুন, বিশেষ করে
<বনাম<=; (৫) টেস্টিংয়ের পাতার বাউন্ডারি টেস্ট ০, ১, ১৪ আর ১৫ চালান। ভালো উত্তর অস্তিত্ব আর প্রয়োজনকে সবকিছুর আগে রাখে, আর নিয়ম থেকে বের করা টেস্ট দিয়ে শেষ করে। - মডেল উত্তর: (১) শুধু ক্লিনিকের অনুমোদিত অ্যাসিস্ট্যান্ট ব্যবহার করুন, কারণ তার ডেটার শর্ত যাচাই করা হয়েছে। (২) কখনো রোগীর ডেটা, কি বা প্রোডাকশন লগ পেস্ট করবেন না; কাল্পনিক ডেটা ব্যবহার করুন, কারণ প্রম্পট আমাদের নিয়ন্ত্রণের বাইরে জমা থাকতে পারে। (৩) ছোট টুকরো চান আর শুধু সেই কোড কমিট করুন যা ব্যাখ্যা করতে পারেন, কারণ এর দায় আপনার। (৪) প্রতিটা পরিবর্তনে এমন টেস্ট লাগবে যা একজন মানুষ রিকোয়ারমেন্ট থেকে লিখেছেন বা যাচাই করেছেন, কারণ তৈরি করে দেওয়া টেস্ট তৈরি করে দেওয়া বাগকেই নিশ্চিত করতে পারে। (৫) যেকোনো নতুন ডিপেন্ডেন্সির লাইসেন্স আর অস্তিত্ব যাচাই করুন, কারণ প্রস্তাবে অজানা বা অনুপযুক্ত প্যাকেজের নাম থাকতে পারে। রিভিউয়ারের যাচাই: পুল রিকোয়েস্টটা ছোট; এতে নিয়মের বাউন্ডারির টেস্ট আছে; diff বা বর্ণনায় কোনো কি, আসল নাম বা ফোন নম্বর নেই; নতুন ডিপেন্ডেন্সিগুলো তাদের লাইসেন্সসহ তালিকায় আছে; লেখক উত্তর দিতে পারেন "এই লাইনটা কেন কাজ করে?" ভালো উত্তরে কারণসহ নিয়ম থাকে, ডেটা, মালিকানা, টেস্টিং আর লাইসেন্স কভার করে, আর এমন যাচাই দেয় যা একজন রিভিউয়ার পুল রিকোয়েস্টে সত্যিই দেখতে পান।
সারসংক্ষেপ
- AI কোডিং অ্যাসিস্ট্যান্ট লাইফ সাইকেলের প্রতিটা কাজে সাহায্য করে, রিকোয়ারমেন্টের প্রশ্ন থেকে ডকুমেন্টেশন পর্যন্ত, কিন্তু একই সাথে সাবলীল আর ভুল হতে পারে।
- পাঁচটা নিয়ম: কোডের মালিক আপনি; সবকিছু রিভিউ করুন; টেস্ট চালান; কখনো গোপন তথ্য বা ব্যক্তিগত ডেটা পেস্ট করবেন না; লাইসেন্স আর প্রতিটা নতুন ডিপেন্ডেন্সি আসলে কী, সে ব্যাপারে সচেতন থাকুন।
- একটা চক্রে কাজ করুন: পরিকল্পনা, ছোট করে চাওয়া, রিভিউ, টেস্ট, কমিট; আপনার নিজের লেখা বাউন্ডারি টেস্ট বিশ্বাসযোগ্য কিন্তু ভুল প্রস্তাব ধরে ফেলে।
- গ্রহণের আগে বুঝে, নিজের টেস্ট নিজে লিখে আর মাঝে মাঝে টুল ছাড়া কাজ করে নিজের দক্ষতা ধরে রাখুন।
- দায় টুলের কাছে চলে যায় না: ইউজারদের কাছে কী পৌঁছাবে, তা টিম তার স্বাভাবিক রিভিউ আর রিলিজ প্রক্রিয়ার মধ্য দিয়ে ঠিক করে।
এরপর: প্র্যাকটিস ল্যাব ও ক্যাপস্টোন: একটা ছোট প্রজেক্টের শুরু থেকে শেষ পর্যন্ত পরিকল্পনা: পাঁচটা ছোট অনুশীলন, যা পুরো টিউটোরিয়াল আবার কাজে লাগায়, আর একটা ক্যাপস্টোন, যেখানে আপনি সমস্যার বিবরণ থেকে রিলিজ পরিকল্পনা পর্যন্ত নিজের প্রজেক্টের পরিকল্পনা করবেন।

