এজেন্টের সিদ্ধান্তের জন্য Jev Skills কীভাবে ইনস্টল ও ব্যবহার করবেন

Jev Skills কী করে

Awesome Jev Skills হলো AI এজেন্টের ওয়ার্কফ্লোতে কাঠামোবদ্ধ সিদ্ধান্ত যুক্ত করার জন্য ইনস্টলযোগ্য নয়টি স্কিলের একটি সংগ্রহ। Jev প্রার্থীদের মধ্যে নির্বাচন করে, ইনপুট শ্রেণিবদ্ধ করে এবং নির্ধারিত মানদণ্ডের স্কোর দেয়। আপনার এজেন্টই প্রসঙ্গ সংগ্রহ, টুল কল করা, কাজ সম্পাদন এবং ফলাফল যাচাইয়ের দায়িত্বে থাকে।

রিপোজিটরিটিতে ৯০টি পরিস্থিতি এবং রেকর্ড করা ১৪টি ইনপুট-আউটপুট উদাহরণ রয়েছে। এর রেসিপিগুলো দীর্ঘ সময় চলা এজেন্ট, মূল্যায়ন, রাউটিং, প্রসঙ্গ ব্যবস্থাপনা, ব্রাউজার ইন্টারঅ্যাকশন, ইনবক্স বাছাই, নথির প্রমাণ, ডেভেলপার টুল, সিমুলেশন, গেম এবং সৃজনশীল ওয়ার্কফ্লো কাভার করে।

Jev নির্বাচন বা স্কোর দেয়। এটি বোতামে ক্লিক, বার্তা পাঠানো, ফাইল পরিবর্তন, মিডিয়া রেন্ডার বা নির্বাচিত কাজ সম্পাদন করে না।

প্রধান বৈশিষ্ট্য

• কাঠামোবদ্ধ সিদ্ধান্তের ধরন: একজন প্রার্থী নির্বাচন করতে choice, স্বাধীন সত্য-মিথ্যা সিদ্ধান্তের জন্য noul, এবং বিভিন্ন স্তরে স্কোর দেওয়ার জন্য score ব্যবহার করুন।
• বিশেষায়িত স্কিল: বাছাই, নথি, ইউজার ইন্টারফেস, রাউটিং, প্রসঙ্গ, কোড রিভিউ, কোড অনুসন্ধান এবং সিমুলেশনের জন্য স্কিল ইনস্টল করুন।
• এজেন্ট চেকপয়েন্ট: পুনরাবৃত্ত ব্যর্থতা শনাক্ত করতে, কাজ সম্পন্ন হওয়ার প্রমাণ মূল্যায়ন করতে, একটি রুট নির্বাচন করতে বা প্রস্তাবিত কাজটি লক্ষ্য এগিয়ে নিচ্ছে কি না যাচাই করতে Jev-কে বলুন।
• সমান্তরাল সিদ্ধান্ত: একই শেয়ার করা অবস্থার ওপর একাধিক স্বাধীন প্রশ্নকে একটি অনুরোধে রাখুন, অথবা হোস্ট এজেন্টকে সীমিত সমান্তরালতার মাধ্যমে স্বাধীন অনুরোধগুলো নির্ধারণ করতে দিন।
• অফলাইন যাচাই: নেটওয়ার্ক কল না করে বা শ্রেণিবিন্যাস তৈরি না করে একটি ইনপুট যাচাই করতে --dry-run ব্যবহার করুন।
• স্পষ্ট সিমুলেশন মোড: OpenRouter কী না থাকলে, আপনার বর্তমান এজেন্ট কেবল আপনার অনুমোদনের পর একই সিদ্ধান্ত অনুকরণ করতে পারবে।

একটি স্কিল নির্বাচন

• jev: কাস্টম সিদ্ধান্ত নির্ধারণ করুন বা সাধারণ এজেন্ট চেকপয়েন্ট যোগ করুন।
• jev-triage: বার্তা, টিকিট বা প্রতিক্রিয়া শ্রেণিবদ্ধ ও অগ্রাধিকার নির্ধারণ করুন।
• jev-documents: উৎসের অংশ নির্বাচন করুন এবং সহায়ক প্রমাণ মূল্যায়ন করুন।
• jev-ui: ইতিমধ্যে পর্যবেক্ষণ করা ব্রাউজার বা ডেস্কটপ কাজগুলোর মধ্যে নির্বাচন করুন।
• jev-route: একটি টুল, মডেল বা বিশেষজ্ঞের সুপারিশ করুন।
• jev-context: প্রাসঙ্গিকতা মূল্যায়ন করুন এবং কখন প্রসঙ্গ সংক্ষিপ্ত করা উপযুক্ত হতে পারে তা নির্ধারণ করুন।
• jev-code-review: রিভিউয়ের জন্য কোড পরিবর্তনগুলোর অগ্রাধিকার নির্ধারণ করুন।
• jev-find-code: পর্যবেক্ষণ করা ফাইল তালিকা থেকে পরবর্তী অবস্থান নির্বাচন করুন।
• jev-simulation: একটি সিমুলেটেড জগতে বৈধ কাজ নির্বাচন করুন।

