@wdyy/skills 0.1.3 → 0.1.5

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

@@ -13,7 +13,7 @@
     {
       "name": "wdyy-api-standard",
       "description": "根据“获取XX数据”“使用XX接口”等具体需求，定位已登记的接口 reference，并按已确认的接口契约将调用方式写入程序。Use when 需要查询或实现一个已登记接口的数据调用时。",
-      "files": ["SKILL.md", "agents/openai.yaml", "reference/api-根据就诊号获取检验数据.md"]
+      "files": ["SKILL.md", "agents/openai.yaml", "reference/api-demo.md", "reference/api-sms.md"]
     },
     {
       "name": "wdyy-bug-record",
@@ -22,7 +22,7 @@
     },
     {
       "name": "wdyy-logging-standard",
-      "description": "为 NestJS 和 Vue 项目实现前端异常上报、后端统一结构化 JSON 日志、蓝绿实例隔离、traceId 传递、敏感信息脱敏与 2MB 文件轮转。Use when 编写日志、错误处理、前端异常上报或审查生产可观测性时。",
+      "description": "为 NestJS 和 Vue 项目实现前端异常上报、后端统一结构化 JSON 日志、traceId 传递、完整原始入参与 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"]
     }
   ]

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

@@ -16,16 +16,17 @@ description: 根据“获取XX数据”“使用XX接口”等具体需求，定
 
 ## 路由步骤
 
-1. 根据需求中的数据名称、业务对象或接口名称，在 `reference/api-*.md` 中查找候选接口。
+1. 根据需求中的数据名称、业务对象或接口名称，在 `reference/api-*.md` 中查找候选业务接口，排除仅用于说明格式的 `api-demo.md`。
 2. 仅在唯一匹配时读取该 reference，使用其中的接口 URL、JSON 入参和 JSON 返回值编写调用方式。
 3. 按 reference 的“备注”实现特殊调用要求。
 4. 若没有匹配接口、存在多个候选接口，或 URL、入参、返回值不完整，先要求补充或确认接口信息；不得编造调用细节。
 
 ## 接口文档约定
 
+- `reference/api-demo.md` 仅说明接口文档格式，不得作为业务调用依据；其中可使用 `XXX` 等占位内容。
 - 一个接口对应一个 `reference/api-接口名称.md` 文件。
 - 文件名去除 `.md` 后必须与“接口名称”字段一致。
