@wdyy/skills 0.1.11 → 0.1.12

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

@@ -0,0 +1,35 @@
+services:
+  frontend:
+    image: ${FRONTEND_IMAGE:?FRONTEND_IMAGE is required}
+    env_file: ../../.env
+    environment:
+      NGINX_ENVSUBST_FILTER: "^(FRONTEND_URL|FRONTEND_PORT|RELEASE_VERSION)$"
+      RELEASE_VERSION: ${RELEASE_VERSION:?RELEASE_VERSION is required}
+    ports:
+      - "${DOCKER_BIND_IP}:${FRONTEND_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:
+    image: ${BACKEND_IMAGE:?BACKEND_IMAGE is required}
+    env_file: ../../.env
+    environment:
+      HOST: ${BACKEND_URL}
+      PORT: ${BACKEND_PORT}
+      RELEASE_VERSION: ${RELEASE_VERSION:?RELEASE_VERSION is required}
+    ports:
+      - "${DOCKER_BIND_IP}:${BACKEND_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

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

@@ -18,11 +18,6 @@ DB_SCHEMA=
 
 # 部署
 PROJECT_NAME=
-PROJECT_HTTP_PORT=
 DOCKER_BIND_IP=
-FRONTEND_BLUE_PORT=
-FRONTEND_GREEN_PORT=
-BACKEND_BLUE_PORT=
-BACKEND_GREEN_PORT=
 FRONTEND_BASE_IMAGE=nginx:stable
 BACKEND_BASE_IMAGE=node:24-alpine3.24

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

