Claude Code භාවිතා කරන ඔබට, මාසයක් තුළ ඔබේ ~/.claude/agents/ ෆෝල්ඩරයේ සබ්-ඇජන්ට් කීයක් ඇමතුම් ලැබුනාද? බොහොමයක් දැනගන්න බෑ. මේ සතියේ මම ලියා තබාගත් ස්ක්රිප්ට් එකෙන් පරීක්ෂා කළාම, 30 දින තුළ 44 ක්වත් භාවිතා නොවූ ඇජන්ට් හමු වුණා.
මෙම ලිපිය Claude Code පරිසරයේ “ඇජන්ට් ලොග්” නවීකරණයක් ගැනයි. ඉතා සරලව, සබ්-ඇජන්ට් එකක් නිර්මාණය කරනවාට .claude/agents/*.md ෆයිල් එකට ෆ්රන්ට් මැටර් එකක් එක් කරනවා පමණයි. ඒක ඉතා පහසු වීම නිසා, “දැන් හදලා බලමු” කියලා බොහෝ ඇජන්ට් එකතු වෙලා, භාවිතා නොවන “Zombie” ඇජන්ට් ගොඩක් වෙලා ඉඳීමේ ගැටළුවක් ඇතිවෙයි.
මෙම ගැටළුව විසඳීමට, මම Stop hook එකක් (stop_agent_tracker.sh) භාවිතා කර, සැසිය අවසන් වූ විට transcript.jsonl ගොනුවෙන් Agent tool ඇමතුම් එකතු කර JSONL ගොනුවකට ලියන ක්රමයක් හදලා. එම ස්ක්රිප්ට් එක Python භාෂාවෙන් දෙවරක් transcript එක විශ්ලේෂණය කර, tool_use හා tool_result වගුවලින් අවශ්ය තොරතුරු ගනී. ඒත් එක් එක් සැසියට එකම session_id + tool_use_id යුගලයක් පමණක් ලියන බැවින්, එකම ඇමතුම දෙවරක් ලියන අවස්ථාවක් නොමැත.
ලියා ඇති JSONL ලේඛනයේ එක් රෙකෝඩ් එකේ උදාහරණයක්:
- {"ts": "2026-05-28T16:27:41.766Z", "session_id": "TEST-AGENT-TRACKER-001", "cwd": "~", "tool_use_id": "toolu_014MM...", "subagent_type": "general-purpose", "description": "launchd + cron සමීක්ෂණය", "duration_ms": 177, "status": "ok", "caller": {"type": "direct"}}
දිනපතා 10:15 ට launchd හරහා agent-usage-summary.sh ක්රමය ධාවනය කර, 7 දින සහ 30 දින කාල පරාස වල Top 10 සහ භාවිතා නොකළ ඇජන්ට් ලැයිස්තුව ගොනුවකට (agent-usage-latest.md) සකස් කරයි. මේ ස්ක්රිප්ට් එක Python3 පමණක් භාවිතා කර, බාහිර පුස්තකාලයකින් තොරව, JSONL ගොනුව පූරණය කර, subagent_type අනුව ගණන ගනී.
ශ්රී ලංකාවට ඇති වැදගත්කම
ශ්රී ලාංකීය සංවර්ධකයින්ට, මෙම ස්වයංක්රිය ලොග් පද්ධතියේ ප්රධාන ලාභය වන්නේ, අඩු භාවිතා ඇජන්ට් පෙන්වා, ඒවා ඉවත් කර, Claude Code පරිසරය සුලභව, වේගවත් කර ගැනීමයි. ශිෂ්යයන්ට, කුඩා පරික්ෂණයක් හෝ පුරෝගාමී AI වැඩසටහන් නිර්මාණය කරන විට, අවශ්ය ඇජන්ට් පමණක් තබා, “Zombie” ගොඩක් නොවීමට හැකියාව ලැබේ.
ව්යාපාරික පාර්ශවයෙන්, වැඩි ධාරිතාවයක් ඇති සේවා පරිසරයක් පවත්වා ගැනීමට, අධික ඇජන්ට් ගබඩා කිරීමේ පිරිවැය අඩු වේ. එමඟින් CI/CD පයිප්ලයින් එකක් හෝ cloud‑based සේවාවක් තුළ, ඉක්මන් ධාවනය හා අඩු මතක භාවිතය ලබාගත හැක.
අවසන් වශයෙන්, මෙම පද්ධතිය සරල Bash සහ Python කේතයක් මත පදනම්ව, ඕනෑම Claude Code පරිශීලකයකුට ක්රියාත්මක කළ හැකි නිසා, දේශීය තාක්ෂණික ප්රජාවට නව පියවරක් ගත හැක.
ඔබේ Claude Code පරිසරය තවත් පිරිසිදු කර, වැඩි නිෂ්පාදනශීලීත්වයක් ලබාගන්න, අදම මෙම ලොග් ක්රමය උත්සාහ කර බලන්න!