-- 每个接口文档必须按以下顺序包含六个一级标题：
+- 每个业务接口文档必须按以下顺序包含六个一级标题：
 
 ```md
 # 接口名称：api-xxx

package/.well-known/skills/wdyy-api-standard/reference/{api-/346/240/271/346/215/256/345/260/261/350/257/212/345/217/267/350/216/267/345/217/226/346/243/200/351/252/214/346/225/260/346/215/256.md → api-demo.md}

@@ -1,8 +1,10 @@
-# 接口名称：api-根据就诊号获取检验数据
+# 模板示例
 
-# 接口用途：根据就诊号获取检验数据
+# 接口名称：api-demo
 
-# 接口URL：http://172.26.1.64:8996/api/execute/getLabInfoByVisitId
+# 接口用途：XXX
+
+# 接口URL：XXX
 
 # 入参格式：JSON
 

package/.well-known/skills/wdyy-api-standard/reference/api-sms.md

@@ -0,0 +1,67 @@
+# 接口名称：api-sms
+
+# 接口用途：向一个或多个手机号发送相同的短信内容
+
+# 接口URL：http://172.26.1.80:8998/api/sms/send
+
+`POST` 请求，`Content-Type` 为 `application/json; charset=utf-8`。当前地址为内网默认地址；生产或测试环境地址如有差异，以部署方提供的地址为准。
+
+# 入参格式：JSON
+
+```json
+{
+  "mobiles": [
+    "13800000001",
+    "13800000002"
+  ],
+  "content": "【系统通知】您的验证码是1234"
+}
+```
+
+- `mobiles`：必填，`array[string]`，接收短信的手机号列表；单次最多 200 个手机号。
+- `content`：必填，`string`，短信正文内容。
+- 接入方不传入 token、`userCode` 或 `token` 等短信网关凭证。
+
+# 返回值：JSON
+
+成功提交至短信网关时返回 HTTP `200`：
+
+```json
+{
+  "msgId": "2601291081805244415"
+}
+```
+
+`msgId` 为短信网关消息流水号，表示请求已提交至网关，不表示短信已最终送达。
+
+失败或被拦截时返回 `error` 字段。手机号列表为空或短信内容为空时返回 HTTP `400`：
+
+```json
+{
+  "error": "Error: Mobile number array cannot be empty."
+}
+```
+
+```json
+{
+  "error": "Error: Content cannot be empty."
+}
+```
+
+触发发送限流时返回 HTTP `429`：
+
+```json
+{
+  "error": "Too many requests: 手机号138****0001获取短信过于频繁，请稍后再试"
+}
+```
+
+短信网关拒绝或返回异常时，接口仍可能返回 HTTP `200`：
+
+```json
+{
+  "error": "-41"
+}
+```
+
+# 备注：使用 `POST` 请求调用；响应体存在 `msgId` 才表示提交成功，存在 `error` 表示发送失败或被拦截，不能只根据 HTTP 状态码判断成功。调用方应避免在日志中完整输出手机号、短信内容及验证码。调用前确认短信签名与模板已报备，并遵守单次最多 200 个手机号、单 IP 每分钟最多 120 次、单手机号每分钟最多 3 次的限流规则。

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

@@ -1,13 +1,13 @@
 ---
 name: wdyy-logging-standard
-description: 为 NestJS 和 Vue 项目实现前端异常上报、后端统一结构化 JSON 日志、蓝绿实例隔离、traceId 传递、敏感信息脱敏与 2MB 文件轮转。Use when 编写日志、错误处理、前端异常上报或审查生产可观测性时。
+description: 为 NestJS 和 Vue 项目实现前端异常上报、后端统一结构化 JSON 日志、traceId 传递、完整原始入参与 2MB 文件轮转。Use when 编写日志、错误处理、接口日志或审查生产可观测性时。
 ---
 
 # 企业日志规范
 
 ## Overview
 
-建立可追踪、脱敏、可轮转的结构化日志，以支撑运行时排障而不泄露敏感信息。
+建立可追踪、可轮转的结构化日志，以支撑运行时排障并保留完整原始上下文。
 
 ## When to Use
 
@@ -15,51 +15,47 @@ description: 为 NestJS 和 Vue 项目实现前端异常上报、后端统一结
 
 ## 协作边界
 
-日志实现必须纳入可观测性、实现计划和测试验证。本 skill 独立规定企业字段与隐私边界，不能降低 RED 指标、追踪或告警要求。
+日志实现必须纳入可观测性、实现计划和测试验证，不能降低 RED 指标、追踪或告警要求。
 
 ## 输入与输出
 
-- 输入：服务名、实例标识、环境、请求上下文、敏感字段清单、`LOG_DIR`。
-- 输出：统一 logger、前端异常上报客户端、HTTP 日志中间件、脱敏规则和日志验证结果。
+- 输入：服务名、实例标识、环境、请求上下文、`LOG_DIR`。
+- 输出：统一 logger、前端异常上报客户端、HTTP 日志中间件、日志文件命名规则和日志验证结果。
 - 使用 [日志规则](reference/logging-rules.md) 和 [logger 模板](templates/logger.template.ts)。
 
 ## 执行步骤
 
-1. 定义 `timestamp`、`level`、`service`、`instanceId`、`env`、`traceId`、`userId`、`method`、`path`、`query`、`body`、`statusCode`、`result`、`durationMs`、`errorCode`、`message`、`params` 的最小 JSON 契约。`timestamp` 必须为服务器本地时间 `YYYY-MM-DD HH:mm:ss`，精确到秒。
+1. 定义 `timestamp`、`level`、`service`、`instanceId`、`env`、`traceId`、`userId`、`method`、`path`、`query`、`body`、`response`、`statusCode`、`result`、`durationMs`、`errorCode`、`message`、`params` 的最小 JSON 契约。`timestamp` 必须为服务器本地时间 `YYYY-MM-DD HH:mm:ss`，精确到秒。
 2. 在入口生成或透传 traceId；在内部 REST 调用中继续传递。
 3. 统一封装 logger；业务代码不得直接使用 `console.log`。
-4. HTTP 请求日志记录 `query`（查询参数）和 `body`（请求体）；授权请求可记录实际用户、模式、表和权限等入参。`statusCode` 为 100–399 时 `result` 为 `success`，为 400–599 时 `result` 为 `failure`。
-5. password、token、secret、authorization、databaseUrl、idCard、bankCard 为敏感字段，必须连同键和值一起从日志中移除。数组仅保留前 500 项，超出部分追加 `[TRUNCATED N ITEMS]`；拒绝记录未裁剪的大对象。
-6. Vue 捕获未处理异常和 Promise 拒绝，裁剪、脱敏后上报后端；浏览器不得尝试写服务器文件。
-7. 后端按 `LOG_DIR/<service>/<instanceId>/yyyy-mm-dd_hh24-mm-ss.log` 写入，文件名使用服务器本地时间；历史日志不重命名。最新文件超过 2MB 时创建新文件，并测试轮转。
+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 时创建新文件，并测试轮转。
 
 ## 禁止事项
 
-- 不得记录秘密、完整敏感身份信息或未裁剪的大请求/响应对象。
 - 不得将 `message` 仅限制为 `success` 或 `error`。
 - 不得用 console 输出替代业务日志。
 
 ## Red Flags
 
-- 业务代码直接调用 console，或日志包含未脱敏的凭证、身份信息。
+- 业务代码直接调用 console，或 `body` 未保留完整原始入参。
 - 请求日志缺失 traceId、状态码或耗时。
-- 蓝绿容器共享同一日志文件，或前端异常未进入统一后端日志。
+- 同秒创建的日志文件覆盖既有文件，或前端异常未进入统一后端日志。
 
 ## Verification
 
 - [ ] 正常、异常和 HTTP 请求日志均为可解析 JSON。
 - [ ] traceId 跨入口与内部调用可追踪。
-- [ ] 敏感字段移除、数组截断、HTTP 入参与状态结果映射均有测试覆盖，轮转阈值可验证。
-- [ ] 前端异常上报经过裁剪、脱敏和后端身份校验。
-- [ ] 蓝绿实例使用独立日志目录，容器替换后日志仍保留。
+- [ ] 完整 HTTP 入参、服务端成功/失败结果映射、失败响应内容与同秒递增命名均有测试覆盖，轮转阈值可验证。
+- [ ] 前端异常上报经过后端身份校验。
+- [ ] 日志直接写入持久化挂载的 `LOG_DIR`，容器替换后日志仍保留。
 - [ ] `LOG_DIR` 缺失或不可写时服务以明确错误停止。
 
-无法确定某字段是否敏感时按敏感处理并要求数据负责人确认；不得先原样记录再补救。
-
 ## Common Rationalizations
 
 | 合理化说法 | 事实 |
 |---|---|
-| “开发日志不用脱敏” | 开发日志同样会被共享和长期保留。 |
 | “console.log 足够定位问题” | 无统一字段、轮转和 traceId 的输出不能支撑运维。 |
-| “完整请求最方便排查” | 便利不构成暴露隐私和大对象的理由。 |
+| “失败响应只记录状态码即可” | 必须记录完整失败内容，才能定位服务端返回的业务错误。 |

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

@@ -1,4 +1,4 @@
 interface:
   display_name: "Enterprise Logging Standard"
-  short_description: "Implement instance-safe logs and frontend error reporting"
-  default_prompt: "Use $wdyy-logging-standard to implement frontend error reporting and instance-isolated structured logs."
+  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."

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

@@ -1,12 +1,12 @@
 # 日志规则
 
 - 日志为一行 JSON，最小字段见 `logger.template.ts`。
+- `logger.template.ts` 必须可在未安装 `@types/node` 的项目中独立类型检查；读取环境变量时通过 `globalThis` 声明最小运行时形状，不直接依赖 Node.js 全局类型。
 - `timestamp` 使用服务器本地时间 `YYYY-MM-DD HH:mm:ss`，精确到秒；不得包含毫秒、`T` 或 `Z`。
-- 文件名使用服务器本地时间 `yyyy-mm-dd_hh24-mm-ss.log`；最新日志文件大于 2MB 时先创建新文件再写入。既有日志文件不得重命名。
-- 日志仅记录关键业务事件、请求摘要和异常；`params`、`query` 和 `body` 必须裁剪。授权请求可记录实际用户、模式、表和权限等入参。
-- HTTP 日志必须保留 `statusCode`，且 `result` 在 100–399 时为 `success`、在 400–599 时为 `failure`。
-- password、token、secret、authorization、databaseUrl、idCard、bankCard 必须从输出中完全移除，不得以占位符输出。数组保留前 500 项；超出时追加 `[TRUNCATED N ITEMS]`。
+- 文件直接写入 `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 时先创建新文件再写入，既有日志文件不得重命名或覆盖。
+- 日志仅记录关键业务事件、请求和异常；`params`、`query`、`body` 和 `response` 均保留完整原始值，不执行脱敏、数组截断或大对象裁剪。授权请求可记录实际用户、模式、表和权限等入参。
+- HTTP 日志必须保留 `statusCode`。服务端成功返回时 `result` 为 `success`；失败返回时 `result` 为 `failure`，并在 `response` 中保留完整失败内容。100–399 为成功，400–599 为失败。
 - HTTP 入口和内部服务调用必须透传 traceId。
