স্কিল ও টুল
ভাগ করা স্কিলগুলো থাকে .agents/skills/-এ। এই সোর্সগুলো সম্পাদনা করুন, তারপর Claude Code-এর জন্য .claude/skills/ তৈরি করতে yarn ai-workflow:sync চালান। Codex সরাসরি .agents/skills/ থেকে স্কিল খুঁজে নেয়।
ভাগ করা রোল প্রম্পটগুলো থাকে .agents/roles/*.md-এ। এটি রিপোজিটরি-নির্দিষ্ট একটি সোর্স ফরম্যাট, কোনো নেটিভ এজেন্ট ডিসকভারি পাথ নয়। scripts/ai-workflow-files.mjs এই সোর্সগুলোকে নিচের অ্যাপ-নির্দিষ্ট ফাইলে রূপান্তর করে; yarn ai-workflow:sync সেগুলো লেখে। জেনারেট হওয়া ফাইলগুলো তাদের সোর্সের সঙ্গেই কমিট করুন, যাতে নতুন চেকআউটে আগে কোনো জেনারেটর না চালিয়েই নেটিভ কনফিগারেশন পাওয়া যায়। কোনো সোর্স সরিয়ে ফেলার পরে তার অপ্রচলিত জেনারেট হওয়া আউটপুটগুলো স্পষ্টভাবে মুছে দিন; ভ্যালিডেটর নীরবে ফাইল মুছে না দিয়ে সেগুলোর কথা জানায়।
নেটিভ ডিসকভারি পাথ
2026-09-12 তারিখে অফিশিয়াল ডকুমেন্টেশনের সঙ্গে মিলিয়ে যাচাই করা:
| অ্যাপ | প্রজেক্ট নির্দেশনা | এই রিপোজিটরিতে ব্যবহৃত স্কিল | এই রিপোজিটরিতে ব্যবহৃত কাস্টম এজেন্ট |
|---|---|---|---|
| Codex | AGENTS.md | .agents/skills/<name>/SKILL.md | জেনারেট করা .codex/agents/<name>.toml |
| Claude Code | CLAUDE.md @AGENTS.md ইমপোর্ট করে | জেনারেট করা .claude/skills/<name>/SKILL.md | জেনারেট করা .claude/agents/<name>.md |
সূত্র: Codex স্কিল, Codex সাবএজেন্ট, Claude মেমরি, Claude স্কিল, Claude সাবএজেন্ট।
নেটিভ এজেন্ট ডিরেক্টরিগুলোর জায়গায় .agents/roles বসাবেন না, কিংবা ধরে নেবেন না যে Claude .agents/skills খুঁজে পায়। তবে সেখানে থাকা কোনো উল্লেখিত ফাইল Claude সাধারণ প্রজেক্ট কনটেক্সট হিসেবে পড়তে পারে।
AI ডিরেক্টরিগুলো .gitattributes-এর মাধ্যমে LF লাইন এন্ডিং ব্যবহার করে, যাতে জেনারেট হওয়া লেখা সব প্ল্যাটফর্মে হুবহু এক থাকে। সহায়ক স্কিল অ্যাসেটগুলো বাইট-বাই-বাইট কপি করা হয়।
স্কিল
| স্কিল | উদ্দেশ্য |
|---|---|
commit | অনুমোদিত, পরিধি-সীমিত স্থানীয় কমিট তৈরি |
commit-format, issue-format | অনুরোধ করা হলে ফরম্যাট-সাজেশন |
make-closed-issue | অনুমোদিত একটি ইস্যু, পরিধি-সীমিত কমিট ও PR তৈরি |
review-and-merge-pr | PR ফিডব্যাক বাছাই; কেবল অনুরোধ করা পরিধির মধ্যেই সংশোধন/প্রকাশ/মার্জ |
fix-merge-conflicts | কনফ্লিক্ট মেটানো এবং মার্জ হওয়া ফল যাচাই |
release | রিলিজের ভাষ্য প্রস্তুত করা এবং অনুমোদিত রিলিজ ধাপগুলো সম্পাদন |
code-quality-review | অ-তুচ্ছ ডিফ বা স্পষ্টভাবে অনুরোধ করা কোনো কোয়ালিটি-সংক্রান্ত উদ্বেগের রিভিউ |
retro | প্রমাণিত ভুলগুলোকে এমন লক্ষ্যভিত্তিক চেক বা নির্দেশনায় পরিণত করা, যা পুনরাবৃত্তি ঠেকায় |
refactor-pass, deslop | বিদ্যমান পরিবর্তনের অনুরোধকৃত পরিচ্ছন্নকরণ |
debug-agent | প্রমাণভিত্তিক ডিবাগিং, দরকার হলে ইনস্ট্রুমেন্টেশনসহ |
you-might-not-need-an-effect | লক্ষ্যভিত্তিক effect/memo রিভিউ |
vercel-react-best-practices | প্রযোজ্য React পারফরম্যান্স নির্দেশিকা; এই Vite ক্লায়েন্টের জন্য Next.js/কেবল-সার্ভারের নিয়ম বাদ দিন |
translate | অনুবাদ তৈরি, তারপর একটিমাত্র রাইটারের মাধ্যমে ম্যাপ প্রয়োগ |
playwright-cli, inspect-elements | ব্রাউজার যাচাই এবং DOM থেকে সোর্সে ম্যাপিং |
profile-browsing | পরিধি-সীমিত ব্রাউজার ও React প্রোফাইলিং |
test-apk | সরবরাহ করা সহযোগী Android র্যাপার যাচাই |
impeccable, improve-threejs | পরিধি-সীমিত ইন্টারফেস ডিজাইন ও Three.js রেন্ডারিং রিভিউ |
implement-plan | ঐচ্ছিক সীমিত ডেলিগেশনসহ একটি পরিকল্পনা বাস্তবায়ন |
readme | যাচাইকৃত প্রজেক্ট ডকুমেন্টেশন রক্ষণাবেক্ষণ |
context7 | সংস্করণ-উপযোগী লাইব্রেরি ডকুমেন্টেশন সংগ্রহ |
find-skills | স্পষ্টভাবে অনুরোধ করা হলে অতিরিক্ত স্কিল খুঁজে বের করা |
রোল ও মডেল
browser-check, profiler, test-apk, translator ও reviewer-এর জন্য কাস্টম রোলগুলো রেখে দিন। সাধারণ ইমপ্লিমেন্টেশন ও কোড খোঁজার কাজে হারনেসের বিল্ট-ইন worker/general-purpose বা explorer রোল ব্যবহার করুন। প্যারেন্ট গ্রহণযোগ্যতার মানদণ্ড ও মালিকানা নির্ধারণ করে দেয়; ভারী চেকগুলো চালায় একজনই মালিক।
Codex এজেন্ট ফাইলে name, description ও developer_instructions থাকে। .codex/config.toml max_concurrent_threads_per_session ব্যবহার করে একসঙ্গে চলা চাইল্ড এজেন্টের সংখ্যা চারে সীমিত রাখে। ভাগ করা রোল মেটাডেটায় থাকে নাম, বিবরণ ও ঐচ্ছিক স্যান্ডবক্স মোড; এতে ইচ্ছাকৃতভাবেই কোনো মডেল ফিল্ড নেই।
কমিট করা স্কিল ও কাস্টম এজেন্ট থেকে মডেল ও রিজনিং ফিল্ড বাদ রাখুন। এতে প্রতিটি অ্যাপের নথিভুক্ত অগ্রাধিকার-ক্রম অনুযায়ী রানটাইমে ইনভোকেশনের পছন্দ, ব্যবহারকারীর ডিফল্ট এবং প্যারেন্টের কাছ থেকে উত্তরাধিকার কার্যকর হতে পারে। Claude-এর ফ্যামিলি অ্যালিয়াস সংস্করণ রক্ষণাবেক্ষণের ঝামেলা কমায়, কিন্তু তবুও একটি ফ্যামিলি বেছে নেয়। দরকার হলে এ ধরনের পছন্দ ব্যবহারকারী/সেশন সেটিংসে রাখুন। উত্তরাধিকার মানেই সেরা বর্তমান মডেলটি স্বয়ংক্রিয়ভাবে বেছে নেওয়ার নিশ্চয়তা নয়। কোনো latest অ্যালিয়াস বানাবেন না, বা রুটিন টাস্কে মডেল-ক্যাটালগ নিয়ে গবেষণা যোগ করবেন না। দেখুন Codex-এ নির্বাচন এবং Claude-এ নির্বাচন।
sandbox-mode: read-only Codex-এর স্যান্ডবক্সে ম্যাপ হয়। Claude-এর টুল তালিকা ও রোলের নির্দেশনা এর রিভিউ ওয়ার্কফ্লোকে সীমিত রাখে, কিন্তু Bash অ্যাক্সেস OS-স্তরের কোনো স্যান্ডবক্স নয়।
ভাগ করা স্কিলের ফ্রন্টম্যাটার প্রযোজ্য ক্ষেত্রে ব্যবহারকারী-চালিত ওয়ার্কফ্লোর জন্য disable-model-invocation: true ব্যবহার করে। Codex-এর সংশ্লিষ্ট সেটিং থাকে agents/openai.yaml-এ policy.allow_implicit_invocation: false হিসেবে; ভ্যালিডেটর দুটোই আবশ্যক করে। ইনভোকেশন মেটাডেটা স্পষ্ট অনুমোদনের নিয়মগুলোর পরিপূরক মাত্র; কোনো স্কিলে প্রকাশের ধাপ আছে বলেই রিভিউয়ের অনুরোধ কখনও প্রকাশের অনুমতি দেয় না।
চেক ও ডিসকভারি
yarn ai-workflow:syncইনস্টল করাjs-yamlওsmol-tomlব্যবহার করে সামঞ্জস্য-আউটপুটগুলো পুনরায় তৈরি করে।yarn ai-workflow:checkসোর্স/ফ্রন্টম্যাটার/কনফিগ পার্স করে এবং জেনারেট হওয়া আউটপুট, ইনভোকেশন মেটাডেটা, মডেল ফিল্ডের অবস্থান ও কেবল-ফরম্যাটার হুক ওয়্যারিং পরীক্ষা করে। এটি কোনো প্রোভাইডার ক্যাটালগের সঙ্গে মিলিয়ে মডেল আইডেন্টিফায়ার যাচাই করে না।yarn ai-workflow:testহুক পেলোড এবং ওয়ার্কফ্লো জেনারেশন/ভ্যালিডেশনের জন্য বিচ্ছিন্ন Node ফিক্সচার চালায়।- কোনো এজেন্ট অ্যাপ্লিকেশন আপগ্রেড করার পরে সেই অ্যাপ্লিকেশনেই স্কিল/রোল ডিসকভারি যাচাই করুন। সিনট্যাক্স/সমতা চেক লোডার চেকের বিকল্প নয়। কোনো বিদ্যমান সেশন পুরোনো ক্যাটালগ ধরে রাখলে অ্যাপ্লিকেশনটি রিলোড করুন।
- হুকের জন্য হারনেসের প্রজেক্ট ট্রাস্ট ও হুক রিভিউ প্রয়োজন; কোনো চেক পাস করানোর জন্য ট্রাস্ট এড়িয়ে যাবেন না। দেখুন hooks-setup.md।
উপযোগী নির্দেশনা রক্ষণাবেক্ষণ
স্কিল ও প্রম্পট নিয়ে OpenAI-এর নির্দেশিকা অনুসরণ করুন (2026-09-12 তারিখে পর্যালোচিত): বিবরণ সুনির্দিষ্ট রাখুন, খুঁটিনাটি কেবল প্রাসঙ্গিক হলে তবেই লোড করুন, এবং ব্যবহারকারীর অনুরোধ করা পরিধি বজায় রাখুন। ভাগ করা স্কিল বিভিন্ন মডেলের কাজে লাগে; রুটিন ইমপ্লিমেন্টেশনের সিদ্ধান্তে স্বাধীনতা দিয়েও প্রজেক্ট-নির্দিষ্ট অপরিবর্তনীয় শর্তগুলো বজায় রাখুন।
কোনো স্কিলের উদ্দেশ্য, সিদ্ধান্তের সীমা ও অপরিহার্য বাধ্যবাধকতাগুলো SKILL.md-এ রাখুন। বড় আকারের মোড-নির্দিষ্ট কমান্ড বা উদাহরণ ঐচ্ছিক রেফারেন্স হিসেবে লিংক করুন। ছোট বিবরণে ট্রিগারের শর্তগুলো শুরুর দিকেই রাখুন; কেবল একটি কীওয়ার্ড মিলে গেলেই টাস্কের পরিধি বেড়ে যাওয়া উচিত নয়। বিদ্যমান ইনভোকেশন মেটাডেটা বজায় রাখুন, যদি না তার আচরণ ইচ্ছাকৃতভাবে বদলানো হচ্ছে।
নির্দেশনায় বড় কোনো পরিবর্তনের পরে কয়েকটি প্রতিনিধিত্বমূলক ছোট ও বড় অনুরোধ চালিয়ে দেখুন। পরীক্ষা করুন কোন স্কিল/রেফারেন্স বেছে নেওয়া হয়েছে, কাজগুলো পরিধির মধ্যে ছিল কি না, যাচাই পরিবর্তনের সঙ্গে মানানসই ছিল কি না, এবং অনুমোদিত কাজ সম্পন্ন হয়েছে কি না। স্কিমা ও ফিক্সচার টেস্ট টুলিংয়ের নির্ভুলতা প্রতিষ্ঠা করে, এজেন্টের সিদ্ধান্তের মান নয়।
টুল ও ব্রাউজারের মালিকানা
বিদ্যমান স্কিল/টুল ক্যাটালগ ও ইনস্টল করা প্রজেক্ট CLI-কে অগ্রাধিকার দিন। GitHub-এর জন্য gh, ব্রাউজার যাচাইয়ের জন্য playwright-cli, এবং লাইব্রেরির আচরণ গুরুত্বপূর্ণ হলে অফিশিয়াল/সংস্করণ-নির্দিষ্ট ডকুমেন্টেশন ব্যবহার করুন। কেবল একটি বিদ্যমান ফরম্যাটার চালানোর জন্য ডুপ্লিকেট স্কিল ইনস্টল করা বা পিন না করা কোনো প্যাকেজ নামিয়ে আনা এড়িয়ে চলুন।
MCP-এর বাড়তি বোঝা হারনেসের ওপর নির্ভর করে: ডিফার্ড টুল লোডিং শুরুতেই প্রতিটি স্কিমা লোড করা এড়াতে পারে। MCP-কে নিজেই অপ্রচলিত না ভেবে ইন্টিগ্রেশনগুলো প্রাসঙ্গিক রাখুন। পুনরুৎপাদনযোগ্যতা ও রিসোর্স নিয়ন্ত্রণের জন্য বিদ্যমান CLI পছন্দগুলো এখনও উপযোগী।
সব ব্রাউজার সেশন ./scripts/pw-session.sh ব্যবহার করে, যা গোটা মেশিনে একটিমাত্র সক্রিয় ব্রাউজার নিশ্চিত করে। ডিফল্ট হিসেবে নতুন একটি বিচ্ছিন্ন সেশন ব্যবহার করুন। বর্তমান ব্যক্তিগত ব্রাউজারে অ্যাক্সেসের জন্য স্পষ্ট অনুমোদন দরকার; পরবর্তী ধাপগুলোতে সেই অনুমোদনই পুনরায় ব্যবহার করুন। প্রভাবিত আচরণ অনুযায়ী ব্রাউজার/ভিউপোর্ট বেছে নিন, নির্বাচিত ইঞ্জিনগুলো একের পর এক চালান, ক্লিনআপে ঠিক সেই নামের সেশনটিই বন্ধ করুন, এবং কখনও close-all/kill-all ব্যবহার করবেন না। দেখুন playwright-cli স্কিল এবং verification.md।