إنشاء التذاكر وإدارتها
يبيّن هذا الدليل كيف تنشئ التذاكر وتديرها.
إنشاء تذكرة
قسم بعنوان “إنشاء تذكرة”من الواجهة
قسم بعنوان “من الواجهة”- انقر التذاكر في الشريط الجانبي لمساحة العمل.
- انقر تذكرة جديدة.
- املأ الحقول:
- العنوان — ملخص قصير. هو الحقل الوحيد المطلوب.
- الوصف — Markdown، مع شريط تنسيق.
- الحالة — للتنفيذ (الافتراضي) أو الأعمال المتراكمة. حالات ما بعد البدء والحالات النهائية تُضبط عبر دورة الحياة، لا عند الإنشاء.
- الأولوية — بلا، عاجلة، مرتفعة، متوسطة أو منخفضة.
- المُسنَد إليه — أنت، أو أي وكيل في مساحة العمل.
- المشروع — تجميع اختياري.
- انقر إنشاء، أو فعّل إنشاء المزيد أولًا ليبقى الحوار مفتوحًا للإدخال السريع.
الحوار بلا منتقي مزوّد. تُنشأ التذكرة على مزوّد التذاكر النشط في مساحة العمل.
من وكيل
قسم بعنوان “من وكيل”اطلب من وكيل في مساحة:
أنشئ تذكرة لإصلاح انتهاء مهلة تسجيل الدخول على الاتصالات البطيئة.
يستدعي أداة MCP create_ticket. الأولوية في هذه الأداة عدد صحيح، لا اسم:
create_ticket( workspace_id: "...", title: "Fix login timeout on slow connections", description: "...", priority: 2)| القيمة | الأولوية |
|---|---|
0 |
بلا |
1 |
عاجلة |
2 |
مرتفعة |
3 |
متوسطة |
4 |
منخفضة |
لا يلزم إلا workspace_id وtitle. أما description وpriority وassignee (معرّف وكيل) وteam_id فاختيارية. تُصنَّف الأداة كتابة مزامنة إلى المورّد، وتطلب موافقتك قبل أن تعمل.
تحديث حالة التذكرة
قسم بعنوان “تحديث حالة التذكرة”تتبع التذاكر دورة الحياة هذه:
backlog → open → inProgress ⇄ blocked ↓ ↑ inReview ↓ done / failed (terminal)done وfailed وcancelled نهائية. يُنتقَل إلى cancelled من أي حالة غير نهائية. يُنتقَل إلى done وfailed من inProgress أو inReview، ويمكن أن تنتقل open مباشرة إلى blocked. يعرض منتقي الحالة في الواجهة كل الحالات إلا failed، والوكلاء يضبطونها عبر fail_ticket.
لتغيير الحالة، استخدم أيًا مما يلي:
- صف الحالة في عمود خصائص التذكرة،
- القائمة الفرعية الحالة في قائمة النقر بزر الفأرة الأيمن على التذكرة في القائمة،
- شريحة الحالة في الشريط العائم بعد تحديد عدة تذاكر.
تغييرات الحالة تنشر أحداث نطاق (TicketStatusChanged وTicketCompleted وغيرهما) يمكن أن تشغّل خطوط الأنابيب. انظر
إعداد مشغّلات خط الأنابيب.
إسناد تذكرة
قسم بعنوان “إسناد تذكرة”- افتح التذكرة.
- في عمود الخصائص، اضبط المُسنَد إليه: أنت، أو عضو آخر في مساحة العمل، أو وكيل.
إضافة التسميات
قسم بعنوان “إضافة التسميات”تُطبَّق التسميات دفعة واحدة من قائمة التذاكر. عمود الخصائص بلا عنصر للتسميات.
- مرّر المؤشر على صف في قائمة التذاكر وعلّم مربع اختياره. علّم ما شئت من الصفوف، فيظهر شريط عائم فور تحديد أي تذكرة.
- في ذلك الشريط، افتح شريحة التسميات.
- اختر تسمية. تُضاف إلى كل تذكرة محددة تخلو منها، والتسميات الموجودة تبقى. مسح التسميات يزيلها كلها. يعرض المنتقي التسميات الموجودة أصلًا على تذكرة في مساحة العمل. ويستطيع الوكيل إضافة اسم جديد عبر
update_ticketأوtickets.patch.
ربط التذاكر
قسم بعنوان “ربط التذاكر”العلاقات في بطاقة العلاقات ضمن عمود الخصائص، أو خلف ربط مع في قائمة النقر بزر الفأرة الأيمن في القائمة.
- افتح التذكرة وابحث عن بطاقة العلاقات.
- انقر زر الإضافة فيها واختر العلاقة:
| العلاقة | المعنى |
|---|---|
| مشكلة فرعية من… | أصل هذه التذكرة هو التذكرة الأخرى |
| أصل لـ… | التذكرة الأخرى مشكلة فرعية لهذه |
| محظورة بواسطة… | هذه التذكرة محظورة بواسطة الأخرى |
| تحظر… | هذه التذكرة تحظر الأخرى |
| مرتبطة بـ… | متناظرة، بلا اتجاه |
| تكرار لـ… | هذه التذكرة نسخة مكررة من الأخرى |
- اختر التذكرة الهدف.
مكرَّرة بواسطة تظهر في البطاقة ولا تظهر في المنتقي. هي عكس تكرار لـ، وتُضبط من التذكرة الأخرى. كل علاقة معروضة تُفتح بالنقر على التذكرة المرتبطة، وتُزال عند تمرير المؤشر.
علاقات الأصل والمشكلة الفرعية تُخزَّن على التذكرة نفسها، لا صفوف روابط، فحذف الأصل يتتابع إلى أبنائه (انظر أدناه)، وروابط الحظر والارتباط لا تتتابع.
إضافة متعاونين
قسم بعنوان “إضافة متعاونين”المتعاونون كشف على التذكرة: من المعنيّ، وبأي صفة.
- افتح التذكرة.
- انقر زر الشخص مع علامة الزائد في بطاقة إضافة متعاون.
- اختر وكيلًا.
الأدوار الثلاثة هي assignee وcollaborator (الافتراضي) وreviewer. منتقي الواجهة لا يسرد إلا وكلاء مساحة العمل، ويكتب دائمًا الدور الافتراضي. قد يظهر البشر صفوفًا، لكن القائمة لا تعرضهم. أداة MCP add_ticket_collaborator تقبل role.
إضافة متعاون تكتب صفًا، ولا تنشر حدث نطاق، ولا تمنح وصولًا إلى المساحة. لإدخال وكيل في المحادثة، أضفه مشاركًا من ترويسة المساحة. انظر استخدام المساحات.
حذف تذكرة
قسم بعنوان “حذف تذكرة”استخدم حذف التذكرة أسفل عمود الخصائص، أو من قائمة النقر بزر الفأرة الأيمن، أو من إجراء الحذف في الشريط العائم بعد التحديد المتعدد.