@wdyy/skills 0.1.27 → 0.1.30

package/.well-known/skills/index.json

@@ -2,7 +2,7 @@
   "skills": [
     {
       "name": "wdyy-database-standard",
-      "description": "将已确认的 PRD 与 DDL 转为原则上符合第三范式（3NF）的 PostgreSQL 18 无外键逻辑关联设计；反范式例外须记录依据与一致性策略并经人工确认。约束业务域表名前缀、自增主键 {前缀}_id、统一状态字段 {前缀}_status、timestamp(0) 时间类型、字段可空策略、注释、幂等、审计与向前兼容。Use when 审查 DDL、设计表结构、建立 V001 基线、增加后续迁移或验证生产数据库兼容性时。",
+      "description": "将已确认的 PRD 与 DDL 转为原则上符合第三范式（3NF）的 PostgreSQL 18 无外键逻辑关联设计；反范式例外须记录依据与一致性策略并经人工确认。约束业务域表名前缀、自增主键 {前缀}_id、统一状态字段 {前缀}_status、timestamptz(0) 时间类型与 Asia/Shanghai 默认时区、字段可空策略、注释、幂等、审计与向前兼容。Use when 审查 DDL、设计表结构、建立 V001 基线、增加后续迁移或验证生产数据库兼容性时。",
       "files": ["SKILL.md", "agents/openai.yaml", "reference/database-rules.md", "scripts/apply-migrations.sh", "scripts/apply-migrations.test.mjs", "scripts/validate-migration-layout.mjs", "scripts/validate-migration-layout.test.mjs", "scripts/validate-table-design.mjs", "scripts/validate-table-design.test.mjs", "templates/table-design.template.md"]
     },
     {
@@ -17,13 +17,18 @@
     },
     {
       "name": "wdyy-logging-standard",
-      "description": "为 NestJS 和 Vue 项目实现固定写入项目根目录 ./logs 的访问、应用、安全与审计 JSON 日志，记录来源 IP、时间、业务功能、操作主体与结果，并提供 W3C trace、敏感字段净化、前端异常上报、2MB 轮转、哈希链及可执行校验。Use when 编写或审查日志、错误处理、请求追踪、安全访问记录、安全事件、审计溯源及生产可观测性时。",
-      "files": ["SKILL.md", "agents/openai.yaml", "reference/logging-rules.md", "scripts/validate-log-entry.mjs", "scripts/validate-log-entry.test.mjs", "templates/frontend-error-report.template.ts", "templates/logger.template.ts", "templates/nestjs-http-logging.middleware.template.ts", "templates/security-audit-logger.template.ts"]
+      "description": "为 NestJS 和 Vue 项目基于 Pino 生态实现固定写入项目根目录 ./logs 的请求、响应、操作审计与安全 JSON 日志，通过 nestjs-pino 与 pino-http 记录 HTTP 请求/响应，使用 pino-roll 2MB 轮转，并提供 W3C trace、敏感字段净化、前端异常上报与哈希链校验。Use when 编写或审查日志、错误处理、请求追踪、安全访问记录、安全事件、审计溯源及生产可观测性时。",
+      "files": ["SKILL.md", "agents/openai.yaml", "reference/logging-rules.md", "scripts/validate-log-entry.mjs", "scripts/validate-log-entry.test.mjs", "templates/frontend-error-report.template.ts", "templates/logger.template.ts", "templates/pino-logger.template.ts", "templates/nestjs-http-logging.middleware.template.ts", "templates/security-audit-logger.template.ts"]
     },
     {
       "name": "wdyy-ui",
       "description": "统一医院信息系统前端页面的布局、清新生命绿配色、医院 Logo、常用组件和响应式行为。Use when 新建、改造或审查患者管理、药事管理、医生工作站及相近 HIS 页面时；不负责定义业务流程、接口或数据模型。",
       "files": ["SKILL.md", "agents/openai.yaml", "references/ui-standard.md", "assets/template/common-business.html", "assets/template/pharmacy-management.html", "assets/template/clinical-workstation.html", "assets/template/styles.css", "assets/template/logo.png"]
+    },
+    {
+      "name": "wdyy-safety-review",
+      "description": "对整个软件执行证据驱动的安全审核并生成四列 Markdown 检查清单。Use when 审查或设计身份认证与权限、Web/API、文件上传下载、敏感数据、源码与依赖、安全日志、漏洞扫描或漏洞验证；即使用户只说“安全检查”“代码安全”“接口安全”“扫描漏洞”也应使用本 Skill。",
+      "files": ["SKILL.md", "agents/openai.yaml", "references/security-review-rules.md", "templates/security-checklist.template.md", "scripts/validate-security-checklist.mjs", "scripts/validate-security-checklist.test.mjs"]
     }
   ]
 }

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