-- 每条日志必须包含 `instanceId`；生产蓝绿容器分别写入 `LOG_DIR/<service>/<instanceId>/`，不得并发写同一文件。
-- Vue 未处理异常和 Promise 拒绝必须裁剪、脱敏后上报后端；后端校验请求身份和大小后写入统一日志。
+- 每条日志必须包含 `instanceId`；通过同秒递增后缀避免多个实例或进程覆盖同一日志文件。
+- Vue 未处理异常和 Promise 拒绝必须上报后端；后端校验请求身份后写入统一日志。
 - 日志目录必须挂载到容器外部持久路径，替换容器不得删除历史日志。

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

@@ -9,25 +9,6 @@ if (!/^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}$/.test(entry.timestamp)) {
   throw new Error('timestamp must use local YYYY-MM-DD HH:mm:ss format');
 }
 
-const sensitiveKeys = new Set([
-  'password', 'token', 'secret', 'authorization', 'databaseurl', 'idcard', 'bankcard',
-]);
-const validateValue = (value) => {
-  if (Array.isArray(value)) {
-    if (value.length > 500 && (value.length !== 501 || !/^\[TRUNCATED \d+ ITEMS\]$/.test(value.at(-1)))) {
-      throw new Error('Arrays over 500 items must end with a truncation marker');
-    }
-    value.forEach(validateValue);
-    return;
-  }
-  if (!value || typeof value !== 'object') return;
-  for (const [key, item] of Object.entries(value)) {
-    if (sensitiveKeys.has(key.toLowerCase())) throw new Error('Sensitive fields must be omitted');
-    validateValue(item);
-  }
-};
-validateValue(entry);
-
 if ('statusCode' in entry) {
   const expected = entry.statusCode >= 100 && entry.statusCode <= 399 ? 'success'
     : entry.statusCode >= 400 && entry.statusCode <= 599 ? 'failure' : undefined;

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

@@ -4,6 +4,7 @@ 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';
 
 const validator = new URL('./validate-log-entry.mjs', import.meta.url);
 const temporaryDirectories = [];
@@ -24,6 +25,15 @@ async function validate(entry) {
   return spawnSync(process.execPath, [validator.pathname, input], { encoding: 'utf8' });
 }
 
+test('同一秒日志文件使用递增后缀', () => {
+  const date = new Date(2026, 6, 28, 9, 5, 3);
+
+  assert.deepEqual(
+    [createLogFileName(date), createLogFileName(date, 1), createLogFileName(date, 2)],
+    ['2026-07-28_09-05-03.log', '2026-07-28_09-05-03_1.log', '2026-07-28_09-05-03_2.log'],
+  );
+});
+
 test('蓝绿实例日志必须包含 instanceId', async () => {
   const result = await validate({
     timestamp: '2026-07-09 08:00:00',
@@ -66,24 +76,7 @@ test('HTTP 状态码与 result 不一致时明确失败', async () => {
   assert.match(result.stderr, /result/);
 });
 
-test('每个敏感字段出现在日志中时都明确失败', async () => {
-  for (const key of ['password', 'token', 'secret', 'authorization', 'databaseUrl', 'idCard', 'bankCard']) {
-    const result = await validate({
-      timestamp: '2026-07-09 08:00:00',
-      level: 'info',
-      service: 'backend',
-      instanceId: 'blue',
-      env: 'production',
-      message: 'request completed',
-      body: { [key]: 'not-allowed' },
-    });
-
-    assert.notEqual(result.status, 0, key);
-    assert.match(result.stderr, /Sensitive/, key);
-  }
-});
-
-test('HTTP 成功结果与截断数组可通过验证', async () => {
+test('完整原始入参和成功响应可通过验证', async () => {
   const result = await validate({
     timestamp: '2026-07-09 08:00:00',
     level: 'info',
@@ -93,9 +86,11 @@ test('HTTP 成功结果与截断数组可通过验证', async () => {
     message: 'request completed',
     query: { page: '1' },
     body: {
-      user: 'operator',
-      permissions: [...Array.from({ length: 500 }, (_, index) => index), '[TRUNCATED 1 ITEMS]'],
+      password: 'unredacted',
+      idCard: '110101199001011234',
+      permissions: Array.from({ length: 501 }, (_, index) => index),
     },
+    response: { code: 'OK', message: '处理成功' },
     statusCode: 201,
     result: 'success',
   });
@@ -103,19 +98,21 @@ test('HTTP 成功结果与截断数组可通过验证', async () => {
   assert.equal(result.status, 0, result.stderr);
 });
 
-test('超过 500 项且没有截断标记时明确失败', async () => {
+test('失败响应内容和 failure 结果可通过验证', async () => {
   const result = await validate({
     timestamp: '2026-07-09 08:00:00',
     level: 'info',
     service: 'backend',
     instanceId: 'blue',
     env: 'production',
-    message: 'request completed',
-    body: { items: Array.from({ length: 501 }, (_, index) => index) },
+    message: 'request failed',
+    body: { data: 'original-request' },
+    response: { code: 'INVALID_DATA', message: '参数不合法' },
+    statusCode: 422,
+    result: 'failure',
   });
 
-  assert.notEqual(result.status, 0);
-  assert.match(result.stderr, /truncation/);
+  assert.equal(result.status, 0, result.stderr);
 });
 
 test('UTC ISO timestamp 时明确失败', async () => {

package/.well-known/skills/wdyy-logging-standard/templates/frontend-error-report.template.ts

@@ -7,16 +7,11 @@ type FrontendErrorReport = {
 };
 
 export async function reportFrontendError(report: FrontendErrorReport): Promise<void> {
-  const payload = {
-    ...report,
-    message: report.message.slice(0, 500),
-    stack: report.stack?.slice(0, 2000),
-  };
   const response = await fetch('/api/client-errors', {
     method: 'POST',
     headers: { 'Content-Type': 'application/json' },
     credentials: 'same-origin',
-    body: JSON.stringify(payload),
+    body: JSON.stringify(report),
   });
   if (!response.ok) throw new Error(`Frontend error report failed: ${response.status}`);
 }

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

@@ -6,6 +6,7 @@ export type LogContext = {
   statusCode?: number;
   query?: Record<string, unknown>;
   body?: unknown;
+  response?: unknown;
   durationMs?: number;
   errorCode?: string;
   params?: Record<string, unknown>;
@@ -21,24 +22,16 @@ export type LogEntry = LogContext & {
   result?: 'success' | 'failure';
 };
 
-const sensitiveKeys = new Set([
-  'password', 'token', 'secret', 'authorization', 'databaseurl', 'idcard', 'bankcard',
-]);
+const pad = (value: number) => String(value).padStart(2, '0');
 
-export const redact = (value: unknown): unknown => {
-  if (Array.isArray(value)) {
-    const items = value.slice(0, 500).map(redact);
-    return value.length > 500
-      ? [...items, '[TRUNCATED ' + (value.length - 500) + ' ITEMS]']
-      : items;
-  }
-  if (!value || typeof value !== 'object') return value;
-  return Object.fromEntries(Object.entries(value).flatMap(([key, item]) => (
-    sensitiveKeys.has(key.toLowerCase()) ? [] : [[key, redact(item)]]
-  )));
-};
+type RuntimeEnvironment = Record<string, string | undefined>;
 
-const pad = (value: number) => String(value).padStart(2, '0');
+const getRuntimeEnvironment = (): RuntimeEnvironment => {
+  const runtime = globalThis as typeof globalThis & {
+    process?: { env?: RuntimeEnvironment };
+  };
+  return runtime.process?.env ?? {};
+};
 
 export const formatLocalTimestamp = (date = new Date()): string => (
   [date.getFullYear(), pad(date.getMonth() + 1), pad(date.getDate())].join('-')
@@ -46,9 +39,10 @@ export const formatLocalTimestamp = (date = new Date()): string => (
   + [pad(date.getHours()), pad(date.getMinutes()), pad(date.getSeconds())].join(':')
 );
 
-export const createLogFileName = (date = new Date()): string => (
-  formatLocalTimestamp(date).replace(' ', '_').replaceAll(':', '-') + '.log'
-);
+export const createLogFileName = (date = new Date(), collisionIndex = 0): string => {
+  const baseName = formatLocalTimestamp(date).replace(' ', '_').replaceAll(':', '-');
+  return `${baseName}${collisionIndex > 0 ? `_${collisionIndex}` : ''}.log`;
+};
 
 const resultForStatusCode = (statusCode: number): LogEntry['result'] => {
   if (statusCode >= 100 && statusCode <= 399) return 'success';
@@ -57,18 +51,18 @@ const resultForStatusCode = (statusCode: number): LogEntry['result'] => {
 };
 
 export const toLogEntry = (level: LogEntry['level'], message: string, context: LogContext): LogEntry => {
-  const sanitizedContext = redact(context) as LogContext;
-  const result = sanitizedContext.statusCode === undefined
+  const environment = getRuntimeEnvironment();
+  const result = context.statusCode === undefined
     ? undefined
-    : resultForStatusCode(sanitizedContext.statusCode);
+    : resultForStatusCode(context.statusCode);
   return {
     timestamp: formatLocalTimestamp(),
     level,
-    service: process.env.SERVICE_NAME ?? 'backend',
-    instanceId: process.env.INSTANCE_ID ?? 'local',
-    env: process.env.NODE_ENV ?? 'development',
+    service: environment.SERVICE_NAME ?? 'backend',
+    instanceId: environment.INSTANCE_ID ?? 'local',
+    env: environment.NODE_ENV ?? 'development',
     message,
-    ...sanitizedContext,
+    ...context,
     ...(result ? { result } : {}),
   };
 };

package/README.md

@@ -29,7 +29,7 @@ npm install -g @wdyy/skills
 wdyy init
 ```
 
-`wdyy init` 自动执行 `openspec init`，将 5 个受管理 Skill 安装到 `.agents/skills/`，并在 `docs/bug_record.md` 创建或追加 BUG 记录模板。若目标项目已有 `AGENTS.md`，原文件保持不变，命令将生成 `AGENTS_new.md`；每次运行都会覆盖更新 `.agents/skills/wdyy-*`，但不修改同级自定义 Skill。
+`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`。
 
 ### 仅更新已安装的 Skill
 
@@ -41,9 +41,9 @@ wdyy update-skill wdyy-logging-standard
 wdyy update-skill --all
 ```
 
-`wdyy update-skill <skill-name>` 只接受 5 个受管理的 `wdyy-*` Skill，且仅替换指定目录；`--all` 替换全部 5 个受管理 Skill。两种方式都不会写入 `AGENTS.md` 或 `AGENTS_new.md`、追加 `docs/bug_record.md`，也不会执行 `openspec init`。首次初始化或需要重新生成项目规则时，使用 `wdyy init`。
+`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。配置仅从环境变量读取，不得提交秘密或生产环境 `.env`。
+中大型变更先使用 `/opsx:explore` 或 `/opsx:propose <change-name>`，在方案确认后使用 `/opsx:apply`；完成验证后使用 `/opsx:archive`。涉及数据库、内部 API、日志、部署时，按 `AGENTS.md` 的路由加载相应企业 Skill。所有 URL、端口和 IP 地址从 `.env` 读取，不得硬编码；不得提交秘密或生产环境 `.env`。项目完成后创建 `README.md`，说明技术栈、目录结构和安装部署。
 
 ## 固定技术栈
 

package/lib/wdyy-cli.js

@@ -1,5 +1,6 @@
 import { spawnSync } from 'node:child_process';
 import { access, appendFile, cp, mkdir, mkdtemp, readFile, rename, rm, writeFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
 import { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
@@ -12,6 +13,29 @@ const managedSkillNames = [
   'wdyy-deployment-standard'
 ];
 
+const defaultProjectDirectories = [
+  'src/frontend',
+  'src/backend',
+  'database',
+  'deploy',
+  'docs',
+  'scripts',
+  'tests'
+];
+
+const requiredGitIgnoreEntries = [
+  '.env',
+  'node_modules/',
+  'venv/',
+  '.pnpm-store/',
+  'logs/',
+  'dist/',
+  '.DS_Store',
+  '*.tar.gz'
+];
+
+const defaultProjectLayout = [...defaultProjectDirectories, '.env.example'];
+
 const generatedAgentsContent = `# 企业开发规则
 
 本项目同时使用OpenSpec及企业 Skill统一开发规则及流程。
@@ -23,9 +47,11 @@ const generatedAgentsContent = `# 企业开发规则
 - 后端：NestJS。
 - 数据库：PostgreSQL 18。
 
-默认项目目录为 \`src/frontend\`、\`src/backend\`、\`database\`、\`deploy\`、\`docs\`、\`scripts\`、\`tests\`、\`.env.example\`。
+默认项目目录为 ${defaultProjectLayout.map((path) => `\`${path}\``).join('、')}。
 
-配置仅从环境变量读取；不得提交秘密或生产环境 \`.env\`。
+所有 URL、端口和 IP 地址必须从 \`.env\` 文件读取，禁止在代码中硬编码；不得提交秘密或生产环境 \`.env\`。
+
+项目开发完成后必须创建 \`README.md\`，内容包括项目技术栈、目录结构和安装部署说明。
 
 ## Skill 路由
 
@@ -54,8 +80,7 @@ function printHelp() {
   console.log('仅更新当前项目的一个或全部受管理 wdyy Skill，不执行项目初始化。');
 }
 
-async function installManagedSkills(targetRoot, writtenPaths, skillNames = managedSkillNames) {
-  const skillsRoot = join(targetRoot, '.agents', 'skills');
+async function installManagedSkills(skillsRoot, writtenPaths, skillNames = managedSkillNames) {
   await mkdir(skillsRoot, { recursive: true });
   const temporaryRoot = await mkdtemp(join(skillsRoot, '.wdyy-skills-'));
 
@@ -78,6 +103,72 @@ async function installManagedSkills(targetRoot, writtenPaths, skillNames = manag
   }
 }
 
+function getGlobalSkillsRoot() {
+  return join(homedir(), '.agents', 'skills');
+}
+
+function printWrittenPaths(writtenPaths) {
+  if (writtenPaths.length > 0) console.error(`已写入路径:\n${writtenPaths.map((path) => `- ${path}`).join('\n')}`);
+}
+
+function initializeGit(targetRoot, writtenPaths) {
+  const result = spawnSync('git', ['init'], { cwd: targetRoot, stdio: 'inherit' });
+  if (result.error || result.status !== 0) {
+    const detail = result.error?.message ?? `退出码 ${result.status ?? 1}`;
+    console.error(`Git 初始化失败: ${detail}`);
+    printWrittenPaths(writtenPaths);
+    return result.status ?? 1;
+  }
+
+  writtenPaths.push(join(targetRoot, '.git'));
+  console.log('Git 初始化完成。');
+  return 0;
+}
+
+async function appendGitIgnoreEntries(targetRoot, writtenPaths) {
+  const gitIgnorePath = join(targetRoot, '.gitignore');
+  let existing = '';
+  try {
+    existing = await readFile(gitIgnorePath, 'utf8');
+  } catch (error) {
+    if (error.code !== 'ENOENT') throw error;
+  }
+
+  const existingEntries = new Set(existing.split(/\r?\n/).map((entry) => entry.trim()).filter(Boolean));
+  const missingEntries = requiredGitIgnoreEntries.filter((entry) => !existingEntries.has(entry));
+  if (missingEntries.length === 0 && existing.length > 0) return;
+
+  const prefix = existing.length === 0 ? '' : existing.endsWith('\n') ? '' : '\n';
+  await appendFile(gitIgnorePath, `${prefix}${missingEntries.join('\n')}\n`, 'utf8');
+  writtenPaths.push(gitIgnorePath);
+  console.log(`已更新 Git 忽略规则: ${gitIgnorePath}`);
+}
+
+async function createDefaultProjectLayout(targetRoot, writtenPaths) {
+  for (const directory of defaultProjectDirectories) {
+    const destination = join(targetRoot, directory);
+    let existed = true;
+    try {
+      await access(destination);
+    } catch (error) {
+      if (error.code !== 'ENOENT') throw error;
+      existed = false;
+    }
+    await mkdir(destination, { recursive: true });
+    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);
+  }
+  console.log(`已准备默认项目目录: ${defaultProjectDirectories.join('、')}`);
+}
+
 async function writeAgentsFile(targetRoot, writtenPaths) {
   const agentsPath = join(targetRoot, 'AGENTS.md');
   let destination = agentsPath;
@@ -115,7 +206,7 @@ function initializeOpenSpec(targetRoot, writtenPaths) {
   if (result.error || result.status !== 0) {
     const detail = result.error?.message ?? `退出码 ${result.status ?? 1}`;
     console.error(`OpenSpec 初始化失败: ${detail}`);
-    console.error(`已写入路径:\n${writtenPaths.map((path) => `- ${path}`).join('\n')}`);
+    printWrittenPaths(writtenPaths);
     return result.status ?? 1;
   }
 
@@ -127,8 +218,12 @@ export async function run(argumentsList) {
   if (argumentsList.length === 1 && argumentsList[0] === 'init') {
     const writtenPaths = [];
     try {
+      const gitExitCode = initializeGit(process.cwd(), writtenPaths);
+      if (gitExitCode !== 0) return gitExitCode;
       await writeAgentsFile(process.cwd(), writtenPaths);
-      await installManagedSkills(process.cwd(), writtenPaths);
+      await installManagedSkills(getGlobalSkillsRoot(), writtenPaths);
+      await appendGitIgnoreEntries(process.cwd(), writtenPaths);
+      await createDefaultProjectLayout(process.cwd(), writtenPaths);
       await appendBugRecordTemplate(process.cwd(), writtenPaths);
       const openSpecExitCode = initializeOpenSpec(process.cwd(), writtenPaths);
       if (openSpecExitCode !== 0) return openSpecExitCode;
@@ -136,7 +231,7 @@ export async function run(argumentsList) {
       return 0;
     } catch (error) {
       console.error(`wdyy 初始化失败: ${error.message}`);
-      if (writtenPaths.length > 0) console.error(`已写入路径:\n${writtenPaths.map((path) => `- ${path}`).join('\n')}`);
+      printWrittenPaths(writtenPaths);
       return 1;
     }
   }
@@ -156,11 +251,11 @@ export async function run(argumentsList) {
 
     const writtenPaths = [];
     try {
-      await installManagedSkills(process.cwd(), writtenPaths, skillNames);
+      await installManagedSkills(getGlobalSkillsRoot(), writtenPaths, skillNames);
       return 0;
     } catch (error) {
       console.error(`Skill 更新失败: ${error.message}`);
-      if (writtenPaths.length > 0) console.error(`已写入路径:\n${writtenPaths.map((path) => `- ${path}`).join('\n')}`);
+      printWrittenPaths(writtenPaths);
       return 1;
     }
   }

package/package.json

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