技能 gen-env

📦

gen-env

Name: gen-env
Author: 0xBigBoss

低风险 ⚙️ 外部命令🌐 网络访问📁 文件系统访问🔑 环境变量

分離されたlocalhost環境の生成

也可从以下获取: 0xBigBoss

localhostで同じプロジェクトの複数のインスタンスを実行すると、ポートの競合、データ破損、ブラウザステートの混合が発生します。このスキルは、各インスタンスを固有のポート、Dockerリソース、ブラウザドメインで分離する環境構成を生成します。

支持: Claude Codex Code(CC)

⚠️ 67 差

下载技能 ZIP

在 Claude 中上传

前往设置 → 功能 → 技能 → 上传技能

开启并开始使用

测试它

正在使用“gen-env”。複数の分離されたインスタンスをサポートするDocker Composeプロジェクトのgen-envスクリプトを生成する

预期结果:

# 生成された.localnet.envファイル構造
# インスタンス: feature-x
WORKSPACE_NAME=feature-x
COMPOSE_PROJECT_NAME=localnet-feature-x
DOCKER_NETWORK=localnet-feature-x
VOLUME_PREFIX=localnet-feature-x
# 割り当てられたポート
POSTGRES_PORT=51234
REDIS_PORT=51235
API_PORT=51236
WEB_PORT=51237
# ブラウザ分離ホスト
APP_HOST=feature-x.localhost

正在使用“gen-env”。私のgen-envロックファイルは何を含む必要がありますか？

预期结果:

ロックファイルには次のものを格納する必要があります：バージョン番号、生成タイムスタンプ、instanceConfigの完全な内容包括くワークスペース名、すべての生成されたポート、派生URL。例：{ version: 1, generatedAt: '2024-01-15T10:30:00Z', instance: { name, ports, urls, ... } }

正在使用“gen-env”。他のインスタンスに影響を与えずに1つのインスタンスをクリーンアップするにはどうすればよいですか？

预期结果:

外科的クリーンアップにCOMPOSE_PROJECT_NAMEを使用してください：docker compose -p localnet-feature-x down -v。これにより、特定のインスタンスのコンテナ、ネットワーク、ボリュームのみが削除されます。プロジェクトフラグなしのdocker compose down -vはデフォルトプロジェクトに影響するため避けてください。

安全审计

低风险

v4 • 1/21/2026

Static analysis detected patterns in documentation files (ADVANCED_PATTERNS.md, IMPLEMENTATION.md, SKILL.md) containing shell command examples and environment variable usage. These are educational examples of legitimate development patterns (Docker Compose, port allocation, environment generation). No malicious intent, data exfiltration, or unauthorized credential access found. The skill is a local development environment management tool with standard devops functionality.

已扫描文件

4,807

分析行数

发现项

审计总数

风险因素

⚙️ 外部命令 (205)

🌐 网络访问 (22)

📁 文件系统访问 (14)

ADVANCED_PATTERNS.md:87 ADVANCED_PATTERNS.md:266 ADVANCED_PATTERNS.md:430 ADVANCED_PATTERNS.md:431 IMPLEMENTATION.md:16 IMPLEMENTATION.md:16 IMPLEMENTATION.md:236 IMPLEMENTATION.md:257 IMPLEMENTATION.md:490 IMPLEMENTATION.md:512 IMPLEMENTATION.md:862 IMPLEMENTATION.md:545 IMPLEMENTATION.md:578 skill-report.json:6

🔑 环境变量 (21)

审计者: claude 查看审计历史 →

质量评分

架构

100

可维护性

内容

社区

安全

规范符合性

你能构建什么

複数の機能ブランチを同時に実行する

複数の機能ブランチで作業する開発者は、各インスタンスを自有のワークスペース名、ポート、データで実行でき、競合が発生しません。

異なるバージョンを分離してテストする

QAエンジニアは、完全に分離されたデータベースとブラウザセッションで、同一アプリケーションのバージョンAとバージョンBを並べてテストできます。

既存のgen-env実装をレビューする

メンテナーは、プロジェクトのgen-envスクリプトがインスタンス分離とクリーンアップに関するすべてのベストプラクティスに従っていることを検証できます。

试试这些提示

基本的なgen-envスクリプトを生成する