@@ -1,6 +1,6 @@
 ---
 name: wdyy-database-standard
-description: 将已确认的 PRD 与 DDL 转为原则上符合第三范式（3NF）的 PostgreSQL 18 无外键逻辑关联设计；反范式例外须记录依据与一致性策略并经人工确认。约束业务域表名前缀、自增主键 {前缀}_id、统一状态字段 {前缀}_status、timestamp(0) 时间类型、字段可空策略、注释、幂等、审计与向前兼容。Use when 审查 DDL、设计表结构、建立 V001 基线、增加后续迁移或验证生产数据库兼容性时。
+description: 将已确认的 PRD 与 DDL 转为原则上符合第三范式（3NF）的 PostgreSQL 18 无外键逻辑关联设计；反范式例外须记录依据与一致性策略并经人工确认。约束业务域表名前缀、自增主键 {前缀}_id、统一状态字段 {前缀}_status、timestamptz(0) 时间类型与 Asia/Shanghai 默认时区、字段可空策略、注释、幂等、审计与向前兼容。Use when 审查 DDL、设计表结构、建立 V001 基线、增加后续迁移或验证生产数据库兼容性时。
 ---
 
 # 企业数据库规范
@@ -27,7 +27,7 @@ description: 将已确认的 PRD 与 DDL 转为原则上符合第三范式（3NF
 
 1. 确认 PRD 与 DDL 已通过就绪检查，识别实体、聚合关系、状态机、唯一约束、幂等键和审计责任人。
 2. 为每个表评估第三范式（3NF），识别重复数据、部分依赖和传递依赖，并在表设计说明中记录结论。确需反范式设计时，先记录业务或性能依据、冗余数据权威来源、一致性维护策略、影响和验证方案；未取得工程师明确人工确认前，不得生成或执行相关 DDL。
-3. 为每个表设计小写下划线名称，表名必须添加业务域英文简写前缀（见业务域前缀映射表）；若业务实体无对应前缀，须提示用户并给出建议，不得自行决定。首字段固定为 `{业务域前缀}_id`，类型使用自增主键，不得使用 `uuid`；所有时间类型字段统一使用 `timestamp(0)`；统一状态字段 `{业务域前缀}_status`（varchar(1)，默认空值，仅使用 `e` 表示启用、`d` 表示停用）。除 `created_at`、`updated_at` 和主键外，所有字段默认允许空值，`deleted_flag` 默认为空。
+3. 为每个表设计小写下划线名称，表名必须添加业务域英文简写前缀（见业务域前缀映射表）；若业务实体无对应前缀，须提示用户并给出建议，不得自行决定。首字段固定为 `{业务域前缀}_id`，类型使用自增主键，不得使用 `uuid`；所有时间类型字段统一使用 `timestamptz(0)`；业务数据库默认会话时区固定为 `Asia/Shanghai`，在创建或运维配置阶段显式设置并以 `SHOW TimeZone` 核查；统一状态字段 `{业务域前缀}_status`（varchar(1)，默认空值，仅使用 `e` 表示启用、`d` 表示停用）。除 `created_at`、`updated_at` 和主键外，所有字段默认允许空值，`deleted_flag` 默认为空。
 4. 建立逻辑关联和必要索引，不创建数据库外键；明确每个枚举、默认值和字段业务含义。
 5. 为每张表编写表注释，为每个字段编写字段注释；迁移 SQL 必须包含 `COMMENT ON TABLE` 与 `COMMENT ON COLUMN`。
 6. 新项目将工程师确认的完整 DDL 固化为 `database/migrations/V001__baseline.sql`；后续变更只新增连续编号的 `VNNN__lower_snake_name.sql`，不得修改已执行文件。