ইনস্টলেশন

প্রস্তাবিত এজেন্ট-সহায়িত ইনস্টলেশন

প্রস্তাবিত পদ্ধতি হলো Codex, Claude Code বা OpenCode-কে ইনস্টলেশনের কাজ দেওয়া। আপনার এজেন্টে নিচের প্রম্পটটি পেস্ট করুন:

Install Jev Skills for my current agent, including the general skill and all scenario skills. Read and follow this installation guide, then verify the installation:
https://raw.githubusercontent.com/wuyoscar/jev-skill/main/docs/install.md

এজেন্ট আপনার পরিবেশ পরীক্ষা করে, ডিফল্টভাবে বর্তমান প্রজেক্টে ইনস্টল করে এবং অফলাইনে ইনস্টলেশন যাচাই করে। ডিফল্ট ইনস্টলেশন পদ্ধতিতে Node, npm বা Vercel অ্যাকাউন্টের প্রয়োজন হয় না। আপনার এজেন্ট যে অনুমোদনের অনুরোধ করবে, সেগুলো সম্পন্ন করুন।

ম্যানুয়াল ইনস্টলেশন বা সমস্যা সমাধানের জন্য ম্যানুয়াল ইনস্টলেশন গাইড দেখুন।

আসল Jev অ্যাক্সেস কনফিগার করুন

আসল Jev কলের জন্য একটি OPENROUTER_API_KEY প্রয়োজন। OpenRouter সেটিংস থেকে একটি তৈরি করে স্থানীয়ভাবে কনফিগার করুন। কখনোই কীটি চ্যাটে পেস্ট করবেন না। লাইভ কলে API ব্যবহার হয় এবং ব্যবহারের জন্য খরচ হতে পারে।

কোনো কী পাওয়া না গেলে, এজেন্টকে আপনাকে সতর্ক করে নিচের একটি বিকল্প বেছে নেওয়ার জন্য অপেক্ষা করতে হবে:

1. বিকল্প A: স্থানীয়ভাবে একটি কী সংগ্রহ ও কনফিগার করুন, তারপর আসল Jev ব্যবহার করুন।
2. বিকল্প B: একই প্রসঙ্গ, প্রার্থী এবং মানদণ্ড ব্যবহার করে বর্তমান এজেন্টকে শ্রেণিবিন্যাস অনুকরণ করতে দিন।

সিমুলেশনের ফলাফলে mode: agent_simulation এবং jev_called: false লেবেল থাকতে হবে। এগুলো Jev-এর প্রতিক্রিয়া বা ক্যালিব্রেট করা Jev সম্ভাবনা নয়, তাই এজেন্টকে সম্ভাবনার মান বানিয়ে বলা যাবে না।

সিমুলেশন মোড এবং ড্রাই-রান মোড আলাদা। সিমুলেশন বর্তমান এজেন্টের সিদ্ধান্ত তৈরি করে। ড্রাই রান কেবল অনুরোধের ফরম্যাট যাচাই করে এবং কোনো শ্রেণিবিন্যাস সম্পাদন করে না।

মৌলিক ব্যবহার

ইনস্টল করা বাছাইয়ের উদাহরণ চেষ্টা করুন

ইনস্টলেশনের পর আপনার এজেন্টকে jev-triage-এর সঙ্গে থাকা উদাহরণটি ব্যবহার করতে বলুন। এই অনুশীলনে ইনপুট প্রদর্শিত হয়, সম্পাদনের মোড নিশ্চিত করা হয় এবং এজেন্টকে মেইলবক্সে কোনো কাজ করা থেকে বিরত রাখা হয়।

Use the jev-triage skill and read assets/example.json from its installed folder. Show its context, questions and candidates. If OPENROUTER_API_KEY is missing, ask me to choose A: configure a key for real Jev; or B: let the current agent simulate. Wait for my choice. In API mode, validate with --dry-run, then make one Jev call. In simulation mode, label the result "Agent simulation; Jev not called" and do not invent probabilities. Show the complete input, output and mode. Do not access my mailbox or execute actions.

