‏guard-skills: نگهبان‌هایی برای کدی که ایجنت می‌نویسه

پروژهٔ guard-skills یه بستهٔ متن‌باز از guard skillهاست برای ایجنت‌های کدنویس: دروازه‌های کیفیتِ پاس‌دوم که سراغ الگوهای شکست سیستماتیک کد، تست و مستندات تولیدشده با هوش مصنوعی می‌رن، قبل از این‌که این کارها به ریپازیتوری برسه.

تو توضیحات پروژه اومده که بهترین شیوهٔ استفاده اینه: اول بذار ایجنت کارش رو انجام بده، بعد گارد مربوطه رو روی diff اجرا کن — پیش از این‌که نتیجه رو ارائه، commit یا merge کنی. این skillها می‌تونن موقع نوشتن هم راهنما باشن، ولی نقطهٔ قوتشون همون پاس بازبینی واکنشیه.

فراخوانی‌شون هم ساده‌ست و همون سبک دستور طبیعی به ایجنته:

Use $clean-code-guard on the diff you just produced.
Use $test-guard on the tests you just wrote.
Use $wp-guard on this WordPress plugin change.

پنج گارد وجود داره. clean-code-guard اصول Clean Code و SOLID و DRY/KISS/YAGNI رو روی کد تغییرکرده اعمال می‌کنه، به‌علاوهٔ یه لایهٔ مخصوص هوش مصنوعی که بیشتر rule packها ازش غافلن: بلعیدن کلی خطاها، return موفقیت هاردکدشده، APIهای توهمی، انتزاع زودهنگام و کامنت‌زدگی. test-guard هم روی کد تست کار می‌کنه و سوءاستفاده از mock، تست‌های تکراری، assertionهای وابسته به جزئیات پیاده‌سازی و تست‌هایی که عملاً چیزی نمی‌گیرن رو علامت می‌زنه.

docs-guard مستندات — README، docstring، مرجع API و changelog — رو مثل فهرستی از ادعاها می‌بینه و هر ادعا رو با خود کدبیس راستی‌آزمایی می‌کنه تا سمبل توهمی و نمونهٔ خراب گیر بیفته. wp-guard لایهٔ وردپرسه: escaping و sanitization، nonce و بررسی capability، کوئری‌های prepared و انضباط کش. woo-guard هم روی wp-guard سواره و چیزهای مخصوص ووکامرس رو می‌گیره: دسترسی سازگار با HPOS، ترجیح CRUD بر متای مستقیم و اعتبارسنجی سمت سرور در checkout.

ساختار مخزن عمداً سبک نگه داشته شده: هر skill یه پوشه‌ست با یه SKILL.md به‌عنوان نقطهٔ ورود، متادیتای سبک برای ایجنت، و مراجعی که با progressive disclosure فقط وقتی لازم باشن بارگذاری می‌شن. به گفتهٔ نگهدارنده، SKILL.md کوچیک می‌مونه تا ارزون لود بشه و راهنمایی عمیق‌تر فقط وقتی بیاد که تسک بهش نیاز داره.

روی قابل‌اعتماد بودن هم تأکید شده: محتوای skillها فقط Markdown به‌علاوهٔ یه فایل متادیتای agents/openai.yaml هست، هیچ اسکریپت اجرایی، تماس شبکه‌ای، وابستگی به سرور MCP یا credential توش نیست، و آدرس منابع بیرونی تو references/sources.md هر skill قرار داره.

نویسنده تفاوت این پروژه با کارهای مشابه رو هم روشن می‌کنه: مخزن‌هایی مثل WordPress/agent-skills به ایجنت یاد می‌دن چطور تو اکوسیستم وردپرس بسازه، ولی guard-skills عمداً باریک‌تره و فقط دروازهٔ بازبینی بعد از تولید کار رو می‌ده. نصبش از طریق Skills CLI انجام می‌شه و با Claude Code، Codex، Cursor، OpenCode و بقیهٔ ایجنت‌های پشتیبانی‌شده کار می‌کنه. لایسنسش هم MIT‌ه.

نکات کلیدی:

• guard-skills پنج گارد بازبینی برای کد تولیدشده با هوش مصنوعی ارائه می‌ده
• الگوی پیشنهادی: اول ایجنت کار کنه، بعد گارد روی diff اجرا بشه
• clean-code-guard سراغ بلعیدن خطا، APIهای توهمی و انتزاع زودهنگام می‌ره
• test-guard تست‌های بی‌خاصیت و mockهای بیش‌ازحد رو می‌گیره؛ docs-guard مستندات رو با کد راستی‌آزمایی می‌کنه
• wp-guard و woo-guard لایه‌های وردپرس و ووکامرس (از جمله سازگاری HPOS) رو پوشش می‌دن
• بسته فقط Markdown و متادیتاست: بدون اسکریپت اجرایی، تماس شبکه‌ای یا credential
• سازگار با Claude Code، Codex، Cursor و OpenCode از طریق Skills CLI، با لایسنس MIT