Spec Kit گیت‌هاب: فرایند منظم برای ایجنت‌های کدنویسی
هوش مصنوعیخلاصهٔ کامل‌تر
Spec Kit یه جعبه‌ابزار متن‌باز با لایسنس MIT از گیت‌هابه که به ایجنت‌های کدنویسی هوش مصنوعی فرایند ساختاریافته، قالب‌های قابل استفادهٔ دوباره و خروجی مستند می‌ده. یعنی به‌جای اینکه فقط یه پرامپت به ایجنت بدی و امیدوار باشی، اون رو مرحله‌به‌مرحله از یه مسیر مشخص رد می‌کنی و هر مرحله یه سند قابل بررسی تولید می‌کنه.
مسیر اصلی Spec-Driven Development یا SDD هست، یعنی اول مشخص می‌کنی چی باید ساخته بشه و چرا، بعد این spec به plan، تسک و کد تبدیل میشه. یه بار برای پروژه یه constitution (اصول پایه مثل کیفیت کد و تست) می‌نویسی و بعد برای هر فیچر این دستورها رو تو چت ایجنت یکی‌یکی اجرا می‌کنی:
/speckit-constitution Create principles focused on code quality, testing, and maintainability.
/speckit-specify Build a photo organizer with albums grouped by date and a tile preview of each album.
/speckit-plan Use Vite with vanilla JavaScript. Keep images local and store metadata in SQLite.
/speckit-tasks
/speckit-implement
/speckit-convergeمرحلهٔ implement و converge اون‌قدر تکرار میشه تا converge گزارش Converged بده. توصیهٔ مستندات اینه که خروجی هر مرحله رو قبل از رفتن به مرحلهٔ بعد بررسی کنی.
دو مسیر دیگه به‌صورت extension جدا نصب می‌شن. رفع باگ علت رو بررسی می‌کنه، یه fix محدود می‌زنه و تأیید می‌کنه که مشکل اصلی برطرف شده؛ حکم نهایی verified، partial یا failed هست و فقط verified یعنی واقعاً درست شده. ارزیابی ایده بدون نیاز به کد، شواهد جمع می‌کنه و آخرش یکی از سه تصمیم go، needs-clarification یا kill رو می‌ده.
این سه مسیر فاز اجباری نیستن و هر کدوم جدا استفاده می‌شن. برای شخصی‌سازی هم کلی ابزار هست: preset برای تغییر قالب‌ها یا اعمال استانداردهای سازمانی، extension برای اضافه کردن دستور یا quality gate، workflow برای خودکار کردن دستورها، و bundle برای بسته‌بندی یه setup آماده برای یه نقش یا تیم. کاتالوگ‌های community هم هستن، ولی خود پروژه تأکید می‌کنه این‌ها بررسی امنیتی نشدن و قبل از نصب باید کدشون رو چک کرد.
برای شروع به Python 3.11 به بالا، ابزار uv و یه ایجنت کدنویسی پشتیبانی‌شده روی Linux، macOS یا Windows نیاز داری. نصب با uv tool install specify-cli انجام میشه و نسخهٔ 1.0 هم با امکانات گسترده‌تر منتشر شده.
نکات کلیدی:
- Spec Kit متن‌باز و با لایسنس MIT از طرف گیت‌هاب منتشر شده
- سه فرایند آماده داره: SDD در هسته، و رفع باگ و ارزیابی ایده به‌صورت extension
- نتیجهٔ رفع باگ یکی از verified، partial یا failed و نتیجهٔ ارزیابی ایده یکی از go، needs-clarification یا kill هست
- پیش‌نیازها: Python 3.11+، ابزار uv و یه ایجنت کدنویسی مثل GitHub Copilot
- کامپوننت‌های کاتالوگ community بررسی امنیتی نشدن و باید قبل از نصب کدشون رو دید
