@wdyy/skills 0.1.5 → 0.1.6

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

@@ -4,14 +4,15 @@ services:
     env_file: ../../.env.production
     environment:
       INSTANCE_ID: blue
-      LOG_DIR: /var/log/application
+      HOST: ${BACKEND_LISTEN_HOST}
+      PORT: ${BACKEND_CONTAINER_PORT}
     ports:
-      - "127.0.0.1:${BLUE_PORT:-3001}:3000"
+      - "${BACKEND_BIND_IP}:${BLUE_PORT}:${BACKEND_CONTAINER_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", "wget", "-qO-", "${BACKEND_CONTAINER_HEALTH_URL}"]
       interval: 10s
       timeout: 3s
       retries: 6
@@ -21,14 +22,15 @@ services:
     env_file: ../../.env.production
     environment:
       INSTANCE_ID: green
-      LOG_DIR: /var/log/application
+      HOST: ${BACKEND_LISTEN_HOST}
+      PORT: ${BACKEND_CONTAINER_PORT}
     ports:
-      - "127.0.0.1:${GREEN_PORT:-3002}:3000"
+      - "${BACKEND_BIND_IP}:${GREEN_PORT}:${BACKEND_CONTAINER_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", "wget", "-qO-", "${BACKEND_CONTAINER_HEALTH_URL}"]
       interval: 10s
       timeout: 3s
       retries: 6

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

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

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

@@ -1,22 +1,23 @@
-include /srv/<project>/deploy/nginx/backend-active.conf;
+include "__DEPLOY_ROOT__/nginx/backend-active.conf";
 
 server {
   location /api/ {
-    proxy_pass http://backend_active;
+    proxy_pass __BACKEND_PROXY_URL__;
     proxy_set_header X-Trace-Id $request_id;
   }
 
   location /releases/ {
-    root /srv/<project>;
+    root "__DEPLOY_ROOT__";
     try_files $uri =404;
   }
 
   location / {
-    root /srv/<project>/current;
+    root "__DEPLOY_ROOT__/current";
     try_files $uri $uri/ /index.html;
   }
 
   location = /index.html {
+    root "__DEPLOY_ROOT__/current";
     add_header Cache-Control "no-cache, no-store, must-revalidate" always;
   }
 

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/package.json

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