@wdyy/skills 0.1.0 → 0.1.2

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

@@ -11,9 +11,14 @@
       "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-api-standard",
+      "description": "根据“获取XX数据”“使用XX接口”等具体需求，定位已登记的接口 reference，并按已确认的接口契约将调用方式写入程序。Use when 需要查询或实现一个已登记接口的数据调用时。",
+      "files": ["SKILL.md", "agents/openai.yaml", "reference/api-根据就诊号获取检验数据.md"]
+    },
+    {
+      "name": "wdyy-bug-record",
+      "description": "手动汇总当前任务中已解决的 BUG、漏洞和其他非需求问题，并按固定模板追加写入 docs/bug_record.md。",
+      "files": ["SKILL.md"]
     },
     {
       "name": "wdyy-logging-standard",

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

@@ -0,0 +1,47 @@
+---
+name: wdyy-api-standard
+description: 根据“获取XX数据”“使用XX接口”等具体需求，定位已登记的接口 reference，并按已确认的接口契约将调用方式写入程序。Use when 需要查询或实现一个已登记接口的数据调用时。
+---
+
+# 接口路由
+
+## 用途
+
+本 Skill 只负责根据具体需求定位接口 reference，并将已确认的接口调用方式写入程序。接口明细一律维护在 `reference/` 中，每个接口一个文档。
+
+## 何时使用
+
+- 用户描述“获取XX数据”“使用XX接口”或等价的数据查询、接口调用需求时。
+- 需要将已登记接口的 URL、入参和返回值处理方式写入程序时。
+
+## 路由步骤
+
+1. 根据需求中的数据名称、业务对象或接口名称，在 `reference/api-*.md` 中查找候选接口。
+2. 仅在唯一匹配时读取该 reference，使用其中的接口 URL、JSON 入参和 JSON 返回值编写调用方式。
+3. 按 reference 的“备注”实现特殊调用要求。
+4. 若没有匹配接口、存在多个候选接口，或 URL、入参、返回值不完整，先要求补充或确认接口信息；不得编造调用细节。
+
+## 接口文档约定
+
+- 一个接口对应一个 `reference/api-接口名称.md` 文件。
+- 文件名去除 `.md` 后必须与“接口名称”字段一致。
+- 每个接口文档必须按以下顺序包含六个一级标题：
+
+```md
+# 接口名称：api-xxx
+
+# 接口用途：中文描述
+
+# 接口URL：
+
+# 入参格式：JSON
+
+# 返回值：JSON
+
+# 备注：特殊使用方法说明
+```
+
+## 禁止事项
+
+- 不得依据接口名称或业务描述猜测 URL、请求字段、返回字段或特殊调用方式。
+- 不得将多个接口明细重新堆放回本 `SKILL.md`。

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

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Enterprise API Standard"
+  short_description: "Route data requests to documented API references"
+  default_prompt: "Use $wdyy-api-standard to find the documented API for this requirement and write its call into the program."

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

@@ -0,0 +1,25 @@
+# 接口名称：api-根据就诊号获取检验数据
+
+# 接口用途：根据就诊号获取检验数据
+
+# 接口URL：http://172.26.1.64:8996/api/execute/getLabInfoByVisitId
+
+# 入参格式：JSON
+
+```json
+{
+  "visitId": "6275033"
+}
+```
+
+# 返回值：JSON
+
+```json
+{
+  "code": 200,
+  "data": [{}, {}],
+  "msg": "success"
+}
+```
+
+# 备注：使用就诊号作为 `visitId` 参数调用；调用前应由业务上下文提供实际就诊号。

package/.well-known/skills/wdyy-bug-record/SKILL.md

@@ -0,0 +1,28 @@
+---
+name: wdyy-bug-record
+description: 手动汇总当前任务中已解决的 BUG、漏洞和其他非需求问题，并按固定模板追加写入 docs/bug_record.md。
+disable-model-invocation: true
+---
+
+# BUG 记录
+
+仅在需要沉淀当前任务已解决问题时手动调用本 Skill。
+
+## 记录范围
+
+- 仅汇总当前任务中已经解决的 BUG、漏洞、环境、构建、部署或运行异常。
+- 不扫描 Git、Issue、日志或其他项目文件来推断问题。
+- 当前任务没有已解决问题时，明确说明无可记录内容，不写入文件。
+- 不记录密码、令牌、验证码或其他秘密。
+
+## 写入步骤
+
+1. 从当前任务上下文整理每个已解决问题的“问题描述”和“解决方法”。
+2. 在项目根目录的 `docs/bug_record.md` 末尾追加每条记录；保留既有内容，不覆盖历史。
+3. 每条记录使用调用当天的日期，并严格采用以下格式：
+
+```md
+- 日期：yyyy-mm-dd
+- 问题描述：
+- 解决方法：
+```

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

@@ -2,7 +2,7 @@
 
 - 日志为一行 JSON，最小字段见 `logger.template.ts`。
 - `timestamp` 使用服务器本地时间 `YYYY-MM-DD HH:mm:ss`，精确到秒；不得包含毫秒、`T` 或 `Z`。
-- 文件名使用服务器本地时间 `yyyy-mm-dd_hh24-mm-ss.log`；当前文件大于 2MB 时先创建新文件再写入。既有日志文件不得重命名。
+- 文件名使用服务器本地时间 `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]`。

package/README.md

@@ -10,12 +10,13 @@ OpenSpec                           单项变更的需求、设计、任务、实
 .well-known/skills/wdyy-*         数据库、内部接口、日志、部署的专业规则
 ```
 
-当前 `.well-known/skills/index.json` 登记 4 个企业 Skill。
+当前 `.well-known/skills/index.json` 登记 5 个企业 Skill。
 
 | Skill | 职责 |
 |---|---|
 | `wdyy-database-standard` | PostgreSQL 18 数据库设计、版本化迁移、数据兼容性与 DDL 校验。 |
-| `wdyy-internal-api-standard` | 内部 REST 调用的认证、traceId、超时、受控重试、错误映射与响应校验。 |
+| `wdyy-api-standard` | 根据“获取XX数据”“使用XX接口”等需求定位接口 reference，并按已确认契约写入调用方式。 |
+| `wdyy-bug-record` | 手动汇总当前任务已解决的问题，并按模板追加至 `docs/bug_record.md`。 |
 | `wdyy-logging-standard` | 结构化日志、敏感字段移除、traceId、前端异常上报与日志轮转。 |
 | `wdyy-deployment-standard` | 人工 SCP 交付、版本化前端资源、Docker 蓝绿发布与回滚。 |
 
@@ -28,7 +29,19 @@ npm install -g @wdyy/skills
 wdyy init
 ```
 
-`wdyy init` 自动执行 `openspec init`，将 4 个受管理 Skill 安装到 `.agents/skills/`。若目标项目已有 `AGENTS.md`，原文件保持不变，命令将生成 `AGENTS_new.md`；每次运行都会覆盖更新 `.agents/skills/wdyy-*`，但不修改同级自定义 Skill。
+`wdyy init` 自动执行 `openspec init`，将 5 个受管理 Skill 安装到 `.agents/skills/`，并在 `docs/bug_record.md` 创建或追加 BUG 记录模板。若目标项目已有 `AGENTS.md`，原文件保持不变，命令将生成 `AGENTS_new.md`；每次运行都会覆盖更新 `.agents/skills/wdyy-*`，但不修改同级自定义 Skill。
+
+### 仅更新已安装的 Skill
+
+发布包含 Skill 更新的新版本后，先升级全局 CLI 包，再在目标项目根目录按需更新一个或全部受管理 Skill：
+
+```bash
+npm install -g @wdyy/skills@latest
+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`。
 
 中大型变更先使用 `/opsx:explore` 或 `/opsx:propose <change-name>`，在方案确认后使用 `/opsx:apply`；完成验证后使用 `/opsx:archive`。涉及数据库、内部 API、日志、部署时，按 `AGENTS.md` 的路由加载相应企业 Skill。配置仅从环境变量读取，不得提交秘密或生产环境 `.env`。
 
@@ -37,7 +50,6 @@ wdyy init
 - Node.js 24、pnpm workspace、TypeScript
 - Vue 3、Vite、Pinia、Vue Router、Element Plus
 - NestJS、PostgreSQL 18
-- Redis、RabbitMQ 仅在工程师明确确认后启用
 
 ## 仓库维护
 
@@ -46,16 +58,44 @@ wdyy init
 - 自定义企业 Skill 的目录名和 frontmatter `name` 必须以 `wdyy-` 开头且保持一致。
 - 只修改 `wdyy-*` Skill；详细且易变的规则应放在对应的 `reference/`，可重复校验应放在 `scripts/`。
 
-## 名称迁移
+## 发布到 npm
 
-| 原名称 | 新名称 |
-|---|---|
-| `enterprise-database-standard` | `wdyy-database-standard` |
-| `enterprise-internal-api-standard` | `wdyy-internal-api-standard` |
-| `enterprise-logging-standard` | `wdyy-logging-standard` |
-| `enterprise-deployment-standard` | `wdyy-deployment-standard` |
+发布包名为 `@wdyy/skills`，命令行入口为 `wdyy`。发布前不得跳过验证：
+
+```bash
+npm test
+npm run lint
+node --test $(find .well-known/skills -path '*/scripts/*.test.mjs' -print)
+npm pack --dry-run
+```
+
+首次发布前，登录拥有 `wdyy` 组织 owner 或发布权限的 npm 账号，并在 npm 账户设置中配置安全密钥 2FA（WebAuthn，例如 macOS Touch ID 或硬件安全密钥）。npm 已不支持通过 CLI 新增 TOTP 认证器；不得在仓库、终端历史或文档中记录 access token、验证码或恢复码。
+
+确认身份与组织权限后，发布公开包：
 
-旧名称不再作为本仓库提供的 Skill 身份。请将项目规则与手动调用更新为相应的 `wdyy-*` 名称。
+```bash
+npm login
+npm whoami
+npm org ls wdyy
+npm publish --access public
+```
+
+`npm whoami` 返回 `E401` 表示当前 CLI 没有有效登录态，应重新执行 `npm login` 后再发布。已成功登录但 `npm publish --access public` 仍返回 `E404` 时，通常表示当前账号没有 `@wdyy` 组织的包创建或发布权限；请由该组织的 Owner 授予权限后重试。不要通过在命令行中传入 access token、验证码或恢复码来规避认证。
+
+同一包名和版本只能发布一次。后续发布必须先升级版本，再重新执行全部发布前验证：
+
+```bash
+npm version patch
+npm publish --access public
+```
+
+发布后核验 registry 中的版本，并在干净的目标项目中验证全局安装与初始化：
+
+```bash
+npm view @wdyy/skills version
+npm install -g @wdyy/skills
+wdyy init
+```
 
 ## 验证
 

package/lib/wdyy-cli.js

@@ -1,19 +1,20 @@
 import { spawnSync } from 'node:child_process';
-import { access, cp, mkdir, mkdtemp, rename, rm, writeFile } from 'node:fs/promises';
+import { access, appendFile, cp, mkdir, mkdtemp, readFile, rename, rm, writeFile } from 'node:fs/promises';
 import { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
 const packageRoot = join(dirname(fileURLToPath(import.meta.url)), '..');
 const managedSkillNames = [
   'wdyy-database-standard',
-  'wdyy-internal-api-standard',
+  'wdyy-api-standard',
+  'wdyy-bug-record',
   'wdyy-logging-standard',
   'wdyy-deployment-standard'
 ];
 
 const generatedAgentsContent = `# 企业开发规则
 
-本项目使用 wdyy 企业 Skill。新增、更新、删除受管理 Skill 后，必须同步核对项目内 Skill 清单；Skill 目录名必须与 \`SKILL.md\` frontmatter 的 \`name\` 一致。
+本项目同时使用OpenSpec及企业 Skill统一开发规则及流程。
 
 ## 固定技术栈
 
@@ -21,49 +22,51 @@ const generatedAgentsContent = `# 企业开发规则
 - 前端：Vue 3、Vite、Pinia、Vue Router、Element Plus。
 - 后端：NestJS。
 - 数据库：PostgreSQL 18。
-- Redis、RabbitMQ 仅在工程师明确确认后引入。
 
-默认项目目录为 \`apps/frontend\`、\`apps/backend\`、\`packages\`、\`database/migrations\`、\`deploy/docker\`、\`deploy/nginx\`、\`docs\`、\`scripts\`、\`tests\`。配置仅从环境变量读取；不得提交秘密或生产环境 \`.env\`。
+默认项目目录为 \`src/frontend\`、\`src/backend\`、\`database\`、\`deploy\`、\`docs\`、\`scripts\`、\`tests\`、\`.env.example\`。
 
-## OpenSpec 工作流
-
-功能新增、跨模块变更、数据模型变更、重构和生产发布必须使用 OpenSpec：不明确时先执行 \`explore\`；明确需求时执行 \`propose <change-name>\`；涉及业务、接口、数据库、部署或不可逆决定时，必须等待工程师确认方案后执行 \`apply\`；完成实现与验证后执行 \`/opsx:archive\`。
+配置仅从环境变量读取；不得提交秘密或生产环境 \`.env\`。
 
 ## Skill 路由
 
 | 场景 | 必须使用的 Skill |
 |---|---|
 | PostgreSQL 表、DDL、迁移、数据兼容性 | \`wdyy-database-standard\` |
-| 服务间 REST 调用、认证、超时、重试、错误映射 | \`wdyy-internal-api-standard\` |
+| 获取已登记接口数据、使用已登记接口 | \`wdyy-api-standard\` |
+| 汇总当前任务已解决的 BUG、漏洞或运行异常 | 手动调用 \`wdyy-bug-record\`，追加写入 \`docs/bug_record.md\` |
 | 结构化日志、traceId、脱敏、前端异常上报 | \`wdyy-logging-standard\` |
 | Linux 发布、Docker 蓝绿、Nginx 切流、回滚 | \`wdyy-deployment-standard\` |
 
 ## 通用边界
 
-- 项目根目录应提供真实可执行的 \`pnpm dev\`、\`pnpm build\`、\`pnpm test\`、\`pnpm lint\` 命令；\`pnpm dev\` 不得启动或管理数据库、缓存或消息队列。
+- 项目根目录应提供真实可执行的 \`pnpm dev\`、\`pnpm build\`、\`pnpm test\`、\`pnpm lint\` 命令；\`pnpm dev\` 只负责前后端的启动，不得启动或管理数据库。
 - 代码、配置、迁移、测试与部署文件必须以实际实现为准；不得用模板虚构已实现能力。
-- 任何破坏性数据库操作、生产发布、引入基础设施或新外部依赖，必须在 OpenSpec 方案中说明影响并获得工程师确认。
+- 所有需求（如数据库变更、流程变更、功能变更、从零开发项目等），必须先使用\`openspec-explore\`技能确认需求，再根据实际情况，使用\`openspec\`的其它技能。
 - 不得静默吞错、跳过验证、以兜底逻辑掩盖未决问题。
 `;
 
+const bugRecordTemplate = '- 日期：yyyy-mm-dd\n- 问题描述：\n- 解决方法：\n';
+
 function printHelp() {
   console.log('用法: wdyy init');
   console.log('在当前项目生成 AGENTS 规则、安装 wdyy Skill，并执行 openspec init。');
+  console.log('用法: wdyy update-skill <skill-name> | --all');
+  console.log('仅更新当前项目的一个或全部受管理 wdyy Skill，不执行项目初始化。');
 }
 
-async function installManagedSkills(targetRoot, writtenPaths) {
+async function installManagedSkills(targetRoot, writtenPaths, skillNames = managedSkillNames) {
   const skillsRoot = join(targetRoot, '.agents', 'skills');
   await mkdir(skillsRoot, { recursive: true });
   const temporaryRoot = await mkdtemp(join(skillsRoot, '.wdyy-skills-'));
 
   try {
-    for (const skillName of managedSkillNames) {
+    for (const skillName of skillNames) {
       const source = join(packageRoot, '.well-known', 'skills', skillName);
       const prepared = join(temporaryRoot, skillName);
       await cp(source, prepared, { recursive: true, force: true, errorOnExist: false });
     }
 
-    for (const skillName of managedSkillNames) {
+    for (const skillName of skillNames) {
       const destination = join(skillsRoot, skillName);
       await rm(destination, { recursive: true, force: true });
       await rename(join(temporaryRoot, skillName), destination);
@@ -89,6 +92,24 @@ async function writeAgentsFile(targetRoot, writtenPaths) {
   console.log(`已写入项目规则: ${destination}`);
 }
 
+async function appendBugRecordTemplate(targetRoot, writtenPaths) {
+  const docsRoot = join(targetRoot, 'docs');
+  const bugRecordPath = join(docsRoot, 'bug_record.md');
+  await mkdir(docsRoot, { recursive: true });
+
+  let prefix = '';
+  try {
+    const existing = await readFile(bugRecordPath, 'utf8');
+    if (existing.length > 0) prefix = existing.endsWith('\n') ? '\n' : '\n\n';
+  } catch (error) {
+    if (error.code !== 'ENOENT') throw error;
+  }
+
+  await appendFile(bugRecordPath, `${prefix}${bugRecordTemplate}`, 'utf8');
+  writtenPaths.push(bugRecordPath);
+  console.log(`已更新 BUG 记录模板: ${bugRecordPath}`);
+}
+
 function initializeOpenSpec(targetRoot, writtenPaths) {
   const result = spawnSync('openspec', ['init'], { cwd: targetRoot, stdio: 'inherit' });
   if (result.error || result.status !== 0) {
@@ -108,6 +129,7 @@ export async function run(argumentsList) {
     try {
       await writeAgentsFile(process.cwd(), writtenPaths);
       await installManagedSkills(process.cwd(), writtenPaths);
+      await appendBugRecordTemplate(process.cwd(), writtenPaths);
       const openSpecExitCode = initializeOpenSpec(process.cwd(), writtenPaths);
       if (openSpecExitCode !== 0) return openSpecExitCode;
       console.log('wdyy 初始化完成。');
@@ -119,6 +141,30 @@ export async function run(argumentsList) {
     }
   }
 
+  if (argumentsList[0] === 'update-skill') {
+    const skillArguments = argumentsList.slice(1);
+    const skillNames = skillArguments.length === 1 && skillArguments[0] === '--all'
+      ? managedSkillNames
+      : skillArguments.length === 1 && managedSkillNames.includes(skillArguments[0])
+        ? [skillArguments[0]]
+        : null;
+
+    if (!skillNames) {
+      printHelp();
+      return 1;
+    }
+
+    const writtenPaths = [];
+    try {
+      await installManagedSkills(process.cwd(), writtenPaths, skillNames);
+      return 0;
+    } catch (error) {
+      console.error(`Skill 更新失败: ${error.message}`);
+      if (writtenPaths.length > 0) console.error(`已写入路径:\n${writtenPaths.map((path) => `- ${path}`).join('\n')}`);
+      return 1;
+    }
+  }
+
   printHelp();
   return argumentsList.length === 1 && ['--help', '-h'].includes(argumentsList[0]) ? 0 : 1;
 }

package/package.json

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

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

@@ -1,60 +0,0 @@
----
-name: wdyy-internal-api-standard
-description: 规范企业内部 REST API 客户端的认证头、traceId、超时、受控重试、熔断、错误映射、日志和响应校验。Use when DEFINE 阶段识别接口边界、BUILD 阶段调用内部服务或 REVIEW 阶段发现散落 fetch、axios、httpClient 调用时。
----
-
-# 企业内部接口规范
-
-## Overview
-
-将内部服务调用收敛到可追踪、可验证且有明确失败语义的 REST 客户端边界。
-
-## When to Use
-
-- 识别接口边界、实现内部服务调用或审查业务层 HTTP 调用时。
-
-## 协作边界
-
-先确认接口契约、错误语义、实现计划和测试要求。本 skill 独立规定企业客户端实现约束，不能替代实现和验证工作。
-
-## 输入与输出
-
-- 输入：接口契约、认证方案、超时预算、错误码、重试安全性和 Mock 场景。
-- 输出：统一客户端、接口定义、错误处理、Mock 与测试证据。
-- 使用 [客户端模板](templates/api-client.template.ts)、[错误模板](templates/api-error.template.ts) 和 [规则](reference/internal-api-rules.md)。
-
-## 执行步骤
-
-1. 确认服务边界、认证头、请求/响应 schema、超时预算及幂等条件。
-2. 通过唯一封装客户端发起所有内部调用，注入 traceId 和请求日志。
-3. 仅对明确幂等且可恢复的错误执行有限重试；配置熔断与可观测错误码。
-4. 校验响应结构，映射外部错误为业务可处理的稳定错误。
-5. 用 Mock 覆盖超时、认证失败、无效响应、重试和熔断路径。
-
-## 禁止事项
-
-- 不得在业务代码中散落 `fetch`、`axios` 或原始 `httpClient` 调用。
-- 不得对非幂等写操作无条件重试。
-- 不得吞掉响应校验、超时、错误码或调用日志。
-
-## Red Flags
-
-- 业务模块直接调用 fetch、axios 或原始 httpClient。
-- 未定义幂等性却配置重试，或未校验响应结构。
-
-## Verification
-
-- [ ] 调用均通过封装客户端，traceId 与认证头可验证。
-- [ ] 超时、重试上限、熔断与错误码映射有测试。
-- [ ] 无效响应不能进入业务逻辑。
-- [ ] Mock 覆盖成功及主要异常分支。
-
-认证、幂等性或错误语义未定义时，停止调用实现并回到接口契约澄清；不得以无限重试或吞错替代决策。
-
-## Common Rationalizations
-
-| 合理化说法 | 事实 |
-|---|---|
-| “一个 fetch 不值得封装” | 分散调用无法统一认证、追踪、超时和错误行为。 |
-| “重试总会提高成功率” | 非幂等重试会造成重复写入和状态污染。 |
-| “内部服务可以信任响应” | 服务边界仍可能发生版本漂移和故障。 |

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

@@ -1,4 +0,0 @@
-interface:
-  display_name: "Enterprise Internal API Standard"
-  short_description: "Standardize internal REST client integrations"
-  default_prompt: "Use $wdyy-internal-api-standard to implement an internal REST API client."

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

@@ -1,5 +0,0 @@
-# 内部 API 规则
-
-- 认证头、`x-trace-id`、超时、响应 schema 与错误码映射均由统一客户端处理。
-- 仅明确幂等请求可有限重试；熔断状态必须可观测。
-- 禁止业务层直接调用 fetch、axios 或原始 httpClient。

package/.well-known/skills/wdyy-internal-api-standard/scripts/check-raw-http-calls.mjs

@@ -1,10 +0,0 @@
-#!/usr/bin/env node
-import { readFile } from 'node:fs/promises';
-
-const file = process.argv[2];
-if (!file) throw new Error('Pass a business source file');
-const content = await readFile(file, 'utf8');
-if (/\b(fetch|axios\.|httpClient\.)\s*\(/.test(content)) {
-  throw new Error(`Raw HTTP call found in ${file}; use the internal API client`);
-}
-process.stdout.write('no raw HTTP calls\n');

package/.well-known/skills/wdyy-internal-api-standard/templates/api-client.template.ts

@@ -1,20 +0,0 @@
-type RequestOptions = { method: string; path: string; body?: unknown; traceId: string; idempotent?: boolean };
-
-export class InternalApiClient {
-  constructor(private readonly baseUrl: string, private readonly token: () => Promise<string>) {}
-
-  async request<T>(options: RequestOptions): Promise<T> {
-    const response = await fetch(`${this.baseUrl}${options.path}`, {
-      method: options.method,
-      headers: {
-        authorization: `Bearer ${await this.token()}`,
-        'content-type': 'application/json',
-        'x-trace-id': options.traceId,
-      },
-      body: options.body === undefined ? undefined : JSON.stringify(options.body),
-      signal: AbortSignal.timeout(5_000),
-    });
-    if (!response.ok) throw new Error(`INTERNAL_API_${response.status}`);
-    return await response.json() as T;
-  }
-}

package/.well-known/skills/wdyy-internal-api-standard/templates/api-error.template.ts

@@ -1,7 +0,0 @@
-export class InternalApiError extends Error {
-  constructor(
-    readonly code: string,
-    readonly retryable: boolean,
-    message: string,
-  ) { super(message); }
-}

package/.well-known/skills/wdyy-internal-api-standard/templates/api-mock.template.ts

@@ -1,8 +0,0 @@
-import { http, HttpResponse } from 'msw';
-
-export const handlers = [
-  http.get('*/internal/<resource>', ({ request }) => {
-    if (!request.headers.get('x-trace-id')) return HttpResponse.json({ code: 'TRACE_ID_REQUIRED' }, { status: 400 });
-    return HttpResponse.json({ data: [] });
-  }),
-];