@wdyy/skills 0.1.5 → 0.1.7

package/.well-known/skills/wdyy-deployment-standard/templates/docker-compose.blue-green.yml

@@ -1,34 +1,70 @@
 services:
+  frontend-blue:
+    image: ${FRONTEND_IMAGE:?FRONTEND_IMAGE is required}
+    env_file: ../../.env
+    environment:
+      INSTANCE_ID: blue
+      NGINX_ENVSUBST_FILTER: "^(INSTANCE_ID|FRONTEND_URL|FRONTEND_PORT|RELEASE_VERSION)$"
+    ports:
+      - "${DOCKER_BIND_IP}:${FRONTEND_BLUE_PORT}:${FRONTEND_PORT}"
+    volumes:
+      - ../../logs:/app/logs
+    restart: unless-stopped
+    healthcheck:
+      test: ["CMD-SHELL", "probe_host=$${FRONTEND_URL}; [ \"$${probe_host}\" != 0.0.0.0 ] || probe_host=127.0.0.1; wget -qO- \"http://$${probe_host}:$${FRONTEND_PORT}/health\""]
+      interval: 10s
+      timeout: 3s
+      retries: 6
+
   backend-blue:
-    image: ${BACKEND_BLUE_IMAGE:-backend-blue:not-configured}
-    env_file: ../../.env.production
+    image: ${BACKEND_IMAGE:?BACKEND_IMAGE is required}
+    env_file: ../../.env
     environment:
       INSTANCE_ID: blue
-      LOG_DIR: /var/log/application
+      HOST: ${BACKEND_URL}
+      PORT: ${BACKEND_PORT}
+    ports:
+      - "${DOCKER_BIND_IP}:${BACKEND_BLUE_PORT}:${BACKEND_PORT}"
+    volumes:
+      - ../../logs:/app/logs
+    restart: unless-stopped
+    healthcheck:
+      test: ["CMD-SHELL", "probe_host=$${BACKEND_URL}; [ \"$${probe_host}\" != 0.0.0.0 ] || probe_host=127.0.0.1; wget -qO- \"http://$${probe_host}:$${BACKEND_PORT}/health\""]
+      interval: 10s
+      timeout: 3s
+      retries: 6
+
+  frontend-green:
+    image: ${FRONTEND_IMAGE:?FRONTEND_IMAGE is required}
+    env_file: ../../.env
+    environment:
+      INSTANCE_ID: green
+      NGINX_ENVSUBST_FILTER: "^(INSTANCE_ID|FRONTEND_URL|FRONTEND_PORT|RELEASE_VERSION)$"
     ports:
-      - "127.0.0.1:${BLUE_PORT:-3001}:3000"
+      - "${DOCKER_BIND_IP}:${FRONTEND_GREEN_PORT}:${FRONTEND_PORT}"
     volumes:
-      - ${HOST_LOG_DIR:?set HOST_LOG_DIR}/backend/blue:/var/log/application
+      - ../../logs:/app/logs
     restart: unless-stopped
     healthcheck:
-      test: ["CMD", "wget", "-qO-", "http://localhost:3000/health"]
+      test: ["CMD-SHELL", "probe_host=$${FRONTEND_URL}; [ \"$${probe_host}\" != 0.0.0.0 ] || probe_host=127.0.0.1; wget -qO- \"http://$${probe_host}:$${FRONTEND_PORT}/health\""]
       interval: 10s
       timeout: 3s
       retries: 6
 
   backend-green:
-    image: ${BACKEND_GREEN_IMAGE:-backend-green:not-configured}
-    env_file: ../../.env.production
+    image: ${BACKEND_IMAGE:?BACKEND_IMAGE is required}
+    env_file: ../../.env
     environment:
       INSTANCE_ID: green
-      LOG_DIR: /var/log/application
+      HOST: ${BACKEND_URL}
+      PORT: ${BACKEND_PORT}
     ports:
-      - "127.0.0.1:${GREEN_PORT:-3002}:3000"
+      - "${DOCKER_BIND_IP}:${BACKEND_GREEN_PORT}:${BACKEND_PORT}"
     volumes:
-      - ${HOST_LOG_DIR:?set HOST_LOG_DIR}/backend/green:/var/log/application
+      - ../../logs:/app/logs
     restart: unless-stopped
     healthcheck:
-      test: ["CMD", "wget", "-qO-", "http://localhost:3000/health"]
+      test: ["CMD-SHELL", "probe_host=$${BACKEND_URL}; [ \"$${probe_host}\" != 0.0.0.0 ] || probe_host=127.0.0.1; wget -qO- \"http://$${probe_host}:$${BACKEND_PORT}/health\""]
       interval: 10s
       timeout: 3s
       retries: 6

package/.well-known/skills/wdyy-deployment-standard/templates/dockerignore.template

@@ -0,0 +1,17 @@
+.env
+.env.*
+!.env.example
+*.pem
+*.key
+id_rsa
+id_ed25519
+credentials
+credentials.*
+deploy/
+logs/
+.git/
+node_modules/
+venv/
+.pnpm-store/
+.deploy-build.lock/
+.deploy-build.*

package/.well-known/skills/wdyy-deployment-standard/templates/env.example.template

@@ -0,0 +1,30 @@
+# 前端
+FRONTEND_URL=0.0.0.0
+FRONTEND_PORT=5173
+
+# 后端
+BACKEND_URL=0.0.0.0
+BACKEND_PORT=3000
+
+# 数据库
+DB_URL=
+DB_PORT=5432
+DB_USER=
+DB_PASSWORD=
+DB_NAME=
+DB_SCHEMA=
+
+# API
+
+# 部署
+PROJECT_NAME=
+SERVER_PROJECTS_ROOT=
+PROJECT_HTTP_PORT=
+DOCKER_BIND_IP=
+FRONTEND_BLUE_PORT=
+FRONTEND_GREEN_PORT=
+BACKEND_BLUE_PORT=
+BACKEND_GREEN_PORT=
+FRONTEND_BASE_IMAGE=
+BACKEND_BASE_IMAGE=
+DATABASE_MIGRATION_MODE=

package/.well-known/skills/wdyy-deployment-standard/templates/frontend-container.conf.template

@@ -0,0 +1,24 @@
+server {
+  listen ${FRONTEND_URL}:${FRONTEND_PORT};
+  server_name _;
+  root /usr/share/nginx/html;
+  index index.html;
+  access_log /app/logs/frontend-${INSTANCE_ID}-access.log;
+  error_log /app/logs/frontend-${INSTANCE_ID}-error.log warn;
+
+  location = /health {
+    access_log off;
+    default_type text/plain;
+    return 200 'ok';
+  }
+
+  location = /version {
+    access_log off;
+    default_type text/plain;
+    return 200 '${RELEASE_VERSION}';
+  }
+
+  location / {
+    try_files $uri $uri/ /index.html;
+  }
+}

package/.well-known/skills/wdyy-deployment-standard/templates/frontend.Dockerfile.template

@@ -0,0 +1,7 @@
+ARG FRONTEND_BASE_IMAGE
+FROM ${FRONTEND_BASE_IMAGE}
+ARG RELEASE_VERSION
+ENV RELEASE_VERSION=${RELEASE_VERSION}
+LABEL org.opencontainers.image.version=${RELEASE_VERSION}
+COPY src/frontend/dist/ /usr/share/nginx/html/
+COPY scripts/deployment/frontend-container.conf.template /etc/nginx/templates/default.conf.template

package/.well-known/skills/wdyy-deployment-standard/templates/nginx-upstream.template.conf

@@ -1,26 +1,26 @@
-include /srv/<project>/deploy/nginx/backend-active.conf;
+# wdyy-project: __PROJECT_NAME__
+# wdyy-port: __PROJECT_HTTP_PORT__
+# wdyy-docker-ports: __DOCKER_HOST_PORTS__
+include "__DEPLOY_ROOT__/nginx/active-upstreams.conf";
 
 server {
+  listen __PROJECT_HTTP_PORT__;
+  server_name _;
+
   location /api/ {
-    proxy_pass http://backend_active;
+    proxy_pass http://__BACKEND_UPSTREAM_NAME__;
+    proxy_set_header Host $host;
+    proxy_set_header X-Real-IP $remote_addr;
+    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+    proxy_set_header X-Forwarded-Proto $scheme;
     proxy_set_header X-Trace-Id $request_id;
   }
 
-  location /releases/ {
-    root /srv/<project>;
-    try_files $uri =404;
-  }
-
   location / {
-    root /srv/<project>/current;
-    try_files $uri $uri/ /index.html;
-  }
-
-  location = /index.html {
-    add_header Cache-Control "no-cache, no-store, must-revalidate" always;
-  }
-
-  location ~* ^/releases/.+\.(?:js|css|woff2?|png|jpg|svg)$ {
-    add_header Cache-Control "public, max-age=31536000, immutable" always;
+    proxy_pass http://__FRONTEND_UPSTREAM_NAME__;
+    proxy_set_header Host $host;
+    proxy_set_header X-Real-IP $remote_addr;
+    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+    proxy_set_header X-Forwarded-Proto $scheme;
   }
 }