@@ -45,7 +45,7 @@ description: 将已确认的 PRD 与 DDL 转为原则上符合第三范式（3NF
 - 不得每次部署重复执行完整 DDL，或以大量 `IF EXISTS` 掩盖迁移状态错误。
 - 不得创建不带业务域前缀的业务表（除非确认为非业务表并已说明理由）。
 - 不得将任何字段设为 NOT NULL（主键、`created_at`、`updated_at` 除外），所有字段默认允许空值。
-- 时间类型字段不得使用 `timestamptz` 或无精度 `timestamp`，统一使用 `timestamp(0)`。
+- 时间类型字段必须使用 `timestamptz(0)`；不得使用 `timestamp(0)`、无精度 `timestamp` 或无精度 `timestamptz`，不得遗漏 `Asia/Shanghai` 默认会话时区声明。
 - 不得在未记录例外材料并取得工程师明确人工确认的情况下，生成或执行不符合 3NF 的设计 DDL。
 
 ## Red Flags
@@ -53,7 +53,7 @@ description: 将已确认的 PRD 与 DDL 转为原则上符合第三范式（3NF
 - 表使用 remark 字段、无表注释、无字段注释、物理外键或缺少固定审计字段。
 - 主键使用 `uuid`、业务键替代主键、缺少自增策略或字段名不符合 `{前缀}_id` 格式。
 - 表名缺少业务域前缀。
-- 时间类型字段使用 `timestamptz` 或无精度 `timestamp`。
+- 时间类型字段使用 `timestamp(0)`、无精度 `timestamp` 或无精度 `timestamptz`，或未声明 `Asia/Shanghai` 默认会话时区。
 - 发布迁移删除字段或改变旧字段语义。
 - 重复存储、派生字段、部分依赖或传递依赖没有 3NF 评估，或反范式例外缺少工程师确认。
 
@@ -64,7 +64,7 @@ description: 将已确认的 PRD 与 DDL 转为原则上符合第三范式（3NF
 - [ ] 首字段为 `{前缀}_id`，自增主键，未使用 uuid。
 - [ ] `{前缀}_status` 字段类型为 varchar(1)，默认空值，仅使用 `e`（启用）或 `d`（停用）。
 - [ ] 除主键、`created_at`、`updated_at` 外，所有字段默认允许空值，`deleted_flag` 默认为 NULL。
-- [ ] 所有时间类型字段均使用 `timestamp(0)`，未出现 `timestamptz`。
+- [ ] 所有时间类型字段均使用 `timestamptz(0)`；数据库默认会话时区为 `Asia/Shanghai`，并已通过 `SHOW TimeZone` 核查。
 - [ ] 每张表均记录 3NF 评估结论；反范式例外已记录理由、权威来源、一致性维护策略、影响、验证方案和工程师确认结果，未确认的例外未进入 DDL 实施。
 - [ ] 每张表的字段、类型、必填、默认值、索引、唯一约束、逻辑关联和枚举均有说明。
 - [ ] 表尾固定字段顺序符合要求，逻辑关联无外键。

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

@@ -33,7 +33,8 @@
 
 - 表名、字段名采用小写下划线，表名必须带业务域前缀（如 `pat_patient`、`enc_encounter`）。
 - 首字段为 `{业务域前缀}_id`（如 `pat_id`），类型使用自增主键，建议采用 `bigint generated by default as identity`，不得使用 `uuid`。
-- 所有时间类型字段统一使用 `timestamp(0)`，不使用 `timestamptz` 或无精度 `timestamp`。
+- 所有时间类型字段统一使用 `timestamptz(0)`；不得使用 `timestamp(0)`、无精度 `timestamp` 或无精度 `timestamptz`。
+- 业务数据库默认会话时区必须为 `Asia/Shanghai`。在数据库创建或运维配置阶段显式设置，并在迁移交付前执行 `SHOW TimeZone` 核查；不得在每张业务表迁移中隐式变更数据库级时区配置。
 - 所有字段默认允许空值（nullable），`created_at` 和 `updated_at` 除外（不可为空）。
 - `deleted_flag` 默认为空（`DEFAULT NULL`），允许空值。
 - `created_by`、`updated_by` 允许空值，不设必填约束。

