スキル port-allocator
📦

port-allocator

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

ローカル開発ポートを割り当てる

複数のAIコーディングセッションが開発サーバーを起動すると、ローカルプロジェクト間で競合が発生する可能性があります。このスキルは予測可能なポート範囲を割り当て、再利用できるように記録します。

対応: Claude Codex Code(CC)
⚠️ 38 不十分

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

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

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

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

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

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

テストする

「port-allocator」を使用しています。 このプロジェクトに割り当てられたポートを表示してください。

期待される結果:

  • 現在のフォルダーは package プロジェクトです。
  • 割り当て範囲: 3000-3009。
  • メインアプリには 3000、API には 3001 を使用してください。

「port-allocator」を使用しています。 新しいプロジェクトを探すためにコードフォルダーをスキャンしてください。

期待される結果:

  • 設定済みのコードディレクトリのスキャンが完了しました。
  • 既存のプロジェクトは現在の範囲を維持しました。
  • 新しい package プロジェクトには次に利用可能な範囲が割り当てられました。

「port-allocator」を使用しています。 すべてのポート割り当てを一覧表示してください。

期待される結果:

  • 登録済みプロジェクトが、割り当てられた範囲とともに表示されます。
  • package.json を含まないフォルダーはスキップされたものとして報告されます。

セキュリティ監査

高リスク

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)

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

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

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

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

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

レポートリンクをコピー

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
仕様準拠

作成できるもの

ローカルポートの競合を防止する

複数のアプリプロジェクトが同じワークステーションで実行される場合に、安定したポート範囲を割り当てます。

AIコーディングセッションを調整する

Claude Code または Codex セッションが同じ開発サーバーポートを選択しないようにします。

プロジェクトのポート使用状況を監査する

ローカルサービスを開始する前に、登録済みプロジェクトと割り当てられた範囲を一覧表示します。

これらのプロンプトを試す

現在のプロジェクトを確認する
/port-allocator を使用して、現在のプロジェクトのポート範囲を表示してください。
登録済みポートを一覧表示する
/port-allocator list を使用して、登録済みプロジェクトとポート範囲を要約してください。
プロジェクトフォルダーをスキャンする
/port-allocator scan を使用して、設定済みのコードルート配下にある package.json プロジェクトを見つけてください。
安全に設定する
フォルダーが存在することを確認した後、/port-allocator config ~/Code を使用してください。Claude 権限を変更する前に確認してください。

ベストプラクティス

  • Claude の権限変更は、適用前に必ず確認してください。
  • コードルートは、現在使用中のプロジェクトを含む最小のフォルダーに設定してください。
  • プロセスを終了する前に、そのプロセスが現在のプロジェクトに属していることを確認してください。

回避

  • レビューなしに隠し Claude ファイルへの広範なワイルドカードアクセスを許可しないでください。
  • 単一の開発ポートを解放するために、すべての Node プロセスを kill しないでください。
  • セットアップ中にグローバルな Claude 指示ファイルを上書きしないでください。

よくある質問

このスキルは何を管理しますか?
package.json を含むプロジェクトのローカル開発ポート範囲を管理します。
開発サーバーを起動しますか?
いいえ。ポート割り当てと関連するローカルセットアップ手順を文書化します。
ポートデータはどこに保存されますか?
手順では、Claude 設定ディレクトリ配下のポートレジストリファイルを使用します。
非Nodeプロジェクトでも機能しますか?
それらのプロジェクトにも package.json が含まれている場合、または手順を適応させた場合のみ可能です。
なぜ権限をレビューする必要がありますか?
このスキルは、隠し Claude ファイルを読み取れる可能性がある広範な Bash 権限パターンを提案します。
このスキルでプロセスを kill しても安全ですか?
注意して使用してください。ローカルプロセスを終了する前に、ポートとプロセスの所有者を確認してください。

開発者情報

作成者

guo-yu

ライセンス

MIT

Skillstore リビジョン

r2

バージョンに関する注意

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

参照

286d37c9c189ddd1aafd3548415fb031d1df79d5

メンテナンスの新しさ

2026/8/11

利用状況

5 ダウンロード · 149 閲覧

ファイル構成

guo-yu のその他のスキル

すべて表示
すべて表示