@@ -3,8 +3,8 @@ server {
   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;
+  access_log /app/logs/frontend-access.log;
+  error_log /app/logs/frontend-error.log warn;
 
   location = /health {
     access_log off;

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

@@ -19,7 +19,7 @@ description: 为 NestJS 和 Vue 项目实现仅写入项目根目录 ./logs 的
 
 ## 输入与输出
 
-- 输入：服务名、实例标识、环境和请求上下文；应用从项目根目录启动。
+- 输入：服务名、进程实例标识、环境和请求上下文；应用从项目根目录启动。
 - 输出：统一 logger、前端异常上报客户端、HTTP 日志中间件、日志文件命名规则和日志验证结果。
 - 使用 [日志规则](reference/logging-rules.md) 和 [logger 模板](templates/logger.template.ts)。
 
@@ -37,7 +37,7 @@ description: 为 NestJS 和 Vue 项目实现仅写入项目根目录 ./logs 的
 
 - 不得将 `message` 仅限制为 `success` 或 `error`。
 - 不得用 console 输出替代业务日志。
-- 不得将日志写入项目根目录 `./logs` 之外，或按服务、实例、日期、blue/green 颜色创建日志子目录。
+- 不得将日志写入项目根目录 `./logs` 之外，或按服务、实例、日期等维度创建日志子目录。
 
 ## Red Flags
 

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

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

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

@@ -83,7 +83,7 @@ test('2MB 轮转阈值使用同一 logs 目录的下一个候选路径', () => {
   assert.equal(createLogFilePath(date, 3), './logs/2026-07-28_09-05-03_3.log');
 });
 
-test('蓝绿实例日志必须包含 instanceId', async () => {
+test('多进程日志必须包含 instanceId', async () => {
   const result = await validate({
     timestamp: '2026-07-09 08:00:00',
     level: 'info',

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` | 扩充标准五段环境配置，生成人工交付、双 Docker 蓝绿发布与回滚文件。 |
+| `wdyy-deployment-standard` | 扩充标准五段环境配置，生成带版本前后端双镜像、人工上传、直接宿主机端口与服务器交互菜单部署文件；不使用蓝绿部署。 |
 
 ## 使用方式
 
@@ -43,7 +43,9 @@ wdyy update-skill --all
 
 `wdyy update-skill <skill-name>` 只接受 5 个受管理的 `wdyy-*` Skill，且仅替换系统用户目录 `.agents/skills/` 中的指定目录；`--all` 替换全部 5 个受管理 Skill。两种方式都不会写入调用项目的 `AGENTS.md`、`AGENTS_new.md`、`docs/bug_record.md` 或 `.agents/skills/`，也不会执行 `openspec init`。首次初始化或需要重新生成项目规则时，使用 `wdyy init`。
 
-中大型变更先使用 `/opsx:explore` 或 `/opsx:propose <change-name>`，在方案确认后使用 `/opsx:apply`；完成验证后使用 `/opsx:archive`。涉及数据库、内部 API、日志、部署时，按 `AGENTS.md` 的路由加载相应企业 Skill。所有 URL、端口和 IP 地址从 `.env` 读取，不得硬编码；不得提交秘密或生产环境 `.env`。项目完成后创建 `README.md`，说明技术栈、目录结构和安装部署。
+部署 Skill 生成的标准流程为：在本地项目根目录执行 `./deploy.sh build`，构建并导出 `<项目名>_frontend:<YYYYMMDD-NNN>` 与 `<项目名>_backend:<YYYYMMDD-NNN>`，人工上传完整 `deploy/` 内容作为服务器项目根目录；服务器无参数执行 `./deploy.sh`，选择运行或替换前端、运行或替换后端、运行或替换前后端，或同时停止两个服务。前后端直接暴露 `.env` 中的宿主机端口，不生成蓝绿服务或宿主机 Nginx 配置。应用、前端 Nginx 与部署操作日志均直接保存在服务器项目根目录 `logs/`。
+
+中大型变更先使用 `/opsx:explore` 或 `/opsx:propose <change-name>`，在方案确认后使用 `/opsx:apply`；完成验证后使用 `/opsx:archive`。涉及数据库、内部 API、日志、部署时，按 `AGENTS.md` 的路由加载相应企业 Skill。所有 URL、端口和 IP 地址从 `.env` 读取，不得硬编码；所有项目管理的日志直接写入项目根目录 `logs/`；生产部署不使用蓝绿发布。不得提交秘密或生产环境 `.env`。项目完成后创建 `README.md`，说明技术栈、目录结构和安装部署。
 
 ## 固定技术栈
 

package/lib/wdyy-cli.js

@@ -81,14 +81,15 @@ const generatedAgentsContent = `# 企业开发规则
 | PostgreSQL 表、DDL、迁移、数据兼容性 | \`wdyy-database-standard\` |
 | 获取已登记接口数据、使用已登记接口 | \`wdyy-api-standard\` |
 | 汇总当前任务已解决的 BUG、漏洞或运行异常 | 手动调用 \`wdyy-bug-record\`，追加写入 \`docs/bug_record.md\` |
-| 结构化日志、traceId、脱敏、前端异常上报 | \`wdyy-logging-standard\` |
-| Linux 发布、Docker 蓝绿、Nginx 切流、回滚 | \`wdyy-deployment-standard\` |
+| 结构化日志、traceId、完整原始入参、前端异常上报 | \`wdyy-logging-standard\` |
+| Linux 发布、带版本双镜像、人工上传、直接端口与服务器菜单 | \`wdyy-deployment-standard\` |
 
 ## 通用边界
 
 - 项目根目录应提供真实可执行的 \`pnpm dev\`、\`pnpm build\`、\`pnpm test\`、\`pnpm lint\` 命令；\`pnpm dev\` 只负责前后端的启动，不得启动或管理数据库。
 - 代码、配置、迁移、测试与部署文件必须以实际实现为准；不得用模板虚构已实现能力。
 - 所有需求（如数据库变更、流程变更、功能变更、从零开发项目等），必须先使用\`openspec-explore\`技能确认需求，再根据实际情况，使用\`openspec\`的其它技能。
+- 所有项目管理的日志必须直接写入项目根目录 \`logs/\`，不得通过环境变量改写目录或创建服务、实例、日期等日志子目录。
 - 不得静默吞错、跳过验证、以兜底逻辑掩盖未决问题。
 `;
 

package/package.json

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

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

@@ -1,70 +0,0 @@
-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_IMAGE:?BACKEND_IMAGE is required}
-    env_file: ../../.env
-    environment:
-      INSTANCE_ID: blue
-      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:
-      - "${DOCKER_BIND_IP}:${FRONTEND_GREEN_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-green:
-    image: ${BACKEND_IMAGE:?BACKEND_IMAGE is required}
-    env_file: ../../.env
-    environment:
-      INSTANCE_ID: green
-      HOST: ${BACKEND_URL}
-      PORT: ${BACKEND_PORT}
-    ports:
-      - "${DOCKER_BIND_IP}:${BACKEND_GREEN_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

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

@@ -1,25 +0,0 @@
-# wdyy-project: __PROJECT_NAME__
-# wdyy-port: __PROJECT_HTTP_PORT__
-include "__DEPLOY_ROOT__/nginx/active-upstreams.conf";
-
-server {
-  listen __PROJECT_HTTP_PORT__;
-  server_name _;
-
-  location /api/ {
-    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 / {
-    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;
-  }
-}