এজেন্ট নতুন ইনস্টল করা স্কিল খুঁজে না পেলে, তাকে ইনস্টলেশন ডিরেক্টরি পরীক্ষা করতে এবং আপনার ক্লায়েন্টের প্রয়োজন হলে সেশন পুনরায় লোড করতে বলুন।

অনুরোধের কাঠামো বুঝুন

একটি Jev অনুরোধে একটি মডেল, শেয়ার করা অবস্থা এবং এক বা একাধিক প্রশ্ন থাকে। প্রতিটি প্রশ্নে তার ধরন, নির্দেশনা এবং প্রযোজ্য ক্ষেত্রে সম্ভাব্য মানদণ্ড নির্ধারিত থাকে। নিচের সংক্ষিপ্ত উদাহরণে একই পার্সার ত্রুটি বারবার ঘটার পর একজন এজেন্টের কী করা উচিত তা জানতে চাওয়া হয়েছে:

{
  "model": "typesafe/jev-1.13",
  "state": {
    "goal": "CSV পার্সার ঠিক করুন এবং কাজ শেষ ঘোষণা করার আগে পরীক্ষাগুলো যাচাই করুন।",
    "recent_result": "একই UnicodeDecodeError দুইবার; সোর্সে কোনো পরিবর্তন নেই।",
    "observation": "পার্সার স্পষ্ট encoding ছাড়াই ফাইল খোলে।"
  },
  "questions": {
    "next_step": {
      "type": "choice",
      "instructions": "প্রমাণের ভিত্তিতে পরবর্তী কার্যকর পদক্ষেপ বেছে নিন।",
      "criteria": {
        "inspect_input": "ইনপুট এবং ফাইল খোলার কোড পরীক্ষা করুন।",
        "retry_unchanged": "শুধু কোনো সাময়িক অবস্থা পরিবর্তিত হলে পুনরায় চেষ্টা করুন।",
        "report_done": "পরীক্ষা পাস করলেই কেবল কাজ শেষ হয়েছে বলে জানান।",
        "ask_user": "গুরুত্বপূর্ণ অনুমোদন বা তথ্য অনুপস্থিত হলে জিজ্ঞাসা করুন।"
      }
    },
    "stuck": {
      "type": "noul",
      "instructions": "অপরিবর্তিত প্রচেষ্টাগুলো কি একই ত্রুটি বারবার ঘটিয়েছে?"
    }
  }
}

রিপোজিটরিতে রেকর্ড করা কৃত্রিম API উদাহরণে Jev inspect_input নির্বাচন করে stuck = true ফেরত দিয়েছিল। এটি সরবরাহ করা প্রমাণের ভিত্তিতে নেওয়া সিদ্ধান্ত, মেরামত কার্যকর করার ফল নয়।

ঐচ্ছিক কমান্ড লাইন ব্যবহার করুন

jev-decide ইনস্টল করা থাকলে সম্পূর্ণ অনুরোধটি request.json হিসেবে সংরক্ষণ করুন। প্রথমে অফলাইনে এটি যাচাই করুন:

jev-decide decide request.json --dry-run

OpenRouter-এ পাঠানো হবে এমন তথ্য পর্যালোচনা ও অনুমোদনের পর একটি লাইভ অনুরোধ করুন এবং ফলাফল সংরক্ষণ করুন:

jev-decide decide request.json > result.json

শুধু সাধারণ স্কিল ইনস্টল করা থাকলে এবং কমান্ডটি অনুপলব্ধ হলে, এর Python স্ক্রিপ্ট ব্যবহার করুন:

python3 <actual-skill-directory>/scripts/jev.py decide request.json --dry-run

সবসময় result.json পরীক্ষা করুন। এক্সিট কোড 0 মানে কোনো ফলাফল নির্বাচন বা স্কোর করা হয়েছে, 2 মানে পর্যালোচনা প্রয়োজন, এবং 1 মানে একটি ত্রুটি ঘটেছে। সফল নির্বাচন হলেও নির্বাচিত কাজটি নিজে থেকে কার্যকর হয় না।

ব্যবহারিক কর্মপ্রবাহ: সিদ্ধান্তের চেকপয়েন্ট যোগ করুন