package/.well-known/skills/wdyy-database-standard/scripts/validate-table-design.mjs

@@ -21,6 +21,7 @@ const required = [
   '- 影响：',
   '- 验证方案：',
   '- 反范式例外确认：',
+  '数据库默认会话时区：Asia/Shanghai',
 ];
 const missing = required.filter((text) => !content.includes(text));
 if (missing.length) throw new Error(`Missing table design requirements: ${missing.join(', ')}`);
@@ -46,9 +47,15 @@ if (/\|\s*deleted_flag\s*\|[^|\n]*\|[^|\n]*\|\s*false\s*\|/i.test(content)) {
   throw new Error('deleted_flag default must be NULL, not false');
 }
 
-// 时间类型字段不得使用 timestamptz
-if (/\btimestamptz\b/i.test(content)) {
-  throw new Error('Time fields must use timestamp(0), not timestamptz');
+// 时间类型字段必须使用 timestamptz(0)，并固定默认会话时区。
+if (/\btimestamp\s*\(\s*0\s*\)/i.test(content) || /\btimestamp\b(?!\s*\()/i.test(content)) {
+  throw new Error('Time fields must not use timestamp(0) or timestamp without precision');
+}
+if (/\btimestamptz\b(?!\s*\(\s*0\s*\))/i.test(content)) {
+  throw new Error('Time fields must not use timestamptz without (0) precision');
+}
+if (!/\btimestamptz\s*\(\s*0\s*\)/i.test(content)) {
+  throw new Error('Time fields must use timestamptz(0)');
 }
 
 // 禁止通用 remark 字段

package/.well-known/skills/wdyy-database-standard/scripts/validate-table-design.test.mjs

@@ -63,3 +63,39 @@ test('拒绝缺少反范式例外确认记录的表设计', async () => {
     },
   );
 });
+
+test('拒绝 timestamp(0) 时间字段', async () => {
+  await withDesign(
+    (content) => content.replaceAll('timestamptz(0)', 'timestamp(0)'),
+    async (designPath) => {
+      await assert.rejects(
+        execFile('node', [script.pathname, designPath]),
+        /must not use timestamp\(0\)/,
+      );
+    },
+  );
+});
+
+test('拒绝无精度 timestamptz 时间字段', async () => {
+  await withDesign(
+    (content) => content.replaceAll('timestamptz(0)', 'timestamptz'),
+    async (designPath) => {
+      await assert.rejects(
+        execFile('node', [script.pathname, designPath]),
+        /must not use timestamptz without \(0\) precision/,
+      );
+    },
+  );
+});
+
+test('拒绝缺少 Asia/Shanghai 默认会话时区声明的表设计', async () => {
+  await withDesign(
+    (content) => content.replace('数据库默认会话时区：Asia/Shanghai（交付前执行 `SHOW TimeZone` 核查）\n', ''),
+    async (designPath) => {
+      await assert.rejects(
+        execFile('node', [script.pathname, designPath]),
+        /数据库默认会话时区：Asia\/Shanghai/,
+      );
+    },
+  );
+});

package/.well-known/skills/wdyy-database-standard/templates/table-design.template.md

@@ -11,6 +11,7 @@
 - 关联表及关联键：
 - 状态流转：
 - 幂等键：
+- 数据库默认会话时区：Asia/Shanghai（交付前执行 `SHOW TimeZone` 核查）
 
 ## 3NF 评估与反范式例外确认
 
@@ -32,8 +33,8 @@
 | n-5 | `{前缀}_status` | varchar(1) | 否 | NULL | 业务状态，仅使用 e（启用）或 d（停用） | 业务状态 | |
 | n-4 | created_by | varchar(64) | 否 | NULL | 创建人 | 创建人标识 | |
 | n-3 | updated_by | varchar(64) | 否 | NULL | 更新人 | 更新人标识 | |
-| n-2 | created_at | timestamp(0) | 是 | now() | 创建时间 | 记录创建时间 | |
-| n-1 | updated_at | timestamp(0) | 是 | now() | 更新时间 | 记录最后更新时间 | |
+| n-2 | created_at | timestamptz(0) | 是 | now() | 创建时间 | 记录创建时间 | |
+| n-1 | updated_at | timestamptz(0) | 是 | now() | 更新时间 | 记录最后更新时间 | |
 | n | deleted_flag | boolean | 否 | NULL | 删除标记 | 逻辑删除标记 | |
 
 ## 注释 SQL

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

