agent-scripts: یه منبع واحد برای قوانین و skill های agent
هوش مصنوعیخلاصهٔ کامل‌تر
agent-scripts یه repo روی GitHub هست که Peter Steinberger (steipete) به عنوان منبع اصلی تنظیمات agent های خودش ازش استفاده می‌کنه. توش چهار چیز هست: فایل AGENTS.MD با قوانین سفت‌وسخت مشترک برای agent هایی مثل Codex و Claude، پوشه‌ی skills/ با skill های قابل استفاده‌ی دوباره، پوشه‌ی scripts/ با اسکریپت‌های کمکی کم‌وابستگی، و hooks/ برای چک‌های محلی مثل اعتبارسنجی skill ها.
skill ها لایه‌ی اصلی مسیریابی هستن، یعنی agent از روی توضیح هر skill تصمیم می‌گیره کی ازش استفاده کنه. هر SKILL.md یه front matter YAML با name و description داره. قانون repo اینه که توضیح‌ها کوتاه و کلی باشن، چون هدف مسیریابیه نه مستندسازی، و بدنه‌ی skill هم کوتاه و کاربردی بمونه. بعد از هر تغییر هم باید scripts/validate-skills اجرا بشه.
اسکریپت scripts/sync-skills این‌ها رو روی هر Mac قابل دسترس می‌کنه. Codex پوشه‌های تودرتو رو می‌گرده، پس یه لینک به کل پوشه کافیه. ولی به گفته‌ی README، Claude Code فقط skill هایی رو می‌خونه که دقیقاً یه سطح زیر ~/.claude/skills/ باشن (روی نسخه‌ی 2.1.197 تست شده). برای همین اسکریپت برای هر skill یه لینک جدا می‌سازه. این اسکریپت idempotent هست، یعنی چندبار اجرا کردنش همون نتیجه رو می‌ده، لینک‌های خراب رو پاک می‌کنه و به فایل‌های واقعی دست نمی‌زنه.
برای قوانین هم همین روش استفاده میشه. چون Claude Code فقط CLAUDE.md رو می‌خونه، اسکریپت ~/.claude/CLAUDE.md رو با لینک به همون AGENTS.MD مشترک وصل می‌کنه. repo های دیگه هم به جای کپی کردن قوانین، یه AGENTS.MD کوتاه دارن که فقط به فایل اصلی اشاره می‌کنه و قوانین مخصوص خود اون پروژه زیرش میاد. یعنی وقتی یه قانون عوض میشه، دیگه لازم نیست توی ده تا پروژه دستی آپدیتش کنی.
کنار این‌ها چند ابزار کمکی هم هست: docs-list.ts که پوشه‌ی docs/ رو می‌گرده و front matter های summary و read_when رو اجباری می‌کنه، و browser-tools.ts که یه ابزار مستقل بر پایه‌ی Chrome DevTools برای ناوبری، اسکرین‌شات و خوندن محتوای صفحه‌ست.
نکات کلیدی:
- AGENTS.MD منبع واحد قوانین Codex و Claude Code هست و با symlink وصل میشه
- Claude Code فقط skill های یه سطح زیر ~/.claude/skills/ رو پیدا می‌کنه
- sync-skills در تداخل نام‌ها اولویت رو به agent-scripts، بعد manager و بعد skill های محلی Codex می‌ده
- validate-skills وجود name و description رو توی هر SKILL.md چک می‌کنه
- skill های پروژه‌های دیگه مثل peekaboo و discrawl با symlink نسبی به این repo اضافه شدن