package/.well-known/skills/wdyy-logging-standard/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: wdyy-logging-standard
-description: 为 NestJS 和 Vue 项目实现前端异常上报、后端统一结构化 JSON 日志、traceId 传递、完整原始入参与 2MB 文件轮转。Use when 编写日志、错误处理、接口日志或审查生产可观测性时。
+description: 为 NestJS 和 Vue 项目实现仅写入项目根目录 ./logs 的结构化 JSON 日志、前端异常上报、traceId 传递、完整原始入参与 2MB 文件轮转。Use when 编写日志、错误处理、接口日志或审查生产可观测性时。
 ---
 
 # 企业日志规范
@@ -19,7 +19,7 @@ description: 为 NestJS 和 Vue 项目实现前端异常上报、后端统一结
 
 ## 输入与输出
 
-- 输入：服务名、实例标识、环境、请求上下文、`LOG_DIR`。
+- 输入：服务名、实例标识、环境和请求上下文；应用从项目根目录启动。
 - 输出：统一 logger、前端异常上报客户端、HTTP 日志中间件、日志文件命名规则和日志验证结果。
 - 使用 [日志规则](reference/logging-rules.md) 和 [logger 模板](templates/logger.template.ts)。
 
@@ -31,27 +31,28 @@ description: 为 NestJS 和 Vue 项目实现前端异常上报、后端统一结
 4. HTTP 请求日志记录完整的原始 `query`（查询参数）和 `body`（请求体）；授权请求可记录实际用户、模式、表和权限等入参。服务端返回成功时记录 `result: success`；返回失败时记录 `result: failure`，并在 `response` 中记录完整失败内容。HTTP `statusCode` 为 100–399 时为成功，400–599 时为失败。
 5. 日志不执行脱敏、数组截断或大对象裁剪；`body` 必须保留完整原始入参。
 6. Vue 捕获未处理异常和 Promise 拒绝并上报后端；浏览器不得尝试写服务器文件。
-7. 后端直接按 `LOG_DIR/yyyy-mm-dd_hh24-mm-ss.log` 写入，禁止创建子目录。若同一秒需要创建多个文件，依次使用 `yyyy-mm-dd_hh24-mm-ss_1.log`、`yyyy-mm-dd_hh24-mm-ss_2.log` 等递增后缀；既有日志文件不得重命名。最新文件超过 2MB 时创建新文件，并测试轮转。
+7. 后端只在项目根目录创建 `./logs`，并直接按 `./logs/yyyy-mm-dd_hh24-mm-ss.log` 写入；不得读取 `LOG_DIR`、`HOST_LOG_DIR` 或其他目录配置，不得在 `logs` 中创建任何子目录。使用排他创建避免并发覆盖；同一秒发生冲突时依次使用 `_1`、`_2` 等递增后缀。最新文件超过 2MB 时仍在 `./logs` 创建新文件，既有文件不得移动、重命名或覆盖。
 
 ## 禁止事项
 
 - 不得将 `message` 仅限制为 `success` 或 `error`。
 - 不得用 console 输出替代业务日志。
+- 不得将日志写入项目根目录 `./logs` 之外，或按服务、实例、日期、blue/green 颜色创建日志子目录。
 
 ## Red Flags
 
 - 业务代码直接调用 console，或 `body` 未保留完整原始入参。
 - 请求日志缺失 traceId、状态码或耗时。
-- 同秒创建的日志文件覆盖既有文件，或前端异常未进入统一后端日志。
+- 日志路径可被环境变量改变、生成了日志子目录、同秒文件覆盖既有文件，或前端异常未进入统一后端日志。
 
 ## Verification
 
 - [ ] 正常、异常和 HTTP 请求日志均为可解析 JSON。
 - [ ] traceId 跨入口与内部调用可追踪。
-- [ ] 完整 HTTP 入参、服务端成功/失败结果映射、失败响应内容与同秒递增命名均有测试覆盖，轮转阈值可验证。
+- [ ] 完整 HTTP 入参、服务端成功/失败结果映射、失败响应内容、固定 `./logs` 路径、同秒递增命名与轮转阈值均有测试覆盖。
 - [ ] 前端异常上报经过后端身份校验。
