無料GitHub で公開日本語紹介

add-setting-env

ユーザー設定の初期値をサーバー側の環境変数で切り替えるため、型定義や設定の組み立て、ユーザーストアへの反映、環境変数の例と説明書きを追加する手順です。

原文原文の説明を見る

Add server-side environment variables that control default values for user settings.

lobehub/lobehubスター 83,502(GitHub 83,502 + cccskills 0)

実行スコア未検証

インストール方法を見る

こんなときに便利

設定の初期値を環境変数で変えたいとき
設定項目をサーバー設定に追加したいとき
環境変数の例と説明を更新したいとき

日本語での紹介

できること

ユーザー設定の初期値をサーバー側の環境変数から与えるための実装手順を案内します。環境変数をcreateEnvとzodで定義し、必要に応じてサーバー設定の型、グローバル設定の組み立て、ユーザーストアへの反映を追加します。最後に.env.exampleとセルフホスティング向けの環境変数ドキュメントを更新します。値の優先順位は、ユーザーのカスタム設定、サーバー環境変数、ハードコードされた初期値の順です。

こんなときに便利

セルフホスト環境ごとにユーザー設定の初期値を変えたいときや、新しい設定項目を環境変数で制御できるようにしたいときに向いています。既存の型を再利用しながら、環境変数の検証から設定の受け渡し、利用者向けの記述まで一通りそろえる際に参照できます。

使い方の例

「このユーザー設定の初期値を環境変数で指定できるようにしてください」
「新しい設定ドメインをサーバー設定とストアに接続してください」
「環境変数の例とセルフホスティング向けドキュメントも更新してください」

注意点

サーバー側の設定、ストア、型、環境変数ドキュメントを扱うプロジェクト向けです。説明対象のドキュメントは英語版と中国語版です。

この紹介文は、公開されている SKILL.md をもとに AI（OpenAI Codex）が作成しました。正確な仕様は下の原文を確認してください。

資料チェック

SKILL.md の記述から、注意が要る操作と導入の前提を AI が確認しました。点数は実際に動かした結果（実行検証）だけで付けています。

安全面送信・削除・コマンド実行などの扱いが明示されているか: A良好設定値の追加と文書更新が中心で、外部送信や削除操作は記載されていません。
導入のしやすさ必要なツールや API キーが少ないか、書かれているか: B一部不足`createEnv`・`zod`などを使いますが、導入手順や必要版はありません。

点数には入れていません。 2026年10月26日時点で AI（OpenAI Codex）が判定しました。目安なので、入れる前に原文も確認してください。

評価が違うと思ったら、見直しを依頼する

含まれるファイル（2）

SKILL.md2.5 KB
agents/openai.yaml43 B

SKILL.md（原文）

インストールする前に、エージェントに与えられる指示の中身を確認できます。

Adding Environment Variable for User Settings

Add server-side environment variables to configure default values for user settings.

Priority: User Custom > Server Env Var > Hardcoded Default

Steps

1. Define Environment Variable

Create packages/env/src/<domain>.ts (import path stays @/envs/<domain> — tsconfig maps to packages/env/src/* first):

import { createEnv } from '@t3-oss/env-core';
import { z } from 'zod';

export const get<Domain>Config = () => {
  return createEnv({
    server: {
      YOUR_ENV_VAR: z.coerce.number().min(MIN).max(MAX).optional(),
    },
    runtimeEnv: {
      YOUR_ENV_VAR: process.env.YOUR_ENV_VAR,
    },
  });
};

export const <domain>Env = get<Domain>Config();

2. Update Type (if new domain)

Add to packages/types/src/serverConfig.ts:

import { User<Domain>Config } from './user/settings';

export interface GlobalServerConfig {
  <domain>?: PartialDeep<User<Domain>Config>;
}

Prefer reusing existing types from packages/types/src/user/settings.

3. Assemble Server Config (if new domain)

In apps/server/src/globalConfig/index.ts:

import { <domain>Env } from '@/envs/<domain>';

export const getServerGlobalConfig = async () => {
  const config: GlobalServerConfig = {
    <domain>: cleanObject({
      <settingName>: <domain>Env.YOUR_ENV_VAR,
    }),
  };
  return config;
};

4. Merge to User Store (if new domain)

In src/store/user/slices/common/action.ts:

const serverSettings: PartialDeep<UserSettings> = {
  <domain>: serverConfig.<domain>,
};

5. Update .env.example

# <Description> (range/options, default: X)
# YOUR_ENV_VAR=<example>

6. Update Documentation

docs/self-hosting/environment-variables/basic.mdx (EN)
docs/self-hosting/environment-variables/basic.zh-CN.mdx (CN)

Example: AI_IMAGE_DEFAULT_IMAGE_NUM

// packages/env/src/image.ts  (import as @/envs/image)
AI_IMAGE_DEFAULT_IMAGE_NUM: z.coerce.number().min(1).max(20).optional(),

// packages/types/src/serverConfig.ts
image?: PartialDeep<UserImageConfig>;

// apps/server/src/globalConfig/index.ts
image: cleanObject({ defaultImageNum: imageEnv.AI_IMAGE_DEFAULT_IMAGE_NUM }),

// src/store/user/slices/common/action.ts
image: serverConfig.image,

// .env.example
# AI_IMAGE_DEFAULT_IMAGE_NUM=4

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

ログインなしで書き込めます。使ってみた感想、質問、動かなかった環境などを気軽にどうぞ。

まだコメントはありません。最初のコメントを書いてみませんか。

同じリポジトリのスキル