@@ -1,39 +1,41 @@
 ---
 name: wdyy-logging-standard
-description: 为 NestJS 和 Vue 项目实现固定写入项目根目录 ./logs 的访问、应用、安全与审计 JSON 日志，记录来源 IP、时间、业务功能、操作主体与结果，并提供 W3C trace、敏感字段净化、前端异常上报、2MB 轮转、哈希链及可执行校验。Use when 编写或审查日志、错误处理、请求追踪、安全访问记录、安全事件、审计溯源及生产可观测性时。
+description: 为 NestJS 和 Vue 项目基于 Pino 生态实现固定写入项目根目录 ./logs 的请求、响应、操作审计与安全 JSON 日志，通过 nestjs-pino 与 pino-http 记录 HTTP 请求/响应，使用 pino-roll 2MB 轮转，并提供 W3C trace、敏感字段净化、前端异常上报与哈希链校验。Use when 编写或审查日志、错误处理、请求追踪、安全访问记录、安全事件、审计溯源及生产可观测性时。
 ---
 
-# 企业安全日志与溯源规范
+# 企业安全日志与溯源规范（Pino）
 
 ## Overview
 
-建立可追踪、可审计、可验证完整性的结构化日志。净化秘密和敏感个人信息后，保留其余完整业务参数结构。
+使用成熟 Node.js 日志框架 Pino 建立可追踪、可审计、可验证完整性的结构化日志。净化秘密和敏感个人信息后，保留其余完整业务参数结构。
 
 ## 输入与确认项
 
 - 输入：服务名、实例标识、环境、HTTP 与业务上下文，以及经工程师确认的业务功能目录；应用从项目根目录启动。
+- 依赖（安装前须核实最新稳定版）：`pino`、`pino-http`、`nestjs-pino`、`pino-roll`；已核实版本为 `pino@10.3.1`、`pino-http@11.0.0`、`nestjs-pino@5.2.0`、`pino-roll@4.0.0`。
 - 实施前由工程师确认：项目特有敏感字段、可信代理链、业务功能编码与名称、动作、审计主体映射、留存责任人，以及外部不可变副本的平台与接入参数。
 - 未确认外部平台、地址、凭据时保持 `待确认`，不得虚构已接入、已备份或合规达标。
 
 ## 执行步骤
 
-1. 阅读 [详细日志规则](reference/logging-rules.md)，确定四类日志及事件清单。
-2. 将 [后端 logger 模板](templates/logger.template.ts) 接入统一日志模块；业务代码不得直接使用 `console.log`。
-3. 建立显式业务功能目录，再将 [NestJS HTTP 中间件模板](templates/nestjs-http-logging.middleware.template.ts) 接入入口；每个 `method + route` 必须映射稳定的功能编码、名称和动作。
+1. 阅读 [详细日志规则](reference/logging-rules.md)，确定 `request`、`response`、`security`、`audit` 四类日志及事件清单。
+2. 使用 [Pino logger 模板](templates/pino-logger.template.ts) 创建统一日志流：先以 `0700` 预创建 `./logs`，再用 `pino.transport` 接入 `pino-roll`，并在写入前经过哈希链 Transform；业务代码不得直接使用 `console.log`。
+3. 建立显式业务功能目录，再将 [nestjs-pino 集成模板](templates/nestjs-http-logging.middleware.template.ts) 接入入口；`pino-http` 的 `req`/`res` 日志分别映射为 `request`/`response`，每个 `method + route` 必须映射稳定的功能编码、名称和动作。
 4. 将 [安全审计模板](templates/security-audit-logger.template.ts) 接入认证、授权、权限变更、敏感数据导出和配置变更路径。