-- [ ] 日志直接写入持久化挂载的 `LOG_DIR`，容器替换后日志仍保留。
-- [ ] `LOG_DIR` 缺失或不可写时服务以明确错误停止。
+- [ ] 日志直接写入项目根目录 `./logs`，且容器替换后日志仍保留。
+- [ ] 项目根目录或 `./logs` 不可写时服务以明确错误停止。
 
 ## Common Rationalizations
 

package/.well-known/skills/wdyy-logging-standard/agents/openai.yaml

@@ -1,4 +1,4 @@
 interface:
   display_name: "Enterprise Logging Standard"
-  short_description: "Implement full-context structured logs and frontend error reporting"
-  default_prompt: "Use $wdyy-logging-standard to implement full-context structured logs, result recording, and frontend error reporting."
+  short_description: "Write full-context logs only to project-root ./logs"
+  default_prompt: "Use $wdyy-logging-standard to implement full-context structured logs that write only to project-root ./logs."

package/.well-known/skills/wdyy-logging-standard/reference/logging-rules.md

@@ -3,10 +3,11 @@
 - 日志为一行 JSON，最小字段见 `logger.template.ts`。
 - `logger.template.ts` 必须可在未安装 `@types/node` 的项目中独立类型检查；读取环境变量时通过 `globalThis` 声明最小运行时形状，不直接依赖 Node.js 全局类型。
 - `timestamp` 使用服务器本地时间 `YYYY-MM-DD HH:mm:ss`，精确到秒；不得包含毫秒、`T` 或 `Z`。
-- 文件直接写入 `LOG_DIR`，不得创建服务、实例或日期子目录。文件名使用服务器本地时间 `yyyy-mm-dd_hh24-mm-ss.log`；同一秒内创建多个文件时，后续文件依次为 `yyyy-mm-dd_hh24-mm-ss_1.log`、`yyyy-mm-dd_hh24-mm-ss_2.log`。最新日志文件大于 2MB 时先创建新文件再写入，既有日志文件不得重命名或覆盖。
+- 应用必须从项目根目录启动，只允许创建项目根目录 `./logs`，并将文件直接写入该目录；不得读取 `LOG_DIR`、`HOST_LOG_DIR` 或其他目录配置，不得创建服务、实例、日期、blue/green 颜色或其他日志子目录。
+- 文件名使用服务器本地时间 `yyyy-mm-dd_hh24-mm-ss.log`。使用排他创建；同一秒内文件名冲突时依次尝试 `yyyy-mm-dd_hh24-mm-ss_1.log`、`yyyy-mm-dd_hh24-mm-ss_2.log`，不得先检查后覆盖写入。最新日志文件大于 2MB 时在同一 `./logs` 中创建新文件，既有日志文件不得移动、重命名或覆盖。
 - 日志仅记录关键业务事件、请求和异常；`params`、`query`、`body` 和 `response` 均保留完整原始值，不执行脱敏、数组截断或大对象裁剪。授权请求可记录实际用户、模式、表和权限等入参。
 - HTTP 日志必须保留 `statusCode`。服务端成功返回时 `result` 为 `success`；失败返回时 `result` 为 `failure`，并在 `response` 中保留完整失败内容。100–399 为成功，400–599 为失败。
 - HTTP 入口和内部服务调用必须透传 traceId。
-- 每条日志必须包含 `instanceId`；通过同秒递增后缀避免多个实例或进程覆盖同一日志文件。
+- 每条日志必须包含 `instanceId`；blue、green 与其他进程共享同一 `./logs`，通过排他创建和同秒递增后缀避免覆盖。
 - Vue 未处理异常和 Promise 拒绝必须上报后端；后端校验请求身份后写入统一日志。
-- 日志目录必须挂载到容器外部持久路径，替换容器不得删除历史日志。
+- 容器必须将宿主机项目根目录 `./logs` 挂载到应用根目录 `/app/logs`，替换容器不得删除历史日志。

package/.well-known/skills/wdyy-logging-standard/scripts/validate-log-entry.test.mjs

@@ -4,7 +4,12 @@ import { tmpdir } from 'node:os';
 import { join } from 'node:path';
 import { afterEach, test } from 'node:test';
 import { spawnSync } from 'node:child_process';
-import { createLogFileName } from '../templates/logger.template.ts';
+import {
+  createLogFileName,
+  createLogFilePath,
+  LOG_DIRECTORY,
+  MAX_LOG_FILE_SIZE_BYTES,
+} from '../templates/logger.template.ts';
 
 const validator = new URL('./validate-log-entry.mjs', import.meta.url);
 const temporaryDirectories = [];