প্রতিটি তুচ্ছ এজেন্ট ধাপের জন্য নয়, বরং গুরুত্বপূর্ণ সিদ্ধান্তের জন্য Jev তৈরি করা হয়েছে। ত্রুটি বারবার ঘটলে, কোনো পথ নির্বাচন করতে হলে, অথবা এজেন্ট কাজ শেষ করার দাবি করতে যাওয়ার সময় একটি চেকপয়েন্ট যোগ করুন।

CSV পার্সিং ঠিক করা এবং মূল পরীক্ষাগুলো পাস করানোর সময় সিদ্ধান্তে সহায়তার জন্য jev স্কিল ব্যবহার করুন। কীটি অনুপস্থিত হলে, আসল Jev বা বর্তমান-এজেন্ট সিমুলেশনের মধ্যে বেছে নিতে আমাকে বলুন। ত্রুটি বারবার ঘটলে, কোনো পথ বেছে নিতে হলে, অথবা কাজ শেষ করার দাবি করতে যাওয়ার সময় নির্বাচিত মোড ব্যবহার করুন। লক্ষ্য, গ্রহণযোগ্যতার যাচাই, প্রাসঙ্গিক ইতিহাস, নতুন টুলের ফলাফল, অনুমতি এবং প্রতিটি সম্ভাব্য কাজের অর্থ সরবরাহ করুন। বিদ্যমান অনুমোদনের সীমার মধ্যেই কাজ করুন এবং পরে ফলাফল যাচাই করুন।

কাজ সম্পন্ন হওয়ার চেকপয়েন্টে প্রকৃত প্রমাণ থাকা উচিত, যেমন আর্টিফ্যাক্ট শনাক্তকারী, পরীক্ষার রসিদ, রিভিশন হ্যাশ, ফাইলসিস্টেম যাচাই এবং জবের অবস্থা। সরবরাহ করা প্রমাণ কোনো দাবিকে সমর্থন করে কি না Jev তা বিচার করতে পারে, কিন্তু কোনো পরীক্ষা সত্যিই চলেছে বা কোনো ফাইল আছে কি না তা প্রত্যয়িত করতে পারে না। এসব তথ্য অবশ্যই টুল থেকে আসতে হবে।

নিরাপদভাবে রেকর্ড শ্রেণিবদ্ধ করুন

ফিডব্যাক, সাপোর্ট টিকিট বা অন্য কোনো রেকর্ডের ক্ষেত্রে প্রথমে ছোট একটি ছদ্মনামকৃত নমুনা দিয়ে শুরু করুন। বড় ব্যাচ প্রক্রিয়াকরণের আগে বিভাগ, প্রশ্ন এবং বাইরে পাঠানো হবে এমন তথ্য নিয়ে একমত হন।

1. তিনটি প্রতিনিধিত্বমূলক রেকর্ড নির্বাচন করুন।
2. প্রতিটি রেকর্ডের শনাক্তকারী, মূল লেখা এবং প্রাসঙ্গিক প্রেক্ষাপট সংরক্ষণ করুন।
3. billing, bug, how-to এবং other-এর মতো বিভাগ নির্ধারণ করুন।
4. আপনার মেশিনের বাইরে ঠিক কী পাঠানো হবে তা পর্যালোচনা করুন।
5. আসল API মোড বা স্পষ্টভাবে অনুমোদিত সিমুলেশন মোড নির্বাচন করুন।
6. অনিশ্চিত ফলাফলগুলো মানবিক পর্যালোচনার জন্য আলাদা রাখুন।
7. ব্যাচের আকার বা বাজেট বাড়ানোর আগে নমুনাটি পরীক্ষা করুন।

একটি অনুরোধে প্রতিটি রেকর্ড সম্পর্কে একাধিক প্রশ্ন করতে পারেন, যেমন বিভাগ এবং জরুরিতা। স্বাধীন অনুরোধের ক্ষেত্রে হোস্ট এজেন্ট সীমিত সমান্তরালতা ব্যবহার করতে পারে; CLI নিজে থেকে সমান্তরাল জব শুরু করে না।

উন্নত পরামর্শ

সম্পূর্ণ প্রেক্ষাপট দিন

Jev স্বয়ংক্রিয়ভাবে আপনার এজেন্টের কথোপকথন উত্তরাধিকার সূত্রে পায় না। লক্ষ্য, নিয়ম, প্রাসঙ্গিক ইতিহাস, উৎসের প্রমাণ, বর্তমান পর্যবেক্ষণ, অনুমতি, সম্ভাব্য মানগুলোর অর্থ এবং গ্রহণযোগ্যতার যাচাই অন্তর্ভুক্ত করুন। সিদ্ধান্তের প্রশ্নটি সংক্ষিপ্ত রাখুন, তবে এর প্রমাণ কৃত্রিমভাবে সীমিত করবেন না।

