أدوات الملاحظات والتعليقات

في سطر واحد: كيف تقرأ أداة AI خارجية ملاحظاتك وتكتب فيها، وكيف تشارك في دورة التعليقات — تترك تعليقًا، وتغلقه، وتعيد فتحه.

ما الذي يحلّه هذا

الملفات ليست الكتاب كله. إلى جانبها طبقتان أخريان: الملاحظات التي يكتبها المؤلف لنفسه، والتعليقات التي يتبادلها المحرّر والمؤلف.

الطبقتان مهمّتان جدًا لأي AI يتسلّم مخطوطة ليست له. التعليقات تحتوي غالبًا على ما سبق أن قاله أحدهم عن الخلل؛ وتجاهلها ثم إخراج قائمة مستقلة هو الطريق الأقصر إلى الجدال في قرار حُسم الأسبوع الماضي. أما الملاحظات فهي تفكير المؤلف وهو يجري: قراءتها هي الفرق بين «هذا التمهيد لم يُستثمر قط» و«هذا التمهيد محجوز للجزء الثاني عن عمد».

الملاحظات

list_notes(book_token)                              → كل ملاحظات هذا الكتاب
create_note(book_token, title, content, note_type…) → اترك ملاحظة

ما يقبله create_note:

الوسيط	الشرح
title	مطلوب. سطر واحد قصير.
content	اختياري، حتى 50,000 حرف
note_type	book (العمل ككل) أو chapter (مرتبطة بملف واحد). القيمة الافتراضية book.
file_id	مطلوب حين يكون note_type هو chapter — وهو رمز الملف. احصل عليه من get_book_structure أولًا.
color	أحد الألوان الستة: gray / red / blue / green / yellow / purple

الملاحظات تعيش بجوار المخطوطة لا داخلها. كتابة واحدة منها لا تمسّ حرفًا من النص ولا تضيف شيئًا إلى عدد الكلمات.

لا توجد أداة لحذف ملاحظة عبر MCP. الملاحظات خارج نظام الإصدارات، فبخلاف الملف لا يوجد سجلّ تستعيدها منه. وإذا أراد المؤلف حذف ملاحظة، حذفها من التطبيق.

ربط التمهيد بثمرته يتمّ في التطبيق. سجلّ الملاحظة يستطيع أن يربط الملاحظة التي ذُكر فيها الدرج المقفل أول مرة بالملاحظة التي فُتح فيها، لكن create_note لا يعرض هذين الحقلين. فحين يقرأ الـ AI اثني عشر فصلًا ويلاحظ تفصيلًا مزروعًا لم يُحصد أبدًا، ما يستطيعه هو أن يكتب ملاحظة تقول ذلك ويترك الربط للمؤلف. هكذا لا يضيع الاكتشاف بانتهاء المحادثة على الأقل.

التعليقات

list_comments(book_token)                        → كل السلاسل، المفتوحة والمغلقة
create_comment(book_token, content, file_token?) → اترك تعليقًا
resolve_comment(book_token, comment_token)       → علِّم السلسلة بأنها عولجت
reopen_comment(book_token, comment_token)        → أعِد فتح سلسلة أُغلقت بلا وجه حق

في الكتاب نوعان: التعليقات المجرّدة، والاقتراحات التي تحمل نصًا بديلًا. وما ينشئه MCP هو النوع الأول.

يأتي comment_token من list_comments وشكله bcmt_…. مرِّر file_token لتعليق السلسلة على ملف بعينه، واتركه فارغًا لتكون على الكتاب ككل.

قل ما فعلته قبل أن تغلق. السلسلة التي تُغلق في صمت لا تقول لصاحبها شيئًا؛ لا يعرف أنفّذتَ التعديل أم رأيتَ ملاحظته في غير محلّها.

الإغلاق يحتاج صلاحية تحرير على الكتاب. المتعاون بصلاحية القراءة فقط يقرأ السلاسل ويضيف إليها، لكنه لا يغلق سلسلة فتحها غيره.

ثلاثة أمور لا يتيحها MCP عن قصد

غير متاح	لماذا
حذف ملاحظة	الملاحظات خارج نظام الإصدارات، فالحذف بلا سجلّ يُستعاد منه
قبول اقتراح أو رفضه	القبول يعدّل المخطوطة، وذلك قرار المؤلف
تعديل تعليق شخص آخر أو حذفه	تلك كلماته هو

متى تعلّق ومتى تعدّل مباشرة

سؤال واحد يحسم الأمر: هل هذا حكم مني، أم شيء طلبه المؤلف؟

اكتشاف واحد، مخرجان

الإيقاع يترهّل، دافعٌ لا يقنع، مشهد لم يستحقّ طوله اترك تعليقًا

المؤلف قال: «اضبط هذا المقطع» عدّل الملف

عند التردّد، علِّق. إغلاق تعليق يكلّف عشر ثوانٍ، أما إعادة كتابة لم يطلبها أحد فتكلّف المؤلف قراءة فروق نصّه هو.

ذات صلة

• Docs: أدوات الملفات
• Docs: البحث الدلالي مقابل البحث النصي
• Docs: الأدلة ومهارات الكتابة
• Docs: التعليقات المضمَّنة