GH-PROJECT-ITEM-EDIT(1)        GitHub CLI manual       GH-PROJECT-ITEM-EDIT(1)



نام (NAME)
       gh-project-item-edit - ویرایش یک آیتم در یک پروژه



خلاصه دستور (SYNOPSIS)
       gh project item-edit [<number>] [flags]



توضیحات (DESCRIPTION)
       ویرایش یک پیش‌نویس ایشو (draft issue) یا یک آیتم پروژه.


       روش معمول برای انتخاب آیتم و فیلد بر اساس نام است: ارسال شماره پروژه
       number به‌همراه --owner، اشاره به آیتم با نشانی --url ایشو یا پول
       ریکوئست مربوطه، و مشخص کردن نام فیلد با --field.  برای فیلدهای
       تک‌انتخابی (single-select)، --value نام گزینه مورد نظر است.


       برای اسکریپت‌ها و استفاده ماشینی، می‌توانید شناسه‌های نود (node IDs) در
       GraphQL را نیز مستقیماً با گزینه‌های --id، --field-id و --project-id (و
       برای فیلدهای تک‌انتخابی با --single-select-option-id) ارسال کنید.


       توجه داشته باشید که --url نشانی اینترنتی ایشو یا پول ریکوئست است، نه
       نشانی پروژه؛ بنابراین ممکن است مالک آن با مالک پروژه متفاوت باشد؛ گزینه
       --owner پروژه را انتخاب می‌کند.


       برای ایشوهای غیر پیش‌نویس، در هر بار فراخوانی تنها مقدار یک فیلد قابل
       به‌روزرسانی است.


       حذف مقدار یک فیلد از آیتم پروژه با گزینه --clear.



گزینه‌ها (OPTIONS)
       --body <string>
              متن بدنه آیتم پیش‌نویس ایشو


       --clear
              حذف مقدار فیلد


       --date <string>
              مقدار تاریخ برای فیلد (YYYY-MM-DD)


       --field <string>
              نام فیلد برای به‌روزرسانی


       --field-id <string>
              شناسه (ID) فیلد برای به‌روزرسانی


       --format <string>
              قالب خروجی: {json}


       --id <string>
              شناسه (ID) آیتم برای ویرایش


       --iteration-id <string>
              شناسه مقدار تکرار (iteration) برای تنظیم روی فیلد


       -q, --jq <expression>
              فیلتر کردن خروجی JSON با استفاده از عبارت jq


       --number <float> (پیش‌فرض 0)
              مقدار عددی برای فیلد


       --owner <string>
              نام کاربری مالک. از "@me" برای کاربر جاری استفاده کنید.


       --project-id <string>
              شناسه پروژه‌ای که فیلد متعلق به آن است


       --single-select-option-id <string>
              شناسه گزینه تک‌انتخابی برای تنظیم روی فیلد


       -t, --template <string>
              قالب‌بندی خروجی JSON با استفاده از الگوی Go؛ به "gh help
              formatting" مراجعه کنید


       --text <string>
              مقدار متنی برای فیلد


       --title <string>
              عنوان آیتم پیش‌نویس ایشو


       --url <string>
              نشانی اینترنتی (URL) ایشو یا پول ریکوئستی که آیتم پروژه آن باید
              ویرایش شود


       --value <--field>
              مقداری که باید روی فیلد مشخص‌شده با --field تنظیم شود



کدهای خروج (EXIT CODES)
       0: اجرای موفقیت‌آمیز


       1: خطا


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


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


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



مثال‌ها (EXAMPLES)
       # تنظیم فیلد "Status" به "In Progress" برای یک ایشو در پروژه 1 متعلق به monalisa
       $ gh project item-edit 1 --owner monalisa --url https://github.com/monalisa/myproject/issues/23 --field "Status" --value "In Progress"

       # ویرایش مقدار فیلد متنی یک آیتم با شناسه نود (استفاده ماشینی / اسکریپتی)
       $ gh project item-edit --id <item-id> --field-id <field-id> --project-id <project-id> --text "new text"

       # پاک کردن مقدار فیلد یک آیتم با شناسه نود
       $ gh project item-edit --id <item-id> --field-id <field-id> --project-id <project-id> --clear




همچنین ببینید (SEE ALSO)
       gh-project(1)

                                   Sep 2026            GH-PROJECT-ITEM-EDIT(1)