-5. 将 [前端异常模板](templates/frontend-error-report.template.ts) 接入 Axios、未处理异常和 Promise 拒绝。
+5. 将 [前端异常模板](templates/frontend-error-report.template.ts) 接入 Axios、未处理异常和 Promise 拒绝；前端不使用 Pino。
 6. 写盘或上报前统一递归净化；必须删除凭据、令牌、Cookie、连接串、身份证件、银行卡、病历与健康数据字段，项目确认的附加字段一并删除。
 7. 进入本 Skill 目录，执行 `node --test scripts/validate-log-entry.test.mjs`，再运行目标项目的完整测试。
 
 ## 核心合同
 
-- `logType` 仅为 `access`、`application`、`security`、`audit`。
+- `logType` 仅为 `request`、`response`、`security`、`audit`；`access` 与 `application` 已废弃并会被校验器拒绝。
 - 通用字段包含 `timestamp`、`timestampEpochMs`、`timezone: +08:00`、`level`、`service`、`instanceId`、`env`、`logType`、`message`。
-- 访问日志还必须包含 `traceId`、`method`、`route`、`sourceIp`、`actorId`、`actorType`、`functionCode`、`functionName`、`action`、`statusCode`、`result`、`durationMs`。
+- `request` 日志还必须包含 `traceId`、`spanId`、`method`、`route`、`sourceIp`、`actorId`、`actorType`、`functionCode`、`functionName`、`action` 及净化后的 `query`、`body`。
+- `response` 日志还必须包含同一 `traceId`、`method`、`route`、`statusCode`、`result`、`durationMs`；100–399 映射 `success`，400–599 映射 `failure`。
 - 未认证请求使用 `actorId: anonymous` 与 `actorType: anonymous`；已认证主体仅记录不含直接身份信息的内部标识。
 - 安全与审计日志还必须包含事件、主体、动作、对象和结果；失败事件必须包含原因。请求触发时还必须包含同一 `traceId`、有效 `sourceIp`、`route`、`functionCode` 和 `functionName`。
 - 使用 W3C `traceparent`，兼容 `x-trace-id`；无效或全零上游值必须替换，不能阻断请求。
-- 仅写项目根目录 `./logs`，目录权限 `0700`、文件权限 `0600`，排他创建、串行追加、单文件 2MB 轮转并记录哈希链。
+- 仅写项目根目录 `./logs`，目录权限 `0700` 且必须预先创建，文件权限 `0600`；单文件 2MB 轮转，文件名遵循 `filename.date.count.log`，禁止自动删除、移动或覆盖历史日志；每条落盘记录包含 `chainId`、`sequence`、`previousHash`、`entryHash`。
 
 ## 禁止事项
 
@@ -41,12 +43,13 @@ description: 为 NestJS 和 Vue 项目实现固定写入项目根目录 ./logs
 - 不得记录带查询串的原始 URL，不得按服务、日期或类型创建日志子目录。
 - 不得用 `unknown`、原始 URL、控制器名或猜测值代替有效来源 IP 及显式业务功能映射。
 - 不得以裁剪全部请求体代替字段级净化，也不得以“完整原始入参”为由绕过净化。
-- 日志初始化或写入失败必须显式失败，不得静默吞错。
+- 日志初始化或写入失败必须显式失败，不得降级到 console 或静默吞错。
 
 ## Verification
 
-- [ ] 四类日志必填字段、成功失败映射与失败原因均有行为测试；未知功能、无效 IP 和不完整主体会显式失败。
+- [ ] 四类日志必填字段、成功失败映射与失败原因均有行为测试；旧类别、未知功能、无效 IP 和不完整主体会显式失败。
 - [ ] 净化后保留非敏感业务结构，校验器拒绝任何绕过净化的禁止字段。
 - [ ] trace 可跨前后端和内部调用延续，无效输入被安全替换。
-- [ ] 真实写盘权限、同秒并发、2MB 轮转、单行 JSON 与哈希链篡改检测通过。
+- [ ] 请求与响应日志共享同一 trace 与业务功能上下文；哈希链篡改检测通过。
+- [ ] `pino-roll` 存储选项固定 2MB、`0600`、仅追加且禁止删除历史日志；`./logs` 以 `0700` 预创建。
 - [ ] 网络安全相关日志至少留存六个月；备份、访问审计、容量告警和外部不可变副本有经确认的生产证据。

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

@@ -1,4 +1,4 @@
 interface:
   display_name: "wdyy-logging-standard"
   short_description: "Record IP, time, business function, trace, and audit logs"
