المهارات port-allocator
📦

port-allocator

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

تخصيص منافذ التطوير المحلية

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

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

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

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

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

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

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

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

تفاصيل Markdown GET /skills/guo-yu-port-allocator.md manifest موقَّع GET /api/skills/guo-yu-port-allocator/manifest lockfile موقَّع GET /api/skills/guo-yu-port-allocator/lockfile

اختبرها

جارٍ استخدام "port-allocator". اعرض المنافذ المخصصة لهذا المشروع.

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

  • المجلد الحالي هو مشروع package.
  • النطاق المخصص: 3000-3009.
  • استخدم 3000 للتطبيق الرئيسي و3001 للواجهة API.

جارٍ استخدام "port-allocator". افحص مجلد الكود لدي بحثا عن مشاريع جديدة.

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

  • اكتمل الفحص لدليل الكود المهيأ.
  • احتفظت المشاريع الحالية بنطاقاتها الحالية.
  • حصلت مشاريع package الجديدة على النطاقات التالية المتاحة.

جارٍ استخدام "port-allocator". اعرض جميع تخصيصات المنافذ.

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

  • تظهر المشاريع المسجلة مع نطاقاتها المخصصة.
  • يتم الإبلاغ عن المجلدات المتخطاة عندما لا تحتوي على package.json.

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

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

Most static alerts are false positives caused by Markdown backticks, translated text, path references, and /dev/null. Confirmed risks include forceful process termination, persistent global instruction edits, and broad unattended access to ~/.claude files. The documented registry update also lacks concurrency control.

5
الملفات التي تم فحصها
722
الأسطر التي تم تحليلها
18
عناصر المراجعة
0
تم تجاهل الإيجابيات الكاذبة

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

مرتفع
SKILL.md:48-70
Overbroad unattended shell permissions
The allow workflow edits Claude Code settings to permit wildcard find, lsof, and cat commands without repeated confirmation. The cat pattern covers every direct child of ~/.claude, which exceeds port allocation needs.
The permission list and instruction to merge it into permissions.allow are explicit. The broad ~/.claude wildcard is directly visible in the documented configuration.
متوسط
SKILL.md:159-163
Non-atomic port allocation across concurrent sessions
The workflow checks the registry, chooses the next range, and then updates the file without a locking or atomic recheck step. Concurrent sessions can assign the same ports and later terminate each other's processes.
The documented read-check-allocate-write sequence is explicit, while no synchronization step is specified. This matters because the skill claims to coordinate multiple Claude Code instances.
عناصر مراجعة القدرات (18)

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

