@wdyy/skills 0.1.15 → 0.1.16

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

@@ -12,7 +12,7 @@
     },
     {
       "name": "wdyy-api-standard",
-      "description": "根据“获取XX数据”“使用XX接口”等具体需求，定位已登记的接口 reference，并按已确认的接口契约将调用方式写入程序。Use when 需要查询或实现一个已登记接口的数据调用时。",
+      "description": "根据“获取XX数据”“使用XX接口”“使用指定查询名称”等具体需求，定位已登记的接口 reference；对于 HIS SQL 查询，从远程查询目录按 name 精确匹配，并按已确认的接口契约将调用方式写入程序。Use when 需要查询或实现一个已登记接口或 HIS SQL 查询的数据调用时。",
       "files": ["SKILL.md", "agents/openai.yaml", "reference/api-demo.md", "reference/api-his-sql.md", "reference/api-sms.md"]
     },
     {

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

@@ -1,25 +1,27 @@
 ---
 name: wdyy-api-standard
-description: 根据“获取XX数据”“使用XX接口”等具体需求，定位已登记的接口 reference，并按已确认的接口契约将调用方式写入程序。Use when 需要查询或实现一个已登记接口的数据调用时。
+description: 根据“获取XX数据”“使用XX接口”“使用指定查询名称”等具体需求，定位已登记的接口 reference；对于 HIS SQL 查询，从远程查询目录按 name 精确匹配，并按已确认的接口契约将调用方式写入程序。Use when 需要查询或实现一个已登记接口或 HIS SQL 查询的数据调用时。
 ---
 
 # 接口路由
 
 ## 用途
 
-本 Skill 只负责根据具体需求定位接口 reference，并将已确认的接口调用方式写入程序。接口明细一律维护在 `reference/` 中，每个接口一个文档。
+本 Skill 只负责根据具体需求定位接口 reference，并将已确认的接口调用方式写入程序。接口明细和 HIS SQL 查询目录使用规则一律维护在 `reference/` 中，每个接口一个文档。
 
 ## 何时使用
 
 - 用户描述“获取XX数据”“使用XX接口”或等价的数据查询、接口调用需求时。
+- 用户描述“使用 `<查询名称>`”并需要从已登记 HIS SQL 查询目录实现调用时。
 - 需要将已登记接口的 URL、入参和返回值处理方式写入程序时。
 
 ## 路由步骤
 
 1. 根据需求中的数据名称、业务对象或接口名称，在 `reference/api-*.md` 中查找候选业务接口，排除仅用于说明格式的 `api-demo.md`。
-2. 仅在唯一匹配时读取该 reference，使用其中的接口 URL、JSON 入参和 JSON 返回值编写调用方式。
-3. 按 reference 的“备注”实现特殊调用要求。
-4. 若没有匹配接口、存在多个候选接口，或 URL、入参、返回值不完整，先要求补充或确认接口信息；不得编造调用细节。
+2. 若需求为“使用 `<查询名称>`”且未直接匹配接口名称，则读取 `reference/api-his-sql.md`，按其中的远程目录和查询名称匹配规则处理。
+3. 仅在唯一匹配时读取对应 reference，使用其中的接口 URL、JSON 入参和 JSON 返回值编写调用方式。
+4. 按 reference 的“备注”实现特殊调用要求。
+5. 若没有匹配接口、存在多个候选接口，或 URL、入参、返回值不完整，先要求补充或确认接口信息；不得编造调用细节。
 
 ## 接口文档约定
 

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

@@ -1,4 +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."
+  display_name: "wdyy-api-standard"
+  short_description: "Route APIs and named HIS SQL queries into program code"
+  default_prompt: "Use $wdyy-api-standard to resolve the documented API or named HIS SQL query and write its call into the program."

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

@@ -6,17 +6,32 @@
 
 `POST` 请求，`Content-Type` 为 `application/json`。
 
+HIS SQL 查询目录：
+
+- 人工查看：`http://172.26.1.64:9003/lihuanyu/cache_query/-/blob/main/cache-query.json?ref_type=heads`
+- 程序读取：`http://172.26.1.64:9003/lihuanyu/cache_query/-/raw/main/cache-query.json`
+
 # 入参格式：JSON
 
 ```json
 {
-  "sql": "SELECT * FROM SS_User WHERE ssusr_name = '示例用户'",
-  "params": []
+  "sql": "<cache-query.json 中匹配对象的 sql 原文>",
+  "params": [
+    "<按照匹配对象 params 顺序提供的实际值>"
+  ]
 }
 ```
 
-- `sql`：要执行的 SQL 查询语句。
-- `params`：SQL 查询参数数组；示例 SQL 未使用参数，因此传入空数组。
+按以下步骤生成项目程序中的调用方式：
+
+1. 每次实现调用时读取“程序读取”地址，解析当前 `cache-query.json`；不得使用本地缓存或本 reference 中的示例 SQL 代替远程目录。
+2. 遍历 JSON 顶层对象的全部值，仅选择对象 `name` 与用户指定查询名称完全相等的候选项；不得使用 JSON 顶层键代替 `name` 匹配。
+3. 仅允许一个匹配对象。零个匹配或多个同名匹配时，明确报告问题并停止生成调用方式。
+4. 要求匹配对象包含非空字符串 `sql` 和数组 `params`。将 `sql` 原样写入请求体，不得生成、改写或拼接 SQL。
+5. 将目录中的 `params` 视为实际参数值的名称和顺序说明，不得把这些名称直接作为实际值发送。若用户或业务上下文未提供全部实际值，按数组顺序要求补充。
+6. 获得全部实际值后，按照目录 `params` 的相同顺序写入请求体 `params` 数组。
+
+例如，用户描述“使用 `get_diagnosis_info`”时，按对象 `name` 匹配该查询，并依次要求提供“开始日期”“结束日期”“诊断名称”；SQL 必须使用该匹配对象当前登记的原文。
 
 # 返回值：JSON
 
@@ -35,4 +50,4 @@
 }
 ```
 
-# 备注：使用 `POST` 请求调用；将 SQL 查询语句放入 `sql` 字段，将对应的查询参数放入 `params` 数组。
+# 备注：本 Skill 只将调用方式写入项目程序，不直接向本接口发送查询请求。远程目录不可访问、指定 `name` 不存在、存在多个同名对象、`sql` 不是非空字符串或 `params` 不是数组时，必须明确报告具体问题；不得使用旧副本、示例 SQL、顶层键匹配或自行生成 SQL 继续实现。

package/package.json

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