@@ -34,6 +39,50 @@ test('同一秒日志文件使用递增后缀', () => {
   );
 });
 
+test('日志路径固定在项目根目录的扁平 logs 目录', () => {
+  const date = new Date(2026, 6, 28, 9, 5, 3);
+
+  assert.equal(LOG_DIRECTORY, './logs');
+  assert.deepEqual(
+    [createLogFilePath(date), createLogFilePath(date, 1), createLogFilePath(date, 2)],
+    [
+      './logs/2026-07-28_09-05-03.log',
+      './logs/2026-07-28_09-05-03_1.log',
+      './logs/2026-07-28_09-05-03_2.log',
+    ],
+  );
+  assert.ok(
+    [createLogFilePath(date), createLogFilePath(date, 1), createLogFilePath(date, 2)]
+      .every((path) => path.split('/').length === 3),
+  );
+});
+
+test('旧日志目录环境变量不能改变固定路径', () => {
+  const previousLogDir = process.env.LOG_DIR;
+  const previousHostLogDir = process.env.HOST_LOG_DIR;
+  process.env.LOG_DIR = '/tmp/legacy-logs';
+  process.env.HOST_LOG_DIR = '/srv/legacy-logs';
+
+  try {
+    assert.equal(
+      createLogFilePath(new Date(2026, 6, 28, 9, 5, 3)),
+      './logs/2026-07-28_09-05-03.log',
+    );
+  } finally {
+    if (previousLogDir === undefined) delete process.env.LOG_DIR;
+    else process.env.LOG_DIR = previousLogDir;
+    if (previousHostLogDir === undefined) delete process.env.HOST_LOG_DIR;
+    else process.env.HOST_LOG_DIR = previousHostLogDir;
+  }
+});
+
+test('2MB 轮转阈值使用同一 logs 目录的下一个候选路径', () => {
+  const date = new Date(2026, 6, 28, 9, 5, 3);
+
+  assert.equal(MAX_LOG_FILE_SIZE_BYTES, 2 * 1024 * 1024);
+  assert.equal(createLogFilePath(date, 3), './logs/2026-07-28_09-05-03_3.log');
+});
+
 test('蓝绿实例日志必须包含 instanceId', async () => {
   const result = await validate({
     timestamp: '2026-07-09 08:00:00',

package/.well-known/skills/wdyy-logging-standard/templates/logger.template.ts

@@ -24,6 +24,9 @@ export type LogEntry = LogContext & {
 
 const pad = (value: number) => String(value).padStart(2, '0');
 
+export const LOG_DIRECTORY = './logs' as const;
+export const MAX_LOG_FILE_SIZE_BYTES = 2 * 1024 * 1024;
+
 type RuntimeEnvironment = Record<string, string | undefined>;
 
 const getRuntimeEnvironment = (): RuntimeEnvironment => {
@@ -44,6 +47,10 @@ export const createLogFileName = (date = new Date(), collisionIndex = 0): string
   return `${baseName}${collisionIndex > 0 ? `_${collisionIndex}` : ''}.log`;
 };
 
+export const createLogFilePath = (date = new Date(), collisionIndex = 0): string => (
+  `${LOG_DIRECTORY}/${createLogFileName(date, collisionIndex)}`
+);
+
 const resultForStatusCode = (statusCode: number): LogEntry['result'] => {
   if (statusCode >= 100 && statusCode <= 399) return 'success';
   if (statusCode >= 400 && statusCode <= 599) return 'failure';

package/README.md

@@ -18,7 +18,7 @@ OpenSpec                           单项变更的需求、设计、任务、实
 | `wdyy-api-standard` | 根据“获取XX数据”“使用XX接口”等需求定位接口 reference，并按已确认契约写入调用方式。 |
 | `wdyy-bug-record` | 手动汇总当前任务已解决的问题，并按模板追加至 `docs/bug_record.md`。 |
 | `wdyy-logging-standard` | 结构化日志、敏感字段移除、traceId、前端异常上报与日志轮转。 |
-| `wdyy-deployment-standard` | 人工 SCP 交付、版本化前端资源、Docker 蓝绿发布与回滚。 |
+| `wdyy-deployment-standard` | 扩充标准五段环境配置，生成人工交付、双 Docker 蓝绿发布与回滚文件。 |
 
 ## 使用方式
 
@@ -29,7 +29,7 @@ npm install -g @wdyy/skills
 wdyy init
 ```
 
-`wdyy init` 会在系统用户目录 `.agents/skills/` 安装或更新 5 个受管理 Skill，不在目标项目创建 `.agents/skills/`。它还会执行 `git init`，创建或补齐 `.gitignore` 的 `.env`、`node_modules/`、`venv/`、`.pnpm-store/`、`logs/`、`dist/`、`.DS_Store`、`*.tar.gz` 规则，创建 `src/frontend`、`src/backend`、`database`、`deploy`、`docs`、`scripts`、`tests` 和空 `.env.example`，并执行 `openspec init`、创建或追加 `docs/bug_record.md` 模板。若目标项目已有 `AGENTS.md`，原文件保持不变，命令将生成 `AGENTS_new.md`。
+`wdyy init` 会在系统用户目录 `.agents/skills/` 安装或更新 5 个受管理 Skill，不在目标项目创建 `.agents/skills/`。它还会执行 `git init`，创建或补齐 `.gitignore` 的 `.env`、`node_modules/`、`venv/`、`.pnpm-store/`、`logs/`、`dist/`、`.DS_Store`、`*.tar.gz` 规则，创建 `src/frontend`、`src/backend`、`database`、`deploy`、`docs`、`scripts`、`tests`，并以相同的“前端、后端、数据库、API、部署”结构创建缺失的 `.env` 与 `.env.example`。默认前端监听 `0.0.0.0:5173`、后端监听 `0.0.0.0:3000`、数据库端口为 `5432`；已有环境文件保持不变。随后命令执行 `openspec init`、创建或追加 `docs/bug_record.md` 模板。若目标项目已有 `AGENTS.md`，原文件保持不变，命令将生成 `AGENTS_new.md`。
 
 ### 仅更新已安装的 Skill
 

package/lib/wdyy-cli.js

@@ -34,7 +34,28 @@ const requiredGitIgnoreEntries = [
   '*.tar.gz'
 ];
 
-const defaultProjectLayout = [...defaultProjectDirectories, '.env.example'];
+const defaultEnvironmentContent = `# 前端
+FRONTEND_URL=0.0.0.0
+FRONTEND_PORT=5173
+
+# 后端
+BACKEND_URL=0.0.0.0
+BACKEND_PORT=3000
+
+# 数据库
+DB_URL=
+DB_PORT=5432
+DB_USER=
+DB_PASSWORD=
+DB_NAME=
+DB_SCHEMA=
+
+# API
+
+# 部署
+`;
+
+const defaultProjectLayout = [...defaultProjectDirectories, '.env', '.env.example'];
 
 const generatedAgentsContent = `# 企业开发规则
 
@@ -49,7 +70,7 @@ const generatedAgentsContent = `# 企业开发规则
 
 默认项目目录为 ${defaultProjectLayout.map((path) => `\`${path}\``).join('、')}。
 
-所有 URL、端口和 IP 地址必须从 \`.env\` 文件读取，禁止在代码中硬编码；不得提交秘密或生产环境 \`.env\`。
+所有 URL、端口和 IP 地址必须从项目根目录的 \`.env\` 文件读取，禁止在代码中硬编码；不得提交秘密或生产环境 \`.env\`。
 
 项目开发完成后必须创建 \`README.md\`，内容包括项目技术栈、目录结构和安装部署说明。
 
@@ -158,13 +179,18 @@ async function createDefaultProjectLayout(targetRoot, writtenPaths) {
     if (!existed) writtenPaths.push(destination);
   }
 
-  const envExamplePath = join(targetRoot, '.env.example');
-  try {
-    await access(envExamplePath);
-  } catch (error) {
-    if (error.code !== 'ENOENT') throw error;
-    await writeFile(envExamplePath, '', 'utf8');
-    writtenPaths.push(envExamplePath);
+  for (const environmentFile of ['.env', '.env.example']) {
+    const environmentPath = join(targetRoot, environmentFile);
+    try {
+      await access(environmentPath);
+    } catch (error) {
+      if (error.code !== 'ENOENT') throw error;
+      await writeFile(environmentPath, defaultEnvironmentContent, {
+        encoding: 'utf8',
+        mode: environmentFile === '.env' ? 0o600 : 0o644
+      });
+      writtenPaths.push(environmentPath);
+    }
   }
   console.log(`已准备默认项目目录: ${defaultProjectDirectories.join('、')}`);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wdyy/skills",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "企业内部开发 Skill 与项目初始化命令",
   "type": "module",
   "bin": {