نام (NAME)

gh-skill-publish - اعتبارسنجی و انتشار مهارت‌ها در یک مخزن گیت‌هاب (پیش‌نمایش)

خلاصه دستور (SYNOPSIS)

gh skill publish [<directory>] [flags]

توضیحات (DESCRIPTION)

اعتبارسنجی مهارت‌های یک مخزن محلی بر اساس مشخصات مهارت‌های ایجنت (Agent Skills specification) و انتشار آن‌ها با ایجاد یک انتشار (release) در گیت‌هاب.

مهارت‌ها با همان قواعد دستوری مشابه دستور install شناسایی می‌شوند:

• skills/*/SKILL.md
• skills/{scope}/*/SKILL.md
• */SKILL.md (در سطح ریشه)
• plugins/{scope}/skills/*/SKILL.md

بررسی‌های اعتبارسنجی شامل موارد زیر است:

• نام‌های مهارت‌ها با قوانین دقیق نام‌گذاری agentskills.io مطابقت داشته باشند
• نام هر مهارت با نام دایرکتوری آن همخوانی داشته باشد
• فیلدهای الزامی بخش فرانت‌متر (name و description) وجود داشته باشند
• فیلد allowed-tools یک رشته باشد و نه یک آرایه
• متادیتای نصب (metadata.github-*) در صورت وجود حذف شود

پس از موفقیت در اعتبارسنجی، فرآیند انتشار شما را به‌صورت تعاملی در مراحل زیر هدایت می‌کند:

• افزودن موضوع (topic) به نام agent-skills به مخزن
• انتخاب برچسب نسخه (توصیه می‌شود از نگارش معنادار یا semver استفاده شود)
• ایجاد یک ریلیز در گیت‌هاب همراه با یادداشت‌های انتشار به‌طور خودکار تولیدشده

از --dry-run برای اعتبارسنجی بدون انتشار استفاده کنید. از --tag برای انتشار غیرتعاملی با یک برچسب خاص استفاده نمایید. از --fix برای حذف خودکار متادیتای نصب از فایل‌های کامیت‌شده بدون انتشار استفاده کنید. تغییرات را بررسی و کامیت کرده، سپس دستور publish را دوباره اجرا فرمایید.

گزینه‌ها (OPTIONS)

--dry-run

اعتبارسنجی بدون انتشار

--fix

رفع خودکار مشکلات در صورت امکان بدون انتشار (مانند حذف متادیتای نصب)

--tag <string>

برچسب نسخه برای انتشار (مانند v1.0.0)

کدهای خروج (EXIT CODES)

0: اجرای موفقیت‌آمیز

1: خطا

2: دستور لغو شد

4: نیاز به احراز هویت است

نکته: دستورات خاص ممکن است کدهای خروج دیگری نیز داشته باشند. برای اطلاعات بیشتر به راهنمای همان دستور مراجعه فرمایید.

مثال‌ها (EXAMPLES)

# اعتبارسنجی و انتشار به صورت تعاملی
$ gh skill publish
# انتشار با یک برچسب مشخص (غیرتعاملی)
$ gh skill publish --tag v1.0.0
# فقط اعتبارسنجی (بدون انتشار)
$ gh skill publish --dry-run
# حذف متادیتای نصب بدون انتشار
$ gh skill publish --fix

همچنین ببینید (SEE ALSO)

gh-skill(1)