المهارات doc-sync-tool
📦

doc-sync-tool

مراجعة المحتوى r1 مخاطر عالية ⚙️ الأوامر الخارجية📁 الوصول إلى نظام الملفات

مزامنة وثائق وكيل AI تلقائياً

الحفاظ على ملفات تكوين متطابقة لعدة وكلاء AI أمر ممل وعرضة للأخطاء. تقوم هذه الأداة تلقائياً بمزامنة ملفات AGENTS.md وCLAUDE.md وGEMINI.md عبر مشروعك بالكامل مع مراقبة الملفات في الوقت الفعلي أو التفعيل اليدوي.

يدعم: Claude Codex Code(CC)
⚠️ 38 ضعيف

التثبيت باستخدام Agent لدي

انسخ هذا الطلب إلى Agent لديك. يتضمن صفحة Skill المعتمدة وملف manifest.

طلب الوكيل
Review the Skillstore skill "doc-sync-tool" from https://skillstore.io/skills/zhanlincui-doc-sync-tool.md and its manifest at https://skillstore.io/api/skills/zhanlincui-doc-sync-tool/manifest. Verify the artifact. Stop and obtain explicit user consent before installing or changing files.

يجب أن يواصل Agent عرض خطته وطلب أي تأكيد تفرضه سياسة الأمان.

موارد مهيّأة لـ Agents

استخدم هذه الروابط عندما يحتاج AI Agent أو crawler أو script إلى سياق نظيف بدلًا من قراءة الصفحة كاملة.

تفاصيل Markdown GET /skills/zhanlincui-doc-sync-tool.md manifest موقَّع GET /api/skills/zhanlincui-doc-sync-tool/manifest lockfile موقَّع GET /api/skills/zhanlincui-doc-sync-tool/lockfile

اختبرها

جارٍ استخدام "doc-sync-tool". Run manual sync on a project with one existing CLAUDE.md file

النتيجة المتوقعة:

  • 🚀 开始扫描文档...
  • 📂 扫描路径：/path/to/project
  • 📋 目标文件：AGENTS.md, CLAUDE.md, GEMINI.md
  • ✓ 找到 1 个目录包含目标文件
  • 📁 处理目录：/path/to/project
  • 📄 源文件：CLAUDE.md (2025-11-27 10:30:45)
  • ✨ 创建：AGENTS.md
  • ✨ 创建：GEMINI.md
  • 🎉 成功同步 2 个文件
  • ✅ 同步完成！处理目录：1 个，更新文件：2 个，耗时：0.23s

جارٍ استخدام "doc-sync-tool". File watcher detects a change to CLAUDE.md

النتيجة المتوقعة:

  • [10:35:20] 📝 检测到文件变化：/path/to/CLAUDE.md
  • 📁 处理目录：/path/to
  • 📄 源文件：CLAUDE.md
  • ✅ 更新：AGENTS.md
  • 🎉 成功同步 1 个文件

التدقيق الأمني

مخاطر عالية
v5 • ٨‏/٧‏/٢٠٢٦ فتح التقرير المرتبط بالإصدار

Most static alerts are false positives from Markdown examples, JavaScript template literals, ANSI color codes, and hardcoded helper commands. Confirmed risks involve local file writes, watch-triggered synchronization, predictable test temporary paths, and unreviewed propagation of AI agent instruction files. No prompt injection attempt, network access, or credential exfiltration was found in the reviewed files.

13
الملفات التي تم فحصها
1,747
الأسطر التي تم تحليلها
8
عناصر المراجعة
0
تم تجاهل الإيجابيات الكاذبة

مخاوف أمنية مؤكدة (2)

مرتفع
sync.js:71-101watch.js:74-88
Unreviewed Agent Instruction Overwrite
The sync logic selects the newest AGENTS.md, CLAUDE.md, or GEMINI.md file and writes its content to companion files without a diff, backup, or confirmation. This can propagate malicious or mistaken agent instructions across tools.
The code explicitly sorts by modification time and writes source content into other agent files. Watch mode automatically triggers the same sync path after file changes.
متوسط
sync.js:9-10sync.js:28-41run-sync.sh:7-13
Broad Recursive Project Modification Scope
The tool scans from the current working directory or a wrapper-selected target directory, then recursively processes matching files. Running it from a broad parent directory can modify many projects unexpectedly.
CONFIG.scanPath is process.cwd(), scanDirectory recurses through child directories, and run-sync.sh changes into a caller-provided target before running sync.js.
عناصر مراجعة القدرات (8)