私のプロジェクト用に、複数の分離されたインスタンスを実行するための環境構成を生成するgen-envコマンドスクリプトを作成してください。スクリプトはワークスペースIDの--name引数を受け付け、エフェメラルポート範囲49152-65535からポートを割り当て、COMPOSE_PROJECT_NAME、固有のポート、*.localhostホストURLを含む.localnet.envファイルを出力する必要があります。

ポート競合処理を追加する

私の既存のgen-envスクリプトにポート競合検出と処理を追加してください。要求されたポートが使用中の場合、100msのタイムアウトで次の利用可能なポートを試す必要があり、ポートが利用可能な場合は警告を出力してください。

ブラウザ分離を実装する

私のgen-envスクリプトを更新して、*.localhostサブドメインを使用したブラウザ分離URLを生成してください。各インスタンスはfeature-x.localhostのような固有のホスト名を取得し、インスタンス間のCookieとlocalStorageが分離された状態を維持する必要があります。

gen-env実装をレビューする

[ファイルパス]にある私のプロジェクトのgen-env実装を次のチェックリストに対してレビューしてください：ワークスペース名の検証、COMPOSE_PROJECT_NAMEの生成、エフェメラルポートの作成、ロックファイルの生成、外科的クリーンアップのサポート。ギャップをリストし、修正を提案してください。

最佳实践

常にワークスペース名を検証してください（英数字+ダッシュ、DNS互換性は最大63文字）
割り当てられたポートをロックファイルに格納し、以降の実行で同じポートを再利用して一貫性を確保してください
有名なサービスとの競合を避けるため、エフェメラルポート範囲49152-65535を使用してください
ブラウザ分離には*.localhostホストを使用してください（localhostの異なるポートではなく）

避免

ハードコードされたlocalhostURL（http://localhost:3000）を使用する - これはインスタンス間でCookieを共有します
COMPOSE_PROJECT_NAMEを省略する - これはDockerがディレクトリ名を使用し、競合のリスクがあります
プロジェクト名なしのdocker compose down -vを使用する - これはすべてのインスタンスを区別なく削除します
インスタンス間で同じデータベースボリュームを共有する - これはデータ破損を引き起こします

常见问题

インスタンスにはどのポートを使用すべきですか？

エフェメラル範囲49152-65535のポートを使用してください。これらのポートは有名なサービスに割り当てられておらず、動的な割り当てに安全です。各サービス（postgres、redis、api、web）に対して各インスタンスに固有のポートを割り当ててください。

*.localhostでのブラウザ分離はどのように機能しますか？

ChromeとEdgeは*.localhostを自動的に127.0.0.1として扱います。異なるサブドメイン（main.localhost対feature-x.localhost）は同じポートでも別々のCookieとlocalStorageを維持し、localhostの異なるポートでは解決できない分離問題を解決します。

COMPOSE_PROJECT_NAMEとは何ですか？なぜ重要ですか？

COMPOSE_PROJECT_NAMEはすべてのDockerリソース（コンテナ、ネットワーク、ボolume、サービス）のプレフィックスを制御します。これを明示的に設定することで、各インスタンスがlocalnet-feature-x_postgres_dataのような予測可能な名前で分離されたリソースを取得することを保証します。

インスタンス間のポート競合をどのように処理すればよいですか？

割り当て前に短いタイムアウト（100ms）を使用してポートの可用性を確認してください。ポートが使用中の場合、シーケンスの次のポートを試してください。割り当てられたポートをロックファイルに格納し、同じインスタンスが以降の実行で常に同じポートを取得するようにしてください。

バージョン管理に何をコミットすべきですか？

gen-envスクリプト自体と任意の設定テンプレートをコミットしてください。.localnet.envと.gen-env.lockを.gitignoreに追加してください。これらはインスタンス固有の生成ファイルであり、共有すべきではありません。

gen-envを既存の開発ワークフローにどのように統合すればよいですか？

生成された.localnet.envを読み込む.direnvファイルを持つdirenvを使用してください。gen-envスクリプトディレクトリをPATHに追加してください。Docker Composeを開始する前にgen-env --name <workspace>を実行し、完了時にgen-env --cleanを実行してください。

开发者详情

作者

0xBigBoss

许可证

MIT

仓库

https://github.com/0xBigBoss/claude-code/tree/main/.claude/skills/gen-env

引用

main

文件结构

📄 ADVANCED_PATTERNS.md

📄 IMPLEMENTATION.md

📄 SKILL.md