@wdyy/skills 0.1.0

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

@@ -0,0 +1,24 @@
+{
+  "skills": [
+    {
+      "name": "wdyy-database-standard",
+      "description": "将已确认的 PRD 与 DDL 转为 PostgreSQL 18 无外键逻辑关联设计，约束业务域表名前缀、自增主键 {前缀}_id、统一状态字段 {前缀}_status、timestamp(0) 时间类型、字段可空策略、注释、幂等、审计与向前兼容。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", "templates/table-design.template.md"]
+    },
+    {
+      "name": "wdyy-deployment-standard",
+      "description": "为无 CI/CD 的 Linux 生产环境生成本地发布门禁、人工 SCP 交付约定、前端版本化 URL 和后端 Docker 蓝绿发布脚本。Use when 规划、实现、审查或执行手工生产部署时。",
+      "files": ["SKILL.md", "agents/openai.yaml", "reference/linux-deployment-rules.md", "scripts/validate-deployment-package.mjs", "scripts/validate-deployment-package.test.mjs", "templates/Dockerfile.template", "templates/deploy.sh.template", "templates/docker-compose.blue-green.yml", "templates/nginx-upstream.template.conf"]
+    },
+    {
+      "name": "wdyy-internal-api-standard",
+      "description": "规范企业内部 REST API 客户端的认证头、traceId、超时、受控重试、熔断、错误映射、日志和响应校验。Use when DEFINE 阶段识别接口边界、BUILD 阶段调用内部服务或 REVIEW 阶段发现散落 fetch、axios、httpClient 调用时。",
+      "files": ["SKILL.md", "agents/openai.yaml", "reference/internal-api-rules.md", "scripts/check-raw-http-calls.mjs", "templates/api-client.template.ts", "templates/api-error.template.ts", "templates/api-mock.template.ts"]
+    },
+    {
+      "name": "wdyy-logging-standard",
+      "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-database-standard/SKILL.md

@@ -0,0 +1,72 @@
+---
+name: wdyy-database-standard
+description: 将已确认的 PRD 与 DDL 转为 PostgreSQL 18 无外键逻辑关联设计，约束业务域表名前缀、自增主键 {前缀}_id、统一状态字段 {前缀}_status、timestamp(0) 时间类型、字段可空策略、注释、幂等、审计与向前兼容。Use when 审查 DDL、建立 V001 基线、增加后续迁移或验证生产数据库兼容性时。
+---
+
+# 企业数据库规范
+
+## Overview
+
+将已确认的业务实体、状态和约束转化为可审查、可追踪、可重复部署的 PostgreSQL 18 数据模型。
+
+## When to Use
+
+- 分析 PRD、新增表、编写迁移或审查数据库设计时。
+
+## 协作边界
+
+先确认业务需求、接口边界、实现计划与测试要求。本 skill 独立规定 PostgreSQL 18 的设计约束，不得替代需求澄清或迁移验证。
+
+## 输入与输出
+
+- 输入：已确认的 PRD、完整 DDL、业务术语、状态流转、接口契约、已有模式与迁移历史。
+- 输出：数据库设计说明、`V001__baseline.sql`、后续版本化迁移、功能-数据表映射初稿与评审记录。
+- 使用 [数据库规则](reference/database-rules.md) 和 [表设计模板](templates/table-design.template.md)。
+
+## 执行步骤
+
+1. 确认 PRD 与 DDL 已通过就绪检查，识别实体、聚合关系、状态机、唯一约束、幂等键和审计责任人。
+2. 为每个表设计小写下划线名称，表名必须添加业务域英文简写前缀（见业务域前缀映射表）；若业务实体无对应前缀，须提示用户并给出建议，不得自行决定。首字段固定为 `{业务域前缀}_id`，类型使用自增主键，不得使用 `uuid`；所有时间类型字段统一使用 `timestamp(0)`；统一状态字段 `{业务域前缀}_status`（varchar(32)，默认空值，取值自 `mdm_dictionary_item.item_code`）。除 `created_at`、`updated_at` 和主键外，所有字段默认允许空值，`deleted_flag` 默认为空。
+3. 建立逻辑关联和必要索引，不创建数据库外键；明确每个枚举、默认值和字段业务含义。
+4. 为每张表编写表注释，为每个字段编写字段注释；迁移 SQL 必须包含 `COMMENT ON TABLE` 与 `COMMENT ON COLUMN`。
+5. 新项目将工程师确认的完整 DDL 固化为 `database/migrations/V001__baseline.sql`；后续变更只新增连续编号的 `VNNN__lower_snake_name.sql`，不得修改已执行文件。
+6. 使用原生 `psql` 和 `schema_migrations` 记录表执行迁移；每个迁移由执行器包裹在同一事务中并记录校验值。
+7. 为接口写操作定义幂等与并发处理策略，并审查新旧后端并存、应用回滚和历史数据兼容性。
+8. 运行 `scripts/validate-table-design.mjs` 和 `scripts/validate-migration-layout.mjs`。
+
+## 禁止事项
+
+- 不得使用 `remark1`、`remark2`、`remark3` 承载未定义业务含义。
+- 不得将 `id` 设计为 `uuid`；主键必须使用自增类型，字段名为 `{业务域前缀}_id`。
+- 不得创建无表注释、无字段注释、物理外键或缺少审计字段的表。
+- 不得在一次发布中删除旧字段、改变字段语义或破坏旧接口。
+- 不得重写、重命名或删除已经执行的迁移文件。
+- 不得每次部署重复执行完整 DDL，或以大量 `IF EXISTS` 掩盖迁移状态错误。
+- 不得创建不带业务域前缀的业务表（除非确认为非业务表并已说明理由）。
+- 不得将任何字段设为 NOT NULL（主键、`created_at`、`updated_at` 除外），所有字段默认允许空值。
+- 时间类型字段不得使用 `timestamptz` 或无精度 `timestamp`，统一使用 `timestamp(0)`。
+
+## Red Flags
+
+- 表使用 remark 字段、无表注释、无字段注释、物理外键或缺少固定审计字段。
+- 主键使用 `uuid`、业务键替代主键、缺少自增策略或字段名不符合 `{前缀}_id` 格式。
+- 表名缺少业务域前缀。
+- 时间类型字段使用 `timestamptz` 或无精度 `timestamp`。
+- 发布迁移删除字段或改变旧字段语义。
+
+## Verification
+
+- [ ] 每张表均有表注释，每个字段均有字段注释，迁移 SQL 包含对应 `COMMENT ON TABLE` 与 `COMMENT ON COLUMN`。
+- [ ] 所有业务表名均带有业务域前缀，前缀来自映射表或已获得用户确认。
+- [ ] 首字段为 `{前缀}_id`，自增主键，未使用 uuid。
+- [ ] `{前缀}_status` 字段类型为 varchar(32)，默认空值，取值来源为 `mdm_dictionary_item.item_code`。
+- [ ] 除主键、`created_at`、`updated_at` 外，所有字段默认允许空值，`deleted_flag` 默认为 NULL。
+- [ ] 所有时间类型字段均使用 `timestamp(0)`，未出现 `timestamptz`。
+- [ ] 每张表的字段、类型、必填、默认值、索引、唯一约束、逻辑关联和枚举均有说明。
+- [ ] 表尾固定字段顺序符合要求，逻辑关联无外键。
+- [ ] 写路径具有幂等与状态流转测试。
+- [ ] `V001__baseline.sql` 存在，后续迁移编号连续且通过校验。
+- [ ] 迁移通过原生 `psql` 在目标 PostgreSQL 18 实例执行，`schema_migrations` 记录版本和校验值。
+- [ ] 新旧应用版本并存与回滚时数据库结构保持兼容。
+
+业务语义、关联基数或保留策略不清楚时，停止建模并回到 PRD 澄清；不得凭习惯创造字段。

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

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Enterprise Database Standard"
+  short_description: "Design PostgreSQL tables and versioned SQL migrations"
+  default_prompt: "Use $wdyy-database-standard to review the DDL and create safe versioned PostgreSQL migrations."

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

@@ -0,0 +1,65 @@
+# PostgreSQL 18 设计规则
+
+## 业务域前缀
+
+所有业务表名必须添加业务域英文简写前缀，映射如下：
+
+| 业务域 | 前缀 |
+|---|---|
+| 患者 | `pat_` |
+| 就诊 | `enc_` |
+| 医嘱 | `ord_` |
+| 病历文书 | `emr_` |
+| 药品 | `drug_` |
+| 员工 | `emp_` |
+| 部门 | `dept_` |
+| 物资耗材 | `material_` |
+| 费用 | `charge_` |
+| 结算 | `settle_` |
+| 护理记录 | `nurse_` |
+| 规则库 | `rule_` |
+| 授权与审计 | `auth_` |
+| 检验/检查报告 | `report_` |
+| 诊断 | `diag_` |
+| 手术 | `proce_` |
+| 医疗服务项目 | `medser_` |
+| 医保保险 | `insu_` |
+| 检查 | `exam_` |
+| 化验 | `lab_` |
+
+如果业务实体无法匹配上述域，必须提示用户并给出建议前缀，不得自行决定。
+
+## 表与字段命名
+
+- 表名、字段名采用小写下划线，表名必须带业务域前缀（如 `pat_patient`、`enc_encounter`）。
+- 首字段为 `{业务域前缀}_id`（如 `pat_id`），类型使用自增主键，建议采用 `bigint generated by default as identity`，不得使用 `uuid`。
+- 所有时间类型字段统一使用 `timestamp(0)`，不使用 `timestamptz` 或无精度 `timestamp`。
+- 所有字段默认允许空值（nullable），`created_at` 和 `updated_at` 除外（不可为空）。
+- `deleted_flag` 默认为空（`DEFAULT NULL`），允许空值。
+- `created_by`、`updated_by` 允许空值，不设必填约束。
+- `created_at`、`updated_at` 设为 `NOT NULL DEFAULT now()`。
+- 末尾固定字段顺序：`{前缀}_status`、`created_by`、`updated_by`、`created_at`、`updated_at`、`deleted_flag`。
+
+## 统一状态字段
+
+- 字段名 `{业务域前缀}_status`。
+- 类型 `varchar(32)`，允许空值，默认为空。
+- 状态值通过字典表 `mdm_dictionary_item.item_code` 获取。
+
+## 关联与约束
+
+- 使用逻辑关联和应用层校验，不建立外键。
+- 写接口应说明唯一约束、幂等键与状态迁移条件。
+
+## 注释
+
+- 每张表必须有表注释，每个字段必须有字段注释；迁移 SQL 必须包含 `COMMENT ON TABLE` 与 `COMMENT ON COLUMN`。
+- 每个字段必须有业务说明；禁止通用 remark 字段。
+
+## 迁移管理
+
+- 新项目完整 DDL 固化为 `database/migrations/V001__baseline.sql`；后续只新增 `VNNN__lower_snake_name.sql`。
+- 已执行迁移不可修改、重命名或删除，版本号必须连续且唯一。
+- 使用原生 `psql` 执行迁移，以 `schema_migrations` 记录版本、文件名、校验值和执行时间。
+- 迁移执行器负责事务；迁移文件不得自行执行 `BEGIN`、`COMMIT` 或修改 `schema_migrations`。
+- 发布迁移仅允许向前兼容的新增或扩展；删除字段、改变语义和破坏旧接口必须单独经历弃用流程。

package/.well-known/skills/wdyy-database-standard/scripts/apply-migrations.sh

@@ -0,0 +1,68 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+: "${DATABASE_URL:?DATABASE_URL is required}"
+MIGRATIONS_DIR="${MIGRATIONS_DIR:-database/migrations}"
+
+if command -v sha256sum >/dev/null 2>&1; then
+  checksum_command=(sha256sum)
+elif command -v shasum >/dev/null 2>&1; then
+  checksum_command=(shasum -a 256)
+else
+  echo "sha256sum or shasum is required" >&2
+  exit 1
+fi
+
+files=("$MIGRATIONS_DIR"/V[0-9][0-9][0-9]__*.sql)
+test -f "${files[0]}" || { echo "no migration files found in $MIGRATIONS_DIR" >&2; exit 1; }
+expected_version=1
+for file in "${files[@]}"; do
+  filename="${file##*/}"
+  [[ "$filename" =~ ^V([0-9]{3})__([a-z0-9]+(_[a-z0-9]+)*)\.sql$ ]] || {
+    echo "invalid migration filename: $filename" >&2
+    exit 1
+  }
+  version_number="$((10#${BASH_REMATCH[1]}))"
+  [[ "$version_number" -eq "$expected_version" ]] || {
+    printf 'expected migration V%03d, found %s\n' "$expected_version" "$filename" >&2
+    exit 1
+  }
+  if grep -Eiq '(^|[^[:alnum:]_])(BEGIN|COMMIT|ROLLBACK)[[:space:]]*;|schema_migrations' "$file"; then
+    echo "migration transaction and history are managed by the runner: $filename" >&2
+    exit 1
+  fi
+  expected_version=$((expected_version + 1))
+done
+
+psql "$DATABASE_URL" -v ON_ERROR_STOP=1 <<'SQL'
+CREATE TABLE IF NOT EXISTS schema_migrations (
+  version integer PRIMARY KEY,
+  filename text NOT NULL UNIQUE,
+  checksum text NOT NULL,
+  applied_at timestamptz NOT NULL DEFAULT now()
+);
+SQL
+
+for file in "${files[@]}"; do
+  filename="${file##*/}"
+  version="${filename:1:3}"
+  checksum="$("${checksum_command[@]}" "$file" | awk '{print $1}')"
+  applied="$(
+    psql "$DATABASE_URL" -v ON_ERROR_STOP=1 -Atc \
+      "SELECT filename || '|' || checksum FROM schema_migrations WHERE version = $((10#$version))"
+  )"
+  if [[ -n "$applied" ]]; then
+    test "$applied" = "$filename|$checksum" || {
+      echo "applied migration name or checksum changed: $filename" >&2
+      exit 1
+    }
+    continue
+  fi
+  {
+    printf 'BEGIN;\n'
+    printf '\\i %s\n' "$file"
+    printf "INSERT INTO schema_migrations(version, filename, checksum) VALUES (%d, '%s', '%s');\n" \
+      "$((10#$version))" "$filename" "$checksum"
+    printf 'COMMIT;\n'
+  } | psql "$DATABASE_URL" -v ON_ERROR_STOP=1
+done

package/.well-known/skills/wdyy-database-standard/scripts/apply-migrations.test.mjs

@@ -0,0 +1,47 @@
+import assert from 'node:assert/strict';
+import { chmod, mkdtemp, mkdir, rm, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { afterEach, test } from 'node:test';
+import { spawnSync } from 'node:child_process';
+
+const scriptDirectory = dirname(fileURLToPath(import.meta.url));
+const runner = join(scriptDirectory, 'apply-migrations.sh');
+const temporaryDirectories = [];
+
+afterEach(async () => {
+  await Promise.all(
+    temporaryDirectories.splice(0).map((directory) =>
+      rm(directory, { force: true, recursive: true }),
+    ),
+  );
+});
+
+test('执行前拒绝迁移版本断档', async () => {
+  const root = await mkdtemp(join(tmpdir(), 'apply-migrations-'));
+  temporaryDirectories.push(root);
+  const migrations = join(root, 'database', 'migrations');
+  const bin = join(root, 'bin');
+  await mkdir(migrations, { recursive: true });
+  await mkdir(bin);
+  await writeFile(join(migrations, 'V001__baseline.sql'), 'SELECT 1;\n');
+  await writeFile(join(migrations, 'V003__gap.sql'), 'SELECT 3;\n');
+  await writeFile(join(bin, 'psql'), '#!/usr/bin/env bash\nexit 0\n');
+  await writeFile(join(bin, 'sha256sum'), '#!/usr/bin/env bash\nprintf "abc  %s\\n" "$1"\n');
+  await chmod(join(bin, 'psql'), 0o755);
+  await chmod(join(bin, 'sha256sum'), 0o755);
+
+  const result = spawnSync(runner, {
+    cwd: root,
+    encoding: 'utf8',
+    env: {
+      ...process.env,
+      DATABASE_URL: 'postgresql://test',
+      PATH: `${bin}:${process.env.PATH}`,
+    },
+  });
+
+  assert.notEqual(result.status, 0);
+  assert.match(result.stderr, /expected migration V002/);
+});

package/.well-known/skills/wdyy-database-standard/scripts/validate-migration-layout.mjs

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+import { readFile, readdir } from 'node:fs/promises';
+
+const migrationDirectory = process.argv[2] ?? 'database/migrations';
+const files = (await readdir(migrationDirectory))
+  .filter((name) => name.endsWith('.sql'))
+  .sort();
+
+if (!files.includes('V001__baseline.sql')) {
+  throw new Error('V001__baseline.sql is required');
+}
+
+const parsed = files.map((name) => {
+  const match = name.match(/^V(\d{3})__([a-z0-9]+(?:_[a-z0-9]+)*)\.sql$/);
+  if (!match) throw new Error(`Invalid migration filename: ${name}`);
+  return { name, version: Number(match[1]) };
+});
+
+for (const [index, migration] of parsed.entries()) {
+  const expected = index + 1;
+  if (migration.version !== expected) {
+    throw new Error(
+      `Migration versions must be continuous: expected V${String(expected).padStart(3, '0')}, found ${migration.name}`,
+    );
+  }
+  const content = await readFile(`${migrationDirectory}/${migration.name}`, 'utf8');
+  if (/\b(BEGIN|COMMIT|ROLLBACK)\s*;/i.test(content)) {
+    throw new Error(`Migration transaction is managed by the runner: ${migration.name}`);
+  }
+  if (/\bschema_migrations\b/i.test(content)) {
+    throw new Error(`Migration history is managed by the runner: ${migration.name}`);
+  }
+}
+
+process.stdout.write(`validated ${parsed.length} migrations\n`);

package/.well-known/skills/wdyy-database-standard/scripts/validate-migration-layout.test.mjs

@@ -0,0 +1,73 @@
+import assert from 'node:assert/strict';
+import { mkdtemp, mkdir, rm, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { afterEach, test } from 'node:test';
+import { spawnSync } from 'node:child_process';
+
+const scriptDirectory = dirname(fileURLToPath(import.meta.url));
+const validator = join(scriptDirectory, 'validate-migration-layout.mjs');
+const temporaryDirectories = [];
+
+afterEach(async () => {
+  await Promise.all(
+    temporaryDirectories.splice(0).map((directory) =>
+      rm(directory, { force: true, recursive: true }),
+    ),
+  );
+});
+
+async function createMigrationDirectory(files) {
+  const root = await mkdtemp(join(tmpdir(), 'migration-layout-'));
+  temporaryDirectories.push(root);
+  const directory = join(root, 'database', 'migrations');
+  await mkdir(directory, { recursive: true });
+  await Promise.all(
+    Object.entries(files).map(([name, content]) =>
+      writeFile(join(directory, name), content),
+    ),
+  );
+  return directory;
+}
+
+test('接受从 V001 baseline 开始的连续版本化 SQL 迁移', async () => {
+  const directory = await createMigrationDirectory({
+    'V001__baseline.sql': 'CREATE TABLE demo (id bigint);\n',
+    'V002__add_demo_name.sql': 'ALTER TABLE demo ADD COLUMN name text;\n',
+  });
+
+  const result = spawnSync(process.execPath, [validator, directory], {
+    encoding: 'utf8',
+  });
+
+  assert.equal(result.status, 0, result.stderr);
+  assert.match(result.stdout, /validated 2 migrations/);
+});
+
+test('拒绝缺少 V001 baseline 的迁移目录', async () => {
+  const directory = await createMigrationDirectory({
+    'V002__add_demo_name.sql': 'SELECT 1;\n',
+  });
+
+  const result = spawnSync(process.execPath, [validator, directory], {
+    encoding: 'utf8',
+  });
+
+  assert.notEqual(result.status, 0);
+  assert.match(result.stderr, /V001__baseline.sql is required/);
+});
+
+test('拒绝版本断档', async () => {
+  const directory = await createMigrationDirectory({
+    'V001__baseline.sql': 'SELECT 1;\n',
+    'V003__skip_version.sql': 'SELECT 2;\n',
+  });
+
+  const result = spawnSync(process.execPath, [validator, directory], {
+    encoding: 'utf8',
+  });
+
+  assert.notEqual(result.status, 0);
+  assert.match(result.stderr, /Migration versions must be continuous/);
+});

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

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+import { readFile } from 'node:fs/promises';
+
+const content = await readFile(process.argv[2], 'utf8');
+const required = [
+  'created_by',
+  'updated_by',
+  'created_at',
+  'updated_at',
+  'deleted_flag',
+  '逻辑关联',
+  '表注释',
+  '字段注释',
+  'COMMENT ON TABLE',
+  'COMMENT ON COLUMN',
+  '自增',
+];
+const missing = required.filter((text) => !content.includes(text));
+if (missing.length) throw new Error(`Missing table design requirements: ${missing.join(', ')}`);
+
+// 首字段必须为 {业务域前缀}_id 格式
+if (!/\|\s*1\s*\|\s*`?[^|`\n]+_id`?\s*\|/.test(content)) {
+  throw new Error('First field must be a domain-prefixed id (e.g. pat_id) in format {prefix}_id');
+}
+
+// 主键不得使用 uuid
+if (/(^|\n)\s*\|\s*1\s*\|\s*id\s*\|\s*uuid\b/i.test(content) || /\bid\s+uuid\b/i.test(content)) {
+  throw new Error('Primary key must use an auto-increment type, not uuid');
+}
+
+// 必须包含 _status 统一状态字段
+if (!/_status\b/.test(content)) {
+  throw new Error('Table must include a domain-prefixed status field (e.g. pat_status)');
+}
+
+// deleted_flag 默认值必须为 NULL，不得为 false
+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');
+}
+
+// 禁止通用 remark 字段
+if (/remark[123]/i.test(content)) throw new Error('Generic remark fields are prohibited');
+
+process.stdout.write('valid table design\n');

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

@@ -0,0 +1,44 @@
+# 表设计：`{前缀}_{表名}`
+
+> 将 `{前缀}` 替换为业务域英文简写（见业务域前缀映射表），如患者域为 `pat_`。
+
+## 业务目的与逻辑关联
+
+- 业务域：
+- 业务实体：
+- 表注释：
+- 聚合根：
+- 关联表及关联键：
+- 状态流转：
+- 幂等键：
+
+## 字段
+
+| 顺序 | 字段 | 类型 | 必填 | 默认值 | 说明 | 字段注释/COMMENT | 索引/唯一约束 |
+|---:|---|---|---|---|---|---|---|
+| 1 | `{前缀}_id` | bigint | 是 | generated by default as identity | 自增主标识 | 自增主标识 | 主键索引 |
+| ... | (业务字段) | | 否 | | | | |
+| n-5 | `{前缀}_status` | varchar(32) | 否 | NULL | 业务状态，取值自 mdm_dictionary_item.item_code | 业务状态码 | |
+| 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 | deleted_flag | boolean | 否 | NULL | 删除标记 | 逻辑删除标记 | |
+
+## 注释 SQL
+
+```sql
+COMMENT ON TABLE {前缀}_{表名} IS '<表注释>';
+COMMENT ON COLUMN {前缀}_{表名}.{前缀}_id IS '主标识';
+-- 每个字段均必须有 COMMENT ON COLUMN
+```
+
+## 枚举与兼容性
+
+- 枚举：
+- 状态字典：`mdm_dictionary_item.item_code`
+- 迁移向前兼容策略：
+- 基线迁移：`database/migrations/V001__baseline.sql`
+- 当前迁移版本：
+- 新旧应用并存验证：
+- 应用回滚兼容性：

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

@@ -0,0 +1,68 @@
+---
+name: wdyy-deployment-standard
+description: 为无 CI/CD 的 Linux 生产环境生成本地发布门禁、人工 SCP 交付约定、前端版本化 URL 和后端 Docker 蓝绿发布脚本。Use when 规划、实现、审查或执行手工生产部署时。
+---
+
+# 企业部署规范
+
+## Overview
+
+将 Linux 发布约束落实为前端不可变 release 与后端可健康检查、可回滚的 Docker 发布。
+
+## When to Use
+
+- 规划、实现、审查或发布生产部署时。
+
+## 协作边界
+
+生产发布必须具备本地发布门禁、可观测性、健康检查、回滚和 GO/NO-GO 决策证据。工程师负责人工 SCP 上传并手动执行脚本；本 skill 不执行上传，也不取代发布决策。
+
+## 输入与输出
+
+- 输入：`YYYYMMDD-NNN` 发布版本、前端压缩包、Docker 镜像归档、版本化迁移、健康检查 URL、Nginx 权限与生产配置。
+- 输出：Dockerfile、蓝绿 compose、版本化前端 Nginx 配置、`deploy.sh` 和部署说明。
+- 读取 [Linux 部署规则](reference/linux-deployment-rules.md)，使用 templates 与 shell scripts。
+
+## 执行步骤
+
+1. 在本地依次通过测试、lint、类型检查、构建、镜像检查和发布包校验；任一步失败不得生成可发布结论。
+2. 工程师将 `incoming/<version>/frontend.tar.gz`、`backend-image.tar` 和 `database/migrations` 人工 SCP 到服务器。
+3. 前端构建使用 `/releases/<version>/` 资源基路径，解压到不可变 `releases/<version>`；`current` 仅用于入口页原子切换。
+4. 配置版本化 hash 资源长期缓存、`index.html` 禁止强缓存；保留最近五个版本且不得早于约定观测窗口清理。
+5. 使用原生 `psql` 执行尚未执行的向前兼容迁移。
+6. 在非活动颜色启动新后端容器；健康检查和版本接口通过后切换 Nginx upstream，再切换前端 `current`。
+7. 保留旧颜色容器作为上一版本；回滚只允许切回已保留并验证健康的上一版本。
+8. 生成 `start <version>`、`stop`、`restart`、`status`、`rollback <version>`，并运行部署包校验器。
+
+## 禁止事项
+
+- 不得直接覆盖正在服务的前端 `dist`。
+- 不得先停止旧后端容器再启动新容器。
+- 不得以 PM2 或 systemd 作为后端主部署方案。
+- 不得在无健康检查、版本标识或可演练回滚的情况下发布。
+- 不得在 `deploy.sh` 中执行 SCP、拉取未确认代码或静默安装依赖。
+- 不得把“保留旧 release 目录”等同于旧资源可访问；资源 URL 必须包含版本。
+
+## Red Flags
+
+- 发布脚本在新版本通过健康检查前修改 upstream。
+- 前端目录被直接覆盖，或发布计划包含破坏性迁移。
+
+## Verification
+
+- [ ] 新容器通过健康检查并返回目标版本。
+- [ ] upstream 切换后新请求命中新版本，旧资源在保留窗口不返回 404。
+- [ ] 回滚脚本在演练环境恢复旧版本。
+- [ ] 数据库变更的兼容性已审查。
+- [ ] `deploy.sh` 五个命令语义明确且不包含上传行为。
+- [ ] 人工上传目录包含前端包、后端镜像归档和版本化迁移。
+
+任一步骤失败时保持或恢复旧 upstream，保留失败容器日志并报告失败环节；不得强制切流或删除旧版本掩盖问题。
+
+## Common Rationalizations
+
+| 合理化说法 | 事实 |
+|---|---|
+| “停几秒没关系” | 发布规范要求后端无先停后启的中断窗口。 |
+| “覆盖 dist 最简单” | 旧页面会引用旧 hash 文件，覆盖会造成资源 404。 |
+| “小字段改动无需兼容” | 滚动与回滚期间新旧版本会并存。 |

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

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Enterprise Deployment Standard"
+  short_description: "Prepare manual SCP releases with versioned assets and blue green"
+  default_prompt: "Use $wdyy-deployment-standard to prepare and verify the manual SCP production deployment package."

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

@@ -0,0 +1,9 @@
+# Linux 部署规则
+
+1. 无 CI/CD 时必须在本地完成测试、lint、类型检查、构建、镜像和发布包验证，失败不得上传。
+2. SCP 由工程师人工执行；`deploy.sh` 只消费 `incoming/<version>`，不得上传、拉取代码或安装未确认依赖。
+3. 前端资源 URL 使用 `/releases/<version>/`，构建输出写入不可变 release；确认资源存在后才原子更新 `current`。
+4. 后端固定使用 blue/green 两容器；非活动颜色启动、健康检查和版本接口通过后才能切换 upstream。
+5. PostgreSQL 使用原生 `psql` 版本化迁移；迁移仅允许向前兼容的新增或扩展。
+6. 旧颜色和旧前端 release 至少保留到观测窗口结束；默认保留最近五个版本。
+7. 回滚只切换到已保留、健康且数据库兼容的上一版本。

package/.well-known/skills/wdyy-deployment-standard/scripts/validate-deployment-package.mjs

@@ -0,0 +1,48 @@
+#!/usr/bin/env node
+import { readFile } from 'node:fs/promises';
+
+const [deployPath, nginxPath, composePath] = process.argv.slice(2);
+if (!deployPath || !nginxPath || !composePath) {
+  throw new Error('Pass deploy.sh, nginx config and compose file paths');
+}
+
+const [deploy, nginx, compose] = await Promise.all([
+  readFile(deployPath, 'utf8'),
+  readFile(nginxPath, 'utf8'),
+  readFile(composePath, 'utf8'),
+]);
+
+const deployRequirements = [
+  'start)',
+  'stop)',
+  'restart)',
+  'status)',
+  'rollback)',
+  'version="$2"',
+  'HEALTH_URL',
+  'VERSION_URL',
+  'database/migrations',
+];
+const nginxRequirements = ['location /releases/', '/current'];
+const composeRequirements = [
+  'backend-blue:',
+  'backend-green:',
+  'INSTANCE_ID',
+  'blue',
+  'green',
+  'LOG_DIR',
+];
+
+const missing = [
+  ...deployRequirements.filter((value) => !deploy.includes(value)),
+  ...nginxRequirements.filter((value) => !nginx.includes(value)),
+  ...composeRequirements.filter((value) => !compose.includes(value)),
+];
+if (missing.length) {
+  throw new Error(`Missing deployment requirements: ${missing.join(', ')}`);
+}
+if (/\bscp\b/.test(deploy)) {
+  throw new Error('deploy.sh must not upload artifacts; SCP is a manual engineer action');
+}
+
+process.stdout.write('valid deployment package\n');