هذه قدرات محلية حقيقية قد يُتوقع وجودها لهذه المهارة، لذا فهي تتطلب مراجعة ولكن لا تُحتسب كسلوك خبيث مؤكد.

متوسط
rename-quick.js:24
Node.js fs operations
fs.renameSync(file, newPath);
fs.renameSync renames every discovered Agents.md file under the current tree and can overwrite AGENTS.md without a prompt. This is an intended helper, but it creates real data-integrity risk.
متوسط
rename-quick.js:43
Node.js fs operations
fs.renameSync(file, newPath);
fs.renameSync renames every discovered Gemini.md file under the current tree and can overwrite GEMINI.md without a prompt. This is an intended helper, but it creates real data-integrity risk.
متوسط
sync.js:93
Node.js fs operations
fs.writeFileSync(targetFilePath, content, 'utf8');
writeFileSync overwrites an existing target agent file when content differs from the selected newest source. There is no diff, backup, or confirmation gate.
متوسط
sync.js:101
Node.js fs operations
fs.writeFileSync(targetFilePath, content, 'utf8');
writeFileSync creates missing agent instruction files from the selected source content. This modifies the repository automatically and can propagate unwanted instructions.
متوسط
sync.js:93
Synchronous file operations
fs.writeFileSync(targetFilePath, content, 'utf8');
The synchronous write overwrites an existing target agent file without review. The risk is the write behavior, not the synchronous API choice.
متوسط
sync.js:101
Synchronous file operations
fs.writeFileSync(targetFilePath, content, 'utf8');
The synchronous write creates target agent files automatically without approval. This can spread incorrect or malicious instruction content.
متوسط
test.sh:9
Temp directory access
TEST_DIR="/tmp/doc-sync-test-$(date +%s)"
The test script uses a predictable /tmp path based on the current timestamp and later removes it recursively. This is test-only, but predictable temp paths are unsafe on shared systems.
متوسط
watch.js:63
File system watching
const watcher = fs.watch(dir, { recursive: true }, (eventType, filename) => {
fs.watch monitors the project tree and triggers synchronization on matching file changes. Persistent automatic sync increases the chance of unreviewed overwrites.

عوامل الخطر

⚙️ الأوامر الخارجية (69)
EXAMPLES.md:23-24 EXAMPLES.md:24-27 EXAMPLES.md:27-28 EXAMPLES.md:28-34 EXAMPLES.md:392-394 EXAMPLES.md:254 README.md:230 rename-quick.js:5 rename-quick.js:14 rename-quick.js:33 rename-quick.js:25 rename-quick.js:44 rename-quick.js:51 rename-to-uppercase.sh:14 rename-to-uppercase.sh:22 rename-to-uppercase.sh:1 run-sync.sh:6 run-sync.sh:7 run-sync.sh:1 run-watch.sh:6 run-watch.sh:7 run-watch.sh:1 SKILL.md:10 SKILL.md:29-32 SKILL.md:32-36 SKILL.md:36-42 SKILL.md:42-46 SKILL.md:46-52 SKILL.md:52-56 SKILL.md:56-65 SKILL.md:65-69 SKILL.md:69 SKILL.md:78-80 SKILL.md:80-86 SKILL.md:86-90 SKILL.md:90 SKILL.md:98-100 SKILL.md:100-106 SKILL.md:106-109 sync.js:25 sync.js:60 sync.js:69 sync.js:75 sync.js:94 sync.js:97 sync.js:102 sync.js:108 sync.js:110 sync.js:115 sync.js:123 sync.js:124 sync.js:136 sync.js:147 sync.js:148 sync.js:149 sync.js:150 test.sh:8 test.sh:9 test.sh:76 test.sh:78 test.sh:1 watch.js:21 watch.js:50 watch.js:78 watch.js:90 watch.js:101 watch.js:111 watch.js:112 watch.js:113
📁 الوصول إلى نظام الملفات (31)
EXAMPLES.md:121 EXAMPLES.md:122 EXAMPLES.md:154 QUICKSTART.md:82 QUICKSTART.md:83 QUICKSTART.md:84 QUICKSTART.md:85 rename-quick.js:24 rename-quick.js:43 rename-quick.js:7 rename-quick.js:14 rename-quick.js:33 rename-to-uppercase.sh:18 rename-to-uppercase.sh:26 sync.js:31 sync.js:79 sync.js:90 sync.js:93 sync.js:101 sync.js:53 sync.js:79 sync.js:90 sync.js:93 sync.js:101 test.sh:26 test.sh:36 test.sh:48 test.sh:64 test.sh:77 test.sh:9 watch.js:63
دقّقه: codex عرض سجل التدقيق →
شارك واستشهد بهذا التقرير

شارك تقرير التقييم المرتبط بالإصدار والشارة المحايدة وبطاقة التضمين والاستشهادات. تعرض Skillstore الأدلة من دون أن تقرر ما إذا كانت هذه المهارة آمنة.

فتح التقرير المرتبط بالإصدار
تقييم الأمان

نسخ رابط التقرير

https://skillstore.io/skills/zhanlincui-doc-sync-tool/audits/5?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

شارة Markdown

[![Skillstore security assessment](https://skillstore.io/badges/skills/zhanlincui-doc-sync-tool/security.svg)](https://skillstore.io/skills/zhanlincui-doc-sync-tool?utm_source=security_passport_badge)

شارة HTML

<a href="https://skillstore.io/skills/zhanlincui-doc-sync-tool?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/zhanlincui-doc-sync-tool/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

بطاقة قابلة للتضمين

<iframe src="https://skillstore.io/embed/skills/zhanlincui-doc-sync-tool.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>
الاستشهادات الأكاديمية (APA · BibTeX · CFF)

اقتباس APA

ZhanlinCui. (2026). doc-sync-tool security audit report (audit version 5) [Author version unspecified]. Skillstore. https://skillstore.io/skills/zhanlincui-doc-sync-tool/audits/5

اقتباس BibTeX

@techreport{zhanlincui-zhanlincui-doc-sync-tool-2026, author = {ZhanlinCui}, title = {doc-sync-tool security audit report (audit version 5)}, institution = {Skillstore}, year = {2026}, number = {5}, url = {https://skillstore.io/skills/zhanlincui-doc-sync-tool/audits/5}, note = {Author version unspecified} }

CITATION.cff

cff-version: 1.2.0 message: "If you use this Skill, cite its author and this versioned security audit report." title: "doc-sync-tool security audit report (audit version 5)" version: "unspecified" type: report authors: - name: "ZhanlinCui" date-released: "2026-07-08" url: "https://skillstore.io/skills/zhanlincui-doc-sync-tool/audits/5" identifiers: - type: other value: "skillstore:zhanlincui-doc-sync-tool:audit:5" description: "Skillstore immutable audit report identifier"

تقييم Skillstore

سبب هذا التقييم موثوقية الأدلة: متوسط
55
الهندسة المعمارية
85
قابلية الصيانة
87
المحتوى
71
المجتمع
83
الامتثال للمواصفات

ما الذي يمكنك بناؤه

إعداد مشروع جديد

عند بدء مشروع جديد، أنشئ ملف تكوين وكيل واحد فقط (مثل CLAUDE.md) ودع الأداة تنشئ AGENTS.md وGEMINI.md بمحتوى متطابق.

مزامنة الوثائق المستمرة

قم بتشغيل الأداة في وضع المراقبة أثناء التطوير لنشر أي تغييرات في تكوين الوكيل لجميع ملفات الوكلاء الأخرى في الوقت الفعلي.

المزامنة bulk

قم بتنفيذ المزامنة اليدوية عبر مجلدات مشروع متعددة في وقت واحد لضمان اتساق جميع وثائق الوكيل بعد التحديثات الرئيسية.

جرّب هذه الموجّهات

الإعداد الأساسي 
إعداد المزامنة التلقائية للوثائق لمشروعي. لدي ملف CLAUDE.md وأحتاج إلى إنشاء ملفات AGENTS.md وGEMINI.md المطابقة.
تنفيذ المزامنة اليدوية 
قم بتشغيل doc-sync-tool لمزامنة جميع ملفات وثائق الوكيل في مجلد المشروع الحالي وأخبرني哪些 الملفات تم تحديثها.
المراقبة في الخلفية 
بدء مراقبة الملفات في وضع الخلفية باستخدام PM2 بحيث تبقى وثائقي متزامنة تلقائياً. أخبرني كيفية التحقق من تشغيلها.
تخصيص التكوين 
ساعدني في تعديل تكوين doc-sync-tool لاستبعاد مجلدات إضافية وتغيير أسماء الملفات الهدف لتتوافق مع اتفاقيات مشروعي.

أفضل الممارسات

  • قم بتشغيل الأداة في وضع المراقبة أثناء التطوير النشط للحفاظ على مزامنة جميع وثائق الوكلاء في الوقت الفعلي
  • استخدم PM2 لبيئات الإنتاج لضمان بقاء مراقبة الملفات بعد إعادة تشغيل النظام
  • ارفع جميع ملفات الوثائق الثلاثة إلى التحكم بالإصدارات للحصول على نسخة احتياطية كاملة وتتبع السجل

تجنب

  • لا تقم بتحرير ملفات الوكلاء المتعددة يدوياً في وقت واحد - دع أداة المزامنة تتعاملPropagation
  • تجنب تشغيل مثيلات مزامنة متعددة على نفس المجلد لمنع شروط السباق
  • لا تستبعد المجلدات التي تحتوي فعلياً على وثائق الوكيل التي تريد مزامنتها

الأسئلة المتكررة

ما هي الملفات التي تقوم هذه الأداة بمزامنتها؟
تقوم الأداة بمزامنة ثلاثة ملفات: AGENTS.md (أو Agents.md) وCLAUDE.md (أو claude.md) وGEMINI.md (أو gemini.md). تتطابق الملفات بشكل غير حساس لحالة الأحرف داخل نفس المجلد.
كيف تقرر الأداة أي ملف هو المصدر؟
تستخدم الأداة وقت التعديل (mtime) لتحديد الملف المصدر. يصبح الملف المعدل حديثاً هو المصدر، ويتم نسخ محتواه إلى الملفات الأخرى.
هل يمكنني تخصيص الملفات التي تتم مزامنتها؟
نعم. قم بتحرير مصفوفة targetFiles في sync.js لتغيير أسماء الملفات التي تتم مزامنتها. الافتراضي هو ['AGENTS.md', 'CLAUDE.md', 'GEMINI.md'].
هل يستهلك وضع المراقبة موارد نظام كثيرة؟
لا. يستخدم وضع المراقبة fs.watch الأصلي من Node.js مع مراقبة تكرارية. يستهلك أقل من 50 ميجابايت من الذاكرة ووحدة معالجة المركزية شبه صفرية عندما تكون في وضع الخمول.
كيف أوقف مراقبة الملفات؟
اضغط Ctrl+C في الطرفية للإيقاف. إذا كان يعمل عبر PM2، استخدم 'pm2 stop doc-sync' أو 'pm2 delete doc-sync' لإيقاف وإزالة الخدمة.
ماذا يحدث إذا تم تعديل ملفين في نفس الوقت؟
تتضمن الأداة تأخيراً للتعامل مع التغييرات السريعة. ستستخدم أي ملف لديه أحدث طابع زمني للتعديل بعد انتهاء فترة التأخير.

تفاصيل المطور

المؤلف

ZhanlinCui

الترخيص

MIT

مراجعة Skillstore

r1

تنبيه الإصدار

لم يعلن المؤلف عن إصدار.

المستودع

https://github.com/ZhanlinCui/Ultimate-Agent-Skills-Collection/tree/main/doc-sync-tool

مرجع

64ca8af0f54a325752f08bd54e52151061ea659a

حداثة الصيانة

٢٦‏/٧‏/٢٠٢٦

الاستخدام

11 تنزيلات · 244 مشاهدات

بنية الملفات

📄 EXAMPLES.md

📄 INDEX.md

📄 package.json

📄 QUICKSTART.md

📄 README.md

📄 rename-quick.js

📄 rename-to-uppercase.sh

📄 run-sync.sh

📄 run-watch.sh

📄 SKILL.md

📄 sync.js

📄 test.sh

📄 watch.js

المزيد من ZhanlinCui

عرض الكل
📦

frontend-design

79

إنشاء واجهات أمامية متميزة

يواجه المستخدمون صعوبة في كود الواجهات الأمامية الذي تولده الذكاء الاصطناعي بشكل عام والذي يفتقر إلى الطابع البصري. تقدم هذه المهارة إرشادات حول التفكير التصميمي والمبادئ الجمالية لإنشاء واجهات احترافية ذات هويات بصرية متميزة ولا تُنسى.

التصميم والإبداع عرض

مهارات ذات صلة

عرض الكل