সম্পর্কিত সব ক্ষেত্র হালনাগাদ করুন

কোনো টেমপ্লেট মানিয়ে নেওয়ার সময় state, questions এবং criteria একসঙ্গে হালনাগাদ করুন। শুধু উদাহরণের লেখা পরিবর্তন করলে সম্ভাব্য মানগুলোর সংজ্ঞা প্রকৃত কাজের সঙ্গে অসঙ্গত হয়ে যেতে পারে।

সিদ্ধান্ত ও অনুমোদন আলাদা রাখুন

উচ্চ স্কোর পাওয়া কোনো কাজ স্বয়ংক্রিয়ভাবে অনুমোদিত নয়। বিদ্যমান অনুমতি ও নিরাপত্তা নিয়ন্ত্রণই কার্যকর করার নিয়ম নির্ধারণ করে। একইভাবে, কোনো পরিকল্পনা ও প্রস্তাবিত টুল কলের মধ্যে মিল থাকলেই কোনোটিই অনুমোদিত—এমন প্রমাণ হয় না।

নির্ভরশীল ধাপের জন্য নতুন অবস্থা ব্যবহার করুন

স্বাধীন বিচারগুলো একটি অবস্থা ভাগ করে নিতে পারে বা একসঙ্গে চলতে পারে। নির্ভরশীল সিদ্ধান্তে আগের কাজের পর নতুন পর্যবেক্ষণ ব্যবহার করা উচিত। Jev মুক্ত-পরিসরের পরিকল্পনা, টুল কার্যকর করা বা লেখা তৈরি করার বিকল্প নয়।

মানগুলো সঠিকভাবে ব্যাখ্যা করুন

noul প্রশ্নে probability বিবৃতিটি সত্য হওয়ার সম্ভাবনা নির্দেশ করে, নির্বাচিত মানটি মিথ্যা হলেও। 1.29 / 2-এর মতো রুব্রিক স্কোর একটি নির্ধারিত স্কোর, সম্ভাবনা নয়।

প্রমাণ ও মোড সংরক্ষণ করুন

সম্পূর্ণ ইনপুট, স্বাভাবিকীকৃত আউটপুট, উপলভ্য থাকলে কাঁচা রসিদ এবং এক্সিকিউশন মোড সংরক্ষণ করুন। নির্বাচিত উত্তরের সঙ্গে মিলিয়ে পুনর্লিখন না করে পরস্পরবিরোধী প্রমাণ সংরক্ষণ করুন। এজেন্ট সিমুলেশনকে কখনো বাস্তব API প্রতিক্রিয়া হিসেবে উপস্থাপন করবেন না।

হোস্ট টুলের সঙ্গে Jev সমন্বয় করুন

ব্রাউজারে ক্লিক, বার্তা পাঠানো, ফাইল সম্পাদনা, সংগীত তৈরি এবং ভিডিও রেন্ডার করার জন্য আলাদা টুল প্রয়োজন। Jev প্রার্থীদের র‍্যাঙ্ক করতে বা পর্যবেক্ষিত বৈধ কার্যগুলোর মধ্য থেকে বেছে নিতে পারে, আর হোস্ট অ্যাপ্লিকেশন নির্বাচিত অপারেশনটি সম্পাদন ও যাচাই করে।

উপসংহার

এজেন্ট ওয়ার্কফ্লোতে সুস্পষ্ট পছন্দ, শ্রেণিবিন্যাস, স্কোর এবং প্রমাণ যাচাই যোগ করার জন্য Jev Skills পুনর্ব্যবহারযোগ্য প্যাটার্ন সরবরাহ করে। এজেন্ট-সহায়িত ইনস্টলেশন দিয়ে শুরু করুন, সরবরাহ করা একটি উদাহরণ পরীক্ষা করুন, --dry-run দিয়ে অনুরোধ যাচাই করুন এবং স্কেল করার আগে একটি ছোট নমুনা পর্যালোচনা করুন। সম্পূর্ণ প্রসঙ্গ, স্পষ্টভাবে সংজ্ঞায়িত প্রার্থী, নির্দিষ্ট এক্সিকিউশন মোড এবং প্রতিটি গুরুত্বপূর্ণ কাজের পর স্বাধীন যাচাই থাকলেই সর্বোত্তম ফলাফল পাওয়া যায়।