スキル doc-sync-tool
📦

doc-sync-tool

コンテンツリビジョン r1 高リスク ⚙️ 外部コマンド📁 ファイルシステムへのアクセス

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

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

対応: Claude Codex Code(CC)
Maintain this Skill? Claim it ⚠️ 38 不十分

自分のエージェントでインストール

このリクエストをエージェントにコピーしてください。正規の Skill ページとマニフェストが含まれています。

エージェントリクエスト
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.

エージェントは引き続き計画を提示し、セキュリティポリシーで必要な確認を求める必要があります。

エージェントが読めるリソース

AI エージェント、クローラー、スクリプトがページ全体ではなく整理されたコンテキストを必要とする場合は、これらのリンクを使ってください。

テストする

「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 个文件

セキュリティ監査

高リスク

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)

高
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.
中
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)

これらは、このスキルに期待される可能性のある実際のローカル機能であるため、レビューが必要ですが、確認済みの悪意ある動作としてはカウントされません。

中
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.
中
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.
中
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.
中
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.
中
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.
中
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.
中
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.
中
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)
📁 ファイルシステムへのアクセス (31)
監査者: codex 監査履歴を表示 →
このレポートを共有・引用

バージョン付き評価レポート、中立的なバッジ、埋め込みカード、引用を共有できます。Skillstore は証拠を報告しますが、この Skill が安全かどうかは判断しません。

バージョン別レポートを開く
セキュリティ評価

レポートリンクをコピー

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

バージョンに関する注意

作者はバージョンを宣言していません。

参照

64ca8af0f54a325752f08bd54e52151061ea659a

メンテナンスの新しさ

2026/7/26

利用状況

11 ダウンロード · 244 閲覧

ファイル構成