مرتفع
SKILL.ja.md:39
Hidden file in home directory
`~/.claude/CLAUDE.md` を更新する際は、**ユーザーの既存コンテンツを保持する必要があります**:
The instructions direct the agent to modify the user's global ~/.claude/CLAUDE.md. Persistent global instruction changes can affect unrelated future sessions and projects.
مرتفع
SKILL.ja.md:61
Hidden file in home directory
"Bash(cat ~/.claude/*)",
The permission entry authorizes cat across ~/.claude/*, exceeding the files required for port allocation. This broad read can expose unrelated configuration or secret-bearing files without confirmation.
مرتفع
SKILL.ja.md:39
Hidden file access
`~/.claude/CLAUDE.md` を更新する際は、**ユーザーの既存コンテンツを保持する必要があります**:
The instructions direct the agent to modify the user's global ~/.claude/CLAUDE.md. Persistent global instruction changes can affect unrelated future sessions and projects.
مرتفع
SKILL.ja.md:61
Hidden file access
"Bash(cat ~/.claude/*)",
The permission entry authorizes cat across ~/.claude/*, exceeding the files required for port allocation. This broad read can expose unrelated configuration or secret-bearing files without confirmation.
مرتفع
SKILL.md:39
Hidden file in home directory
When updating `~/.claude/CLAUDE.md`, **must preserve the user's existing content**:
The instructions direct the agent to modify the user's global ~/.claude/CLAUDE.md. Persistent global instruction changes can affect unrelated future sessions and projects.
مرتفع
SKILL.md:61
Hidden file in home directory
"Bash(cat ~/.claude/*)",
The permission entry authorizes cat across ~/.claude/*, exceeding the files required for port allocation. This broad read can expose unrelated configuration or secret-bearing files without confirmation.
مرتفع
SKILL.md:39
Hidden file access
When updating `~/.claude/CLAUDE.md`, **must preserve the user's existing content**:
The instructions direct the agent to modify the user's global ~/.claude/CLAUDE.md. Persistent global instruction changes can affect unrelated future sessions and projects.
مرتفع
SKILL.md:61
Hidden file access
"Bash(cat ~/.claude/*)",
The permission entry authorizes cat across ~/.claude/*, exceeding the files required for port allocation. This broad read can expose unrelated configuration or secret-bearing files without confirmation.
مرتفع
SKILL.zh-CN.md:39
Hidden file in home directory
更新 `~/.claude/CLAUDE.md` 时,**必须保留用户原有内容**:
The instructions direct the agent to modify the user's global ~/.claude/CLAUDE.md. Persistent global instruction changes can affect unrelated future sessions and projects.
مرتفع
SKILL.zh-CN.md:61
Hidden file in home directory
"Bash(cat ~/.claude/*)",
The permission entry authorizes cat across ~/.claude/*, exceeding the files required for port allocation. This broad read can expose unrelated configuration or secret-bearing files without confirmation.
مرتفع
SKILL.zh-CN.md:39
Hidden file access
更新 `~/.claude/CLAUDE.md` 时,**必须保留用户原有内容**:
The instructions direct the agent to modify the user's global ~/.claude/CLAUDE.md. Persistent global instruction changes can affect unrelated future sessions and projects.
مرتفع
SKILL.zh-CN.md:61
Hidden file access
"Bash(cat ~/.claude/*)",
The permission entry authorizes cat across ~/.claude/*, exceeding the files required for port allocation. This broad read can expose unrelated configuration or secret-bearing files without confirmation.
متوسط
SKILL.ja.md:29
xargs command (can execute arbitrary commands)
lsof -ti:3000 | xargs kill -9 2>/dev/null
The documented command sends PIDs from lsof for a fixed port to kill -9. It can forcibly terminate an unrelated process that happens to occupy the port.
متوسط
SKILL.ja.md:30
xargs command (can execute arbitrary commands)
lsof -ti:3001 | xargs kill -9 2>/dev/null
The documented command sends PIDs from lsof for a fixed port to kill -9. It can forcibly terminate an unrelated process that happens to occupy the port.
متوسط
SKILL.md:29
xargs command (can execute arbitrary commands)
lsof -ti:3000 | xargs kill -9 2>/dev/null
The documented command sends PIDs from lsof for a fixed port to kill -9. It can forcibly terminate an unrelated process that happens to occupy the port.
متوسط
SKILL.md:30
xargs command (can execute arbitrary commands)
lsof -ti:3001 | xargs kill -9 2>/dev/null
The documented command sends PIDs from lsof for a fixed port to kill -9. It can forcibly terminate an unrelated process that happens to occupy the port.
متوسط
SKILL.zh-CN.md:29
xargs command (can execute arbitrary commands)
lsof -ti:3000 | xargs kill -9 2>/dev/null
The documented command sends PIDs from lsof for a fixed port to kill -9. It can forcibly terminate an unrelated process that happens to occupy the port.
متوسط
SKILL.zh-CN.md:30
xargs command (can execute arbitrary commands)
lsof -ti:3001 | xargs kill -9 2>/dev/null
The documented command sends PIDs from lsof for a fixed port to kill -9. It can forcibly terminate an unrelated process that happens to occupy the port.

عوامل الخطر

⚙️ الأوامر الخارجية (50)
SKILL.ja.md:29 SKILL.ja.md:30 SKILL.ja.md:34 SKILL.md:8 SKILL.md:14 SKILL.md:15 SKILL.md:16 SKILL.md:17 SKILL.md:18 SKILL.md:19 SKILL.md:27-35 SKILL.md:35-39 SKILL.md:39-41 SKILL.md:41-44 SKILL.md:44-48 SKILL.md:48-52 SKILL.md:52-53 SKILL.md:53-55 SKILL.md:55-68 SKILL.md:68-74 SKILL.md:74-85 SKILL.md:85-87 SKILL.md:87-92 SKILL.md:92 SKILL.md:97 SKILL.md:99-110 SKILL.md:110-113 SKILL.md:113-122 SKILL.md:122-125 SKILL.md:125-133 SKILL.md:133-135 SKILL.md:135-139 SKILL.md:139 SKILL.md:141-142 SKILL.md:142-144 SKILL.md:144-153 SKILL.md:153-155 SKILL.md:155-156 SKILL.md:156-157 SKILL.md:157-165 SKILL.md:165-170 SKILL.md:170-172 SKILL.md:172-176 SKILL.md:176-183 SKILL.md:183-192 SKILL.md:192-195 SKILL.md:195-208 SKILL.md:208-215 SKILL.md:215-216 SKILL.md:216-217
📁 الوصول إلى نظام الملفات (50)
SKILL.ja.md:39 SKILL.ja.md:52 SKILL.ja.md:61 SKILL.ja.md:80 SKILL.ja.md:84 SKILL.ja.md:92 SKILL.ja.md:97 SKILL.ja.md:118 SKILL.ja.md:139 SKILL.ja.md:221 SKILL.ja.md:222 SKILL.ja.md:223 SKILL.ja.md:39 SKILL.ja.md:52 SKILL.ja.md:61 SKILL.ja.md:80 SKILL.ja.md:84 SKILL.ja.md:92 SKILL.ja.md:97 SKILL.ja.md:118 SKILL.ja.md:139 SKILL.ja.md:147 SKILL.ja.md:221 SKILL.ja.md:222 SKILL.ja.md:223 SKILL.ja.md:29 SKILL.ja.md:30 SKILL.md:39 SKILL.md:52 SKILL.md:61 SKILL.md:80 SKILL.md:84 SKILL.md:92 SKILL.md:97 SKILL.md:118 SKILL.md:139 SKILL.md:221 SKILL.md:222 SKILL.md:223 SKILL.md:39 SKILL.md:52 SKILL.md:61 SKILL.md:80 SKILL.md:84 SKILL.md:92 SKILL.md:97 SKILL.md:118 SKILL.md:139 SKILL.md:147 SKILL.md:221
دقّقه: codex عرض سجل التدقيق →
شارك واستشهد بهذا التقرير

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

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

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

https://skillstore.io/skills/guo-yu-port-allocator/audits/5?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

شارة Markdown

[![Skillstore security assessment](https://skillstore.io/badges/skills/guo-yu-port-allocator/security.svg)](https://skillstore.io/skills/guo-yu-port-allocator?utm_source=security_passport_badge)

شارة HTML

<a href="https://skillstore.io/skills/guo-yu-port-allocator?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/guo-yu-port-allocator/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

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

<iframe src="https://skillstore.io/embed/skills/guo-yu-port-allocator.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

guo-yu. (2026). port-allocator security audit report (audit version 5) [Author version unspecified]. Skillstore. https://skillstore.io/skills/guo-yu-port-allocator/audits/5

اقتباس BibTeX

@techreport{guo-yu-guo-yu-port-allocator-2026, author = {guo-yu}, title = {port-allocator security audit report (audit version 5)}, institution = {Skillstore}, year = {2026}, number = {5}, url = {https://skillstore.io/skills/guo-yu-port-allocator/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: "port-allocator security audit report (audit version 5)" version: "unspecified" type: report authors: - name: "guo-yu" date-released: "2026-08-05" url: "https://skillstore.io/skills/guo-yu-port-allocator/audits/5" identifiers: - type: other value: "skillstore:guo-yu-port-allocator:audit:5" description: "Skillstore immutable audit report identifier"

تقييم Skillstore

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

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

منع تعارض المنافذ المحلية

تخصيص نطاقات منافذ ثابتة عند تشغيل عدة مشاريع تطبيقات على محطة العمل نفسها.

تنسيق جلسات البرمجة بالذكاء الاصطناعي

منع جلسات Claude Code أو Codex من اختيار منفذ خادم التطوير نفسه.

تدقيق استخدام منافذ المشاريع

عرض المشاريع المسجلة ونطاقاتها المخصصة قبل بدء الخدمات المحلية.

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

فحص المشروع الحالي 
استخدم /port-allocator لعرض نطاق المنافذ للمشروع الحالي.
عرض المنافذ المسجلة 
استخدم /port-allocator list ولخص المشاريع المسجلة ونطاقات المنافذ.
فحص مجلد المشاريع 
استخدم /port-allocator scan للعثور على مشاريع package.json ضمن جذر الكود المهيأ لدي.
التهيئة بأمان 
استخدم /port-allocator config ~/Code بعد التأكد من وجود المجلد. اسأل قبل تغيير أذونات Claude.

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

  • راجع أي تغييرات في أذونات Claude قبل تطبيقها.
  • اضبط جذر الكود على أصغر مجلد يحتوي على مشاريعك النشطة.
  • تأكد من أن العملية تنتمي إلى المشروع الحالي قبل إنهائها.

تجنب

  • لا تمنح وصولا عاما باستخدام أحرف wildcard إلى ملفات Claude المخفية دون مراجعة.
  • لا تنه جميع عمليات Node لتحرير منفذ تطوير واحد.
  • لا تستبدل ملفات تعليمات Claude العامة أثناء الإعداد.

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

ماذا تدير هذه المهارة؟
يدير نطاقات منافذ التطوير المحلية للمشاريع التي تحتوي على package.json.
هل تبدأ خوادم التطوير؟
لا. إنها توثق تخصيص المنافذ وخطوات الإعداد المحلية ذات الصلة.
أين تخزن بيانات المنافذ؟
تستخدم التعليمات ملف سجل منافذ ضمن دليل تهيئة Claude.
هل يمكن أن تعمل مع مشاريع غير Node؟
فقط إذا كانت تلك المشاريع تتضمن أيضا package.json أو تم تكييف التعليمات.
لماذا يجب مراجعة الأذونات؟
تقترح المهارة أنماطا واسعة لأذونات Bash يمكنها قراءة ملفات Claude المخفية.
هل من الآمن إنهاء العمليات باستخدام هذه المهارة؟
توخ الحذر. تأكد من المنفذ ومالك العملية قبل إنهاء أي عملية محلية.

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

المؤلف

guo-yu

الترخيص

MIT

مراجعة Skillstore

r2

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

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

المستودع

https://github.com/guo-yu/skills/tree/master/port-allocator

مرجع

286d37c9c189ddd1aafd3548415fb031d1df79d5

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

٦‏/٨‏/٢٠٢٦

الاستخدام

5 تنزيلات · 149 مشاهدات

بنية الملفات

📁 .claude-plugin/

📄 plugin.json

📄 .gitignore

📄 SKILL.ja.md

📄 SKILL.md

📄 SKILL.zh-CN.md

المزيد من guo-yu

عرض الكل

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

عرض الكل