-  default_prompt: "Use $wdyy-logging-standard to implement secure access, application, security, and audit logs with explicit business-function mapping, actor and source-IP validation, trace propagation, and behavioral verification."
+  default_prompt: "Use $wdyy-logging-standard to implement Pino-based request, response, security, and audit logs with explicit business-function mapping, actor and source-IP validation, trace propagation, 2MB pino-roll rotation, and behavioral verification."

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

@@ -1,4 +1,11 @@
-# 日志详细规则
+# 日志详细规则（Pino）
+
+## 框架与依赖
+
+- 后端统一使用 `nestjs-pino` 接入 Pino：`pino-http` 的 `req` 日志映射为 `request`，`res` 日志映射为 `response`，二者由同一条 HTTP 日志链路产生并共享 trace 与业务功能上下文。
+- 落盘与轮转使用 `pino-roll`：通过 `pino.transport` 创建，单文件达到 2MB 轮转，文件名遵循 `filename.date.count.log`。
+- 安装前必须从官方渠道核实最新稳定版本；若版本不兼容或存在未修复高危漏洞，停止安装并报告，不得擅自降级或添加豁免。
+- 前端 Vue 不使用 Pino，继续使用本 Skill 的前端异常上报模板。
 
 ## 分类与字段
 
@@ -6,11 +13,13 @@
 
 | 类型 | 用途 | 关键字段 |
 |---|---|---|
-| `access` | HTTP 安全访问与性能追踪 | traceId、method、route、sourceIp、actorId、actorType、functionCode、functionName、action、statusCode、result、durationMs |
-| `application` | 业务状态、集成调用与异常 | traceId（有调用链时）、errorCode、params、body、response |
+| `request` | HTTP 请求安全访问记录 | traceId、spanId、method、route、sourceIp、actorId、actorType、functionCode、functionName、action、query、body |
+| `response` | HTTP 响应与性能追踪 | traceId、method、route、statusCode、result、durationMs、response |
 | `security` | 认证、授权、攻击与策略事件 | eventId、eventType、actor、action、target、result、reason（失败时） |
 | `audit` | 管理操作和关键数据变更溯源 | eventId、eventType、actor、action、target、before、after、result、reason（失败时） |
 
+`access` 与 `application` 已废弃：业务/集成/HTTP 异常归入 `response` 并携带 `errorCode` 与净化上下文；非 HTTP 关键事件按语义归入 `security` 或 `audit`。
+
 安全事件至少覆盖：登录成功/失败、访问拒绝、权限或角色变更、账户锁定/解锁、敏感数据查询或导出、日志访问、审计配置变更和完整性校验失败。审计事件至少覆盖关键业务新增、修改、删除、状态流转及管理配置变更。
 
 ## 安全访问记录
@@ -19,7 +28,7 @@
 - 功能信息必须来自工程师维护的显式目录，以 `method + route` 精确映射；不得从原始 URL、控制器名或日志组件推断。未登记、重复或格式错误的映射必须显式失败。
 - `actorId` 只记录内部不透明标识，`actorType` 记录主体类别。未认证请求固定记录 `anonymous/anonymous`，不得使用姓名、身份证号、工号等直接身份信息，也不得虚构用户。
 - `sourceIp` 必须是有效 IPv4 或 IPv6 地址。Express `request.ip` 只有在可信代理链已由工程师确认并正确配置时才可采用；不得直接信任任意 `X-Forwarded-For`，也不得写入 `unknown`。
-- 请求触发的 `security`、`audit` 事件必须沿用访问日志的 trace、IP、路由和功能上下文；后台事件不得伪造请求字段。
+- 请求触发的 `security`、`audit` 事件必须沿用请求日志的 trace、IP、路由和功能上下文；后台事件不得伪造请求字段。
 
 ## 数据安全
 
@@ -27,7 +36,7 @@
 - 固定禁止密码、认证头、Cookie、会话标识、各类 token、API/客户端密钥、私钥、数据库连接信息、身份证件、银行卡、病历号、诊断和健康数据字段；字段名匹配忽略大小写及分隔符。
 - 由工程师补充项目特有敏感字段。除被删除字段外，嵌套对象、数组与其他业务参数必须保留完整结构；不得静默截断或只保留白名单摘要。
 - `route` 只记录框架路由模板，如 `/patients/:patientId`；不得记录原始 URL、查询串或片段。客户端 IP 仅在可信代理配置已确认后读取转发头。
