agentleFS
yhoshanyhoshan/thakaly-skills/skills/docx-highlight-extractor/SKILL.md

docx-highlight-extractor

Skill4 starsChanged 19 days agoMITView on GitHub

جمع المقاطع ذات التمييز اللوني الصريح من DOCX مع لونها وموضعها، لتجميع شواهد الباحث دون تغيير ألفاظها أو تنسيق الأصل.

The file

Files
SKILL.md

جمع المقاطع المظللة

جمع المقاطع ذات التمييز اللوني الصريح من DOCX مع لونها وموضعها، لتجميع شواهد الباحث دون تغيير ألفاظها أو تنسيق الأصل.

طريقة العمل

  1. استخدم ملف DOCX محفوظًا. ارفض DOC وDOCM وPDF؛ لا تشغّل ماكرو ولا تحوّل الأصل تلقائيًا.
  2. شغّل من مجلد المهارة: python scripts/inspect_docx.py input.docx --out report.csv.
  3. اقرأ warnings وlimitations قبل عرض عدد النتائج؛ الصفر لا يثبت خلو الأجزاء غير المدعومة.
  4. اعرض السجلات كما استخرجت. لا تصحح آية أو حديثًا أو اسمًا، ولا تزيل تشكيلًا أو تغيّر ترتيب حروف.
  5. احتفظ ببصمة المصدر الواردة في التقرير. لا تنسب للمخرجات أرقام صفحات فعلية.

المدخل والمخرج

المدخل DOCX بترميز OOXML القياسي الانتقالي. المخرج الافتراضي المقترح CSV جديد بترميز UTF-8 مع BOM. يقبل أيضًا امتداد JSON؛ ويحوي تقرير JSON items وcount وparts وsource_sha256 والتحذيرات. يرفض البرنامج الكتابة فوق أي ملف موجود أو الإخراج إلى الأصل. رمز الخروج 0 نجاح الاستخراج، و2 خطأ إدخال أو إخراج. النجاح لا يعني سلامة المستند علميًا.

المواضع محسوبة من صفر بوحدات Unicode في النص المستخرج لكل جزء XML؛ نهاية النطاق غير مشمولة. فاصل الفقرات سطر جديد، والتبويب محفوظ. ترقيم الفقرات من واحد داخل كل جزء ويشمل الجداول ومربعات النص. CSV يحوي صفًا لكل موضع، ونص التعليق ونص نطاقه في عمودين. إذا لم توجد نتائج يظهر صف no-items يوضح نطاق الفحص. تحمى الخلايا التي تبدأ بعلامة صيغة Excel بإضافة فاصلة عليا وتسجيل أسماء الأعمدة في escaped_fields؛ تبقى القيمة الحرفية الكاملة متاحة في JSON. لا يغيّر ذلك نص المستند.

حدود النسخة

تقرأ المتن والحواشي والتعليقات الختامية والترويسات والتذييلات القياسية. لا تقرأ النص المصور أو الكائنات المضمنة وaltChunk، ولا تنفذ حقول Word أو روابط خارجية. يظهر تحذير عند التغييرات المتعقبة؛ النص المحذوف مستبعد والمدرج مقروء دون قبول أي تغيير. تُرفض XML أكبر من 40 MiB ومجموع XML أكبر من 160 MiB. يدعم التمييز الصريح w:highlight فقط. تمييز الأنماط الموروث ولون الخط وتظليل الخلفية ليست مشمولة، ولا يفسر أي لون بوصفه حكمًا علميًا.

الاختبارات

python -m unittest discover -s tests -v تشمل حالات موجبة وسالبة، وسلامة بايتات الأصل، ونصًا عربيًا مشكولًا، ورفض الكتابة فوق الملفات. نتائج التنفيذ الموثقة في تقرير الحزمة؛ التوافق المثبت محليًا Python 3.12 على Windows، وليس اعتمادًا لكل منصات التشغيل.

النسبة والمقارنة

صاحب الوظيفة المرجعية الدكتور سعود العقيل. هذا تنفيذ مستقل من وصف الوظيفة باستخدام OOXML، بلا نقل شفرته أو بياناته. المرجع الأصلي Frm08NsosiFindHilted.frm::CMDColctHiliteNewDoc_Click، والتفصيل في references/origin.json. لم تظهر أداة تنفيذ بهذه الوظيفة المحددة ضمن 33 بطاقة مهارة في المستودع عند البصمة المذكورة. تتقاطع وظيفيًا مع تعليمات تحرير الكتب وحماية الإحالات؛ الأداة الحالية تنفيذ محدد للقراءة فقط يمكن استدعاؤه منها. لا تنشر الحزمة أو ترفعها إلى GitHub قبل مراجعة المستخدم واعتمادها.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.