-- 消息中的 CR/LF 必须编码，防止伪造日志行。前端错误消息与堆栈在上报前也必须清除常见凭据。
+- 消息与文本值中的 CR/LF 必须由 JSON 序列化编码，防止伪造日志行。前端错误消息与堆栈在上报前也必须清除常见凭据。
 
 ## 追踪与时间
 
@@ -38,9 +47,9 @@
 ## 本地存储与完整性
 
 - 应用从项目根目录启动，仅可写 `./logs`，不得读取环境变量改写目录或创建子目录。
-- `./logs` 使用 `0700`，日志文件使用 `0600`。以 `wx` 排他创建 `yyyy-mm-dd_hh24-mm-ss.log`；冲突依次增加 `_1`、`_2`。
-- 单进程内串行追加；文件达到 2MB 前轮转到新文件，不移动、重命名或覆盖旧文件。
-- 每条落盘记录包含 chainId、sequence、previousHash、entryHash。校验器必须能发现内容、顺序或链路被篡改；哈希链是完整性证据，不替代外部不可变存储。
+- 初始化 logger 前必须以 `0700` 预创建 `./logs`；`pino-roll` 不得负责创建目录。日志文件以 `0600` 创建、仅追加。
+- `pino-roll` 的 `size` 固定为 `2m`，轮转文件命名遵循 `filename.date.count.log`，保留既有文件；不得启用 `limit.removeOtherLogFiles` 或有限 `limit.count` 等会删除历史日志的策略。
+- 每条落盘记录在进入 `pino-roll` 前经过哈希链 Transform，包含 `chainId`、`sequence`、`previousHash`、`entryHash`。校验器必须能发现内容、顺序或链路被篡改；哈希链是完整性证据，不替代外部不可变存储。
 - 日志目录不可创建、权限不可收紧或写入失败时，服务必须显式失败，不得降级到 console 或吞错。
 
 ## 留存与生产控制

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

@@ -1,21 +1,38 @@
 #!/usr/bin/env node
 import { createHash } from 'node:crypto';
 import { readFile } from 'node:fs/promises';
+import { basename } from 'node:path';
 import {
   assertLogEntry,
+  assertPinoRollStorageOptions,
+  assertRolledLogFileName,
   findForbiddenLogFieldPath,
 } from '../templates/logger.template.ts';
 
 const argumentsList = process.argv.slice(2);
 const storedMode = argumentsList[0] === '--stored';
-const inputPath = storedMode ? argumentsList[1] : argumentsList[0];
-
-if (!inputPath || argumentsList.length !== (storedMode ? 2 : 1)) {
-  throw new Error('Usage: validate-log-entry.mjs [--stored] <log-file>');
+const storageOptionsMode = argumentsList[0] === '--storage-options';
+let inputPath;
+if (storedMode || storageOptionsMode) {
+  if (argumentsList.length !== 2 || !argumentsList[1]) {
+    throw new Error('Usage: validate-log-entry.mjs [--stored|--storage-options] <file>');
+  }
+  inputPath = argumentsList[1];
+} else {
+  if (argumentsList.length !== 1 || !argumentsList[0] || argumentsList[0].startsWith('--')) {
+    throw new Error('Usage: validate-log-entry.mjs [--stored|--storage-options] <file>');
+  }
+  inputPath = argumentsList[0];
 }
 
 const source = await readFile(inputPath, 'utf8');
 
+if (storageOptionsMode) {
+  assertPinoRollStorageOptions(JSON.parse(source));
+  process.stdout.write('valid pino-roll storage options\n');
+  process.exit(0);
+}
+
 const validateEntry = (entry) => {
   assertLogEntry(entry);
   const forbiddenPath = findForbiddenLogFieldPath(entry);
@@ -30,6 +47,8 @@ if (!storedMode) {
   process.exit(0);
 }
 
+assertRolledLogFileName(basename(inputPath));
+
 const lines = source.split('\n').filter((line) => line !== '');
 if (lines.length === 0) throw new Error('Stored log file is empty');