kcode-pi 0.1.6 → 0.1.7

package/vendor/kingdee-skills/ok-cosmic/manifest.json

@@ -5,44 +5,44 @@
   "author": "Cosmic",
   "tools": [
     {
-      "name": "cosmic_search_classes",
-      "description": "搜索苍穹类名。用法: --config <json> search <keyword...> [--class-prefix <prefix>] [--kind <kind>]",
-      "source": "scripts/cosmic-api-knowledge.py"
+      "name": "kd_cosmic_api",
+      "description": "搜索苍穹类名/API 线索。用法: mode=search query=<keyword...> [config=<json>]",
+      "source": "kcode-node:cosmic-api"
     },
     {
-      "name": "cosmic_search_methods",
-      "description": "全局搜索苍穹方法名。用法: --config <json> search-method <keyword...> [--class-prefix <prefix>] [--kind <kind>]",
-      "source": "scripts/cosmic-api-knowledge.py"
+      "name": "kd_cosmic_api",
+      "description": "搜索苍穹方法名。用法: mode=search-method query=<keyword...> [config=<json>]",
+      "source": "kcode-node:cosmic-api"
     },
     {
-      "name": "cosmic_get_class_detail",
-      "description": "获取类详情并校验方法签名。用法: --config <json> detail <full.class.Name> [--method <keyword>] [--compact] [--declared-only]",
-      "source": "scripts/cosmic-api-knowledge.py"
+      "name": "kd_cosmic_api",
+      "description": "获取类/API 详情线索。用法: mode=detail query=<full.class.Name> [method=<keyword>] [compact=true]",
+      "source": "kcode-node:cosmic-api"
     },
     {
-      "name": "cosmic_get_meta_fields",
-      "description": "查询表单元数据字段。用法: --config <json> get <formIdOrName> [逗号分隔批量] [--fuzzy <words...>] [--show-detail] [--refresh] [--tree]",
-      "source": "scripts/cosmic-form-metadata.py"
+      "name": "kd_cosmic_metadata",
+      "description": "查询表单元数据字段。用法: form=<formIdOrName> [config=<json>] [fuzzy=<words>] [sql=true] [showDetail=true]",
+      "source": "kcode-node:cosmic-metadata"
     },
     {
       "name": "cosmic_query_basedata",
-      "description": "查询基础资料。用法: --config <json> get --entity-id <id> [--number-or-name <kw>] [--full] [--refresh] [--json]。entityId 必须已确认来源，不确定时先用元数据脚本查 refType",
-      "source": "scripts/cosmic-basedata-query.py"
+      "description": "基础资料在线查询已从 npm 包移除。entityId 必须先由 kd_cosmic_metadata 确认；需要实时数据时由项目侧接口或人工查询提供证据。",
+      "source": "kcode-node:metadata-gated-manual"
     },
     {
       "name": "cosmic_query_extpoints",
-      "description": "查询业务拓展点候选。用法: --config <json> get --keyword <kw> [--limit <n>] [--json] [--full]。命中接口类名后继续用 cosmic-api-knowledge.py detail 确认签名",
-      "source": "scripts/cosmic-extpoints-query.py"
+      "description": "业务拓展点候选通过 kd_search/kd_cosmic_api 查询随包知识和项目代码；命中接口类名后继续用 kd_cosmic_api detail 或编译验证签名。",
+      "source": "kcode-node:cosmic-api"
     },
     {
       "name": "cosmic_post_check",
-      "description": "代码生成后统一检查入口。用法: <file_or_dir> [--fix-hint] [--json] [--strict]。Gradle 项目优先编译检查，非 Gradle 回退静态校验（A/B/C 三层）",
-      "source": "scripts/cosmic-post-check.py"
+      "description": "代码生成后统一检查入口。先运行 kd_check；条件允许时再运行 kd_build 或项目编译命令；ERROR 必须修复后复检。",
+      "source": "kcode-node:kd-check"
     },
     {
       "name": "cosmic_config_check",
-      "description": "Step 0 环境与配置预检。用法: [--config <json>] [--strict] [--json]。检查 Python 依赖（自动安装）、Java 环境、ok-cosmic.json 配置完整性",
-      "source": "scripts/cosmic-config-check.py"
+      "description": "Step 0 环境与配置预检。运行 kd_cosmic_config；当前项目没有 ok-cosmic.json 时使用 KCode 随包默认配置并给出 warning。",
+      "source": "kcode-node:cosmic-config"
     }
   ],
   "assets": [
@@ -72,6 +72,7 @@
     ".DS_Store",
     "__pycache__/",
     "*.pyc",
+    "*.py",
     "setup/**",
     "README.md"
   ]

package/vendor/kingdee-skills/ok-cosmic/ok-cosmic-intro.html

@@ -497,7 +497,7 @@
   <div class="flow-line" style="margin:24px 0;">
     <div class="flow-box">生成 .java</div>
     <div class="flow-arrow">→</div>
-    <div class="flow-box">cosmic-post-check.py</div>
+    <div class="flow-box">kd_check + kd_build</div>
     <div class="flow-arrow">→</div>
     <div class="flow-box" style="border-color:var(--accent);">Gradle？</div>
   </div>

package/vendor/kingdee-skills/ok-cosmic/rules/a-layer-rules.json

@@ -1,5 +1,5 @@
 {
-  "_comment": "A 层硬约束规则 ID 列表（单一可信源）。cosmic-post-lint.py 和 post-check.md 共同引用此文件。",
+  "_comment": "A 层硬约束规则 ID 列表（单一可信源）。KCode kd_check 逐步迁移并引用这些规则。",
   "a_layer_rule_ids": [
     "SCENE-001",
     "SCENE-002",

package/vendor/kingdee-skills/ok-cosmic/rules/anti-patterns.md

@@ -1,7 +1,7 @@
 # 禁忌清单 (Anti-Patterns)
 
-> 本文件为禁忌清单；其中 `scene_check.py`（SCENE-\*）对应的场景错配条目会被自动检测。
-> 幻觉方法名/类名黑名单用于事前人工/AI 自检，`hal_check.py` 与 `HAL-*` 事后 lint 规则已废弃。
+> 本文件为禁忌清单；其中高价值 SCENE 规则已逐步迁移到 KCode `kd_check`。
+> 幻觉方法名/类名黑名单用于事前人工/AI 自检，`HAL-*` 事后 lint 规则已废弃；精确签名优先通过 `kd_cosmic_api`、项目 SDK 或编译验证。
 > 场景错配条目默认属于 **A 层硬约束**，除非单独标注 `[B层]`。
 > 编码风格（STYLE-\*）和资源管理（RESOURCE-\*）规则见 [coding-preferences.md](coding-preferences.md)。
 

package/vendor/kingdee-skills/ok-cosmic/rules/coding-preferences.md

@@ -1,6 +1,6 @@
 # 编码偏好、默认写法与治理方向
 
-> 本文件为 `style_check.py`（STYLE-\*）、`resource_check.py`（RESOURCE-\*）、`verify_check.py`（VERIFY-\*）的**规则来源**。
+> 本文件为 `kd_check` 中 STYLE / RESOURCE / VERIFY 类规则的领域来源。
 > 幻觉禁忌和场景错配见 [anti-patterns.md](anti-patterns.md)；当前自动 lint 规则前缀为 SCENE-\*。
 
 本文件承载 `ok-cosmic` 的 **B 层** 和 **C 层** 规则：
@@ -61,9 +61,9 @@
 
 ## B2. 元数据与脚本配合细则
 
-- **[B2.1]** **元数据查询约束**：调用 `cosmic-form-metadata.py` 时，脚本会无条件展示所有字段；如果概览模式未显示所需字段，请主动在 `--fuzzy` 中增加搜索词进行精准匹配。
+- **[B2.1]** **元数据查询约束**：调用 `kd_cosmic_metadata` 时，工具会尽量展示字段；如果概览模式未显示所需字段，请主动在 `fuzzy` 中增加搜索词进行精准匹配。
 - **[B2.2]** 如果脚本未查到字段或表单元数据，必须提醒用户确认其提供的表单名称/标识是否正确，再继续处理。
-- **[B2.3]** **字段元数据强制验证**：只要要生成/修改代码，且已知目标单据/表单，凡涉及字段（无论用户给中文名还是英文标识），都必须通过 `cosmic-form-metadata.py` 确认字段存在、字段类型、所属实体和特殊取值规则后再写入代码。
+- **[B2.3]** **字段元数据强制验证**：只要要生成/修改代码，且已知目标单据/表单，凡涉及字段（无论用户给中文名还是英文标识），都必须通过 `kd_cosmic_metadata` 确认字段存在、字段类型、所属实体和特殊取值规则后再写入代码。
 - **[B2.4]** **批量合并**：需要确认多个字段时，必须合并为一次 `--fuzzy` 调用（如 `--fuzzy qty price amount material org`），严禁逐个字段发起多次查询。
 - **[B2.5]** **自动详情**：当 `--fuzzy` 传入 ≥3 个关键词时，脚本自动升级为详情模式（含枚举/refType），无需手动追加 `--show-detail`。
 - **[B2.6]** **常规字段对齐**：仅确认 1-2 个字段标识时，不带 `--show-detail` 和 `--sql`。
@@ -91,7 +91,7 @@
 
 ## 自动检测规则速查（STYLE / RESOURCE）
 
-> 以下规则由 `style_check.py` 和 `resource_check.py` 自动扫描。
+> 以下规则由 `kd_check` 自动扫描，尚未自动覆盖的规则仍需人工审查。
 > A 层规则 ID 定义在 [a-layer-rules.json](a-layer-rules.json)（单一可信源），报 ERROR 必须修复；B 层报 WARNING，新代码优先修复。
 
 ### STYLE-\*: 编码风格

package/vendor/kingdee-skills/ok-cosmic/rules/constraints.md

@@ -14,15 +14,15 @@
 
 - **[A1.1] 拒绝幻觉**：严禁凭记忆或猜测生成任何 API 签名、事件方法名或单据字段标识。
 - **[A1.2] 模板强制先行**：AI 在生成任何苍穹插件代码前，必须先读取对应的 `assets/*.java` 模板文件，并严格遵守模板中的方法签名。
-- **[A1.3] 签名强制校验**：在编写任何 `@Override` 方法或调用 BOS SDK 关键方法前，应通过 `cosmic-api-knowledge.py` 的 `detail` 子命令验证该方法确实存在且签名准确（已在 `rules/cheat-sheet.md` 中列出的 API 可直接使用，无需脚本验证）。`API-*` 事后 lint 规则已废弃，若事前校验被跳过，只能依赖编译、脚本查询或人工确认补救。
+- **[A1.3] 签名强制校验**：在编写任何 `@Override` 方法或调用 BOS SDK 关键方法前，应通过 `kd_cosmic_api mode=detail`、项目 SDK 或编译结果验证该方法确实存在且签名准确（已在 `rules/cheat-sheet.md` 中列出的 API 可直接使用，无需额外验证）。`API-*` 事后 lint 规则已废弃，若事前校验被跳过，只能依赖编译、工具查询或人工确认补救。
 - **[A1.4] 入口对齐协议**：
    - **UI 控制 (只读/隐藏/弹窗)**：必须通过 `IFormView`（由 `this.getView()` 获取）。
    - **数据操作 (取值/赋值/结构)**：必须通过 `IDataModel`（由 `this.getModel()` 获取）。
 - **[A1.5] 验证优先级**：在使用原生 SDK 前，必须先查本地 `.md`，再通过脚本验证。
 - **[A1.6] 继承溯源**：利用脚本返回的继承树确认方法是否在基类中。
 - **[A1.7] 代码风格基线**：新生成代码必须以对应模板为主，不得脱离模板随意改写方法签名、生命周期方法或基础骨架。
-- **[A1.8] 枚举/下拉选项值禁猜**：凡是需要使用 `ComboField`、下拉列表等字段的**具体选项值**（无论用于条件判断、状态赋值、QFilter 构造、数据反写还是任何其他场景），**严禁凭空编造或凭经验猜测**。必须先通过 `cosmic-form-metadata.py` 查询该字段，读取返回结果中「附加信息 (Ext)」列的真实枚举映射（如 `A:已审核, B:暂存`），确认后才能将对应的值写入代码。
-- **[A1.9] 字段生成代码强制验证**：只要要生成或修改代码，且已知目标单据/表单（`formId` 或 `billName`），凡涉及字段（无论用户给的是中文名还是英文标识），都必须先通过 `cosmic-form-metadata.py` 验证字段是否存在、字段类型、所属实体（表头/表体/子表体/容器）和特殊取值规则（如 `BasedataPropField` 的 `refType`、`LargeTextField` 的 `{fieldKey}_tag`、Combo/下拉字段 Ext 映射）。未验证前不得直接把用户给出的字段写入代码。
+- **[A1.8] 枚举/下拉选项值禁猜**：凡是需要使用 `ComboField`、下拉列表等字段的**具体选项值**（无论用于条件判断、状态赋值、QFilter 构造、数据反写还是任何其他场景），**严禁凭空编造或凭经验猜测**。必须先通过 `kd_cosmic_metadata showDetail=true` 查询该字段，读取返回结果中「附加信息 (Ext)」列的真实枚举映射（如 `A:已审核, B:暂存`），确认后才能将对应的值写入代码。
+- **[A1.9] 字段生成代码强制验证**：只要要生成或修改代码，且已知目标单据/表单（`formId` 或 `billName`），凡涉及字段（无论用户给的是中文名还是英文标识），都必须先通过 `kd_cosmic_metadata` 验证字段是否存在、字段类型、所属实体（表头/表体/子表体/容器）和特殊取值规则（如 `BasedataPropField` 的 `refType`、`LargeTextField` 的 `{fieldKey}_tag`、Combo/下拉字段 Ext 映射）。未验证前不得直接把用户给出的字段写入代码。
 
 ## A2. 平台开发红线
 

package/vendor/kingdee-skills/ok-cosmic/rules/decision-matrix.md

@@ -4,7 +4,7 @@
 
 如果用户原话还是业务描述、还没翻译成“操作插件 / 表单插件 / 基础资料能力”等技术场景，先读 [intent-routing.md](intent-routing.md) 做语义翻译。
 
-> **提示**：`入口类` 主要用于缩小 `cosmic-api-knowledge.py` 的搜索范围，不代表必须直接依赖原生 API；`封装文档` 和 `原生文档` 都应先读 `TL;DR`，确实需要时再展开全文。
+> **提示**：`入口类` 主要用于缩小 `kd_cosmic_api` 的搜索范围，不代表必须直接依赖原生 API；`封装文档` 和 `原生文档` 都应先读 `TL;DR`，确实需要时再展开全文。
 
 ---
 
@@ -140,7 +140,7 @@
 ### 基础资料 {#basedata}
 - **关键词**: 基础资料 / 管控策略 / 分配 / 个性化 / 客户 / 物料 / 供应商
 - **入口类**: `BaseDataServiceHelper` · `kd.bd.master.*`
-- **先读**: 先用 `cosmic-form-metadata.py` / `cosmic-basedata-query.py` 确认 `refType` / `entityId`
+- **先读**: 先用 `kd_cosmic_metadata` 确认 `refType` / `entityId`，实时基础资料值需项目侧证据
 - **兜底**: [sdk-dynamic-model-svc.md](../references/base/sdk/sdk-dynamic-model-svc.md)
 - **片段**: [BaseDataQuerySample](../assets/snippets/query/BaseDataQuerySample.java)
 
@@ -199,10 +199,10 @@
 
 ### 业务拓展点查询 {#business-extpoints}
 - **关键词**: 业务拓展点 / 业务扩展点 / SDK 扩展接口 / 扩展场景 / 扩展插件 / 二开接口 / Java 示例 / route extpoint
-- **入口脚本**: `scripts/cosmic-extpoints-query.py`
-- **先查**: `python3 <SKILL_ROOT>/scripts/cosmic-extpoints-query.py --config ok-cosmic.json get --keyword <业务关键词>`
-- **示例查询**: 默认不用 `--full`；只有当需要生成实现代码或查看返回中的 Java/代码示例时，才追加 `--full`
-- **后续验证**: 若 `--full` 返回中已有清晰 Java 示例代码（能识别 `implements` 接口、`@Override` 方法、参数与返回值），可先按示例生成，不强制立即调用 `cosmic-api-knowledge.py detail`；若示例缺失/不完整/签名仍不确定，再用 `detail <full.class.Name>` 确认
+- **入口工具**: `kd_search` / `kd_cosmic_api`
+- **先查**: 用业务关键词搜索随包知识、项目代码和扩展代码库
+- **示例查询**: 只有当需要生成实现代码或查看 Java/代码示例时，才展开参考实现全文
+- **后续验证**: 若参考实现中已有清晰 Java 示例代码（能识别 `implements` 接口、`@Override` 方法、参数与返回值），可先按示例生成；若示例缺失/不完整/签名仍不确定，再用 `kd_cosmic_api mode=detail query=<full.class.Name>` 或编译确认
 - **约束**: 仅用于定位标准产品预留的业务拓展点候选；不要误判为 OpenAPI 控制器、表单插件或操作插件；示例代码可作为优先参考，但示例不清晰时不得猜方法签名
 
 ---
@@ -215,8 +215,8 @@
    - "保存前校验 + 审核后下推 + 下推后在 BOTP 回写阶段更新来源" → 操作插件 + 转换插件 + 反写插件
    - "列表批量选中 + 弹窗编辑 + 保存" → 列表插件 + 表单插件 + 操作插件
 2. **纯后端逻辑（无 UI、无操作链）**：优先命中"查询与存取""基础资料""消息通知""并发上下文恢复"等能力卡片；仍不匹配时，再回到 `references/base/sdk/` 原生 SDK 文档。
-3. **用户想找标准产品预留扩展点**：优先命中 [`#business-extpoints`](#business-extpoints)，用业务关键词查候选接口，再用 `cosmic-api-knowledge.py detail` 校验签名。
-4. **仍无法匹配**：先用 `cosmic-api-knowledge.py search <关键词>` 搜索相关类，再向用户确认具体实现方向后动手。
+3. **用户想找标准产品预留扩展点**：优先命中 [`#business-extpoints`](#business-extpoints)，用业务关键词查候选接口，再用 `kd_cosmic_api mode=detail` 或编译校验签名。
+4. **仍无法匹配**：先用 `kd_cosmic_api mode=search query=<关键词>` 搜索相关类，再向用户确认具体实现方向后动手。
 5. **扩展代码库探索**（需 `ok-cosmic.json` 配置 `extensionRepos`）：
    用当前需求关键词在扩展代码库中搜索相关 Java 实现，
    作为实现参考但仍需遵守 ok-cosmic 规范。

package/vendor/kingdee-skills/ok-cosmic/rules/intent-routing.md

@@ -76,7 +76,7 @@
 | 用户常说的话 | 优先翻译为 | 对应矩阵 |
 |---|---|---|
 | 查业务拓展点 / 找业务扩展点 / 有没有标准扩展点 / SDK 扩展接口 / 扩展场景编码 / 业务扩展插件 / 给我拓展点 Java 示例 | 查询标准产品预留的业务拓展点候选 | [`#business-extpoints`](decision-matrix.md#business-extpoints) |
-| 查类 / 查方法 / 看签名 / 这个接口有哪些方法 | SDK API 事实查询 | 先走 `cosmic-api-knowledge.py`；已命中具体实现需求时再回到矩阵 |
+| 查类 / 查方法 / 看签名 / 这个接口有哪些方法 | SDK API 事实查询 | 先走 `kd_cosmic_api`；已命中具体实现需求时再回到矩阵 |
 
 ## 常见误判修正
 

package/vendor/kingdee-skills/ok-cosmic/rules/post-check.md

@@ -1,9 +1,9 @@
 # 生成后自动校验规则 (Post-Check)
 
-`cosmic-post-check.py` 是代码生成后的**统一检查入口**，自动选择最佳检查策略：
+KCode 的 `kd_check` + `kd_build` 是代码生成后的**统一检查入口**，自动选择可用检查策略：
 
-- **Gradle 项目** → 先执行 `./gradlew :module:compileJava` 真实编译，编译成功后继续执行 `cosmic-post-lint.py` 场景/风格校验
-- **非 Gradle 项目** → 直接回退到 `cosmic-post-lint.py` 静态校验（A/B/C 三层规则）
+- **Gradle 项目** → 优先执行项目编译命令或 `kd_build`，编译成功后继续执行 `kd_check` 场景/风格校验
+- **非 Gradle 项目** → 直接执行 `kd_check` 静态校验（A/B/C 三层规则中已迁移的部分）
 
 ## 触发条件
 
@@ -11,40 +11,41 @@
 
 ## 默认执行命令
 
-```bash
-python3 <SKILL_ROOT>/scripts/cosmic-post-check.py <生成的文件或目录> --fix-hint
+```text
+kd_check path=<生成的文件或目录>
+kd_build
 ```
 
-脚本自动判断：
+执行策略：
 1. 从目标文件路径**向上查找** `build.gradle` + `settings.gradle` 共存的目录
-2. 找到 → Gradle 编译（解析 `settings.gradle` 确定模块，执行 `./gradlew :module:compileJava`）
-3. 未找到 → 回退到 `cosmic-post-lint.py --fix-hint` 静态校验
+2. 找到 → 执行项目 Gradle/Maven 编译或 `kd_build`
+3. 未找到 → 回退到 `kd_check` 静态校验
 
 ## 严格模式（仅 post-lint 回退时生效）
 
 当用户明确要求"严格校验""模板升级治理""补事实来源留痕"时，再追加严格模式：
 
-```bash
-python3 <SKILL_ROOT>/scripts/cosmic-post-check.py <生成的文件或目录> --fix-hint --strict
+```text
+kd_check path=<生成的文件或目录>
 ```
 
 说明：
 
-- `--strict` 仅在非 Gradle 回退到 post-lint 时生效，额外检查 **C 层** 验证来源注释。
+- 严格模式下，除 `kd_check` 外还需要人工核对 **C 层** 验证来源注释。
 - Gradle 编译本身不区分严格/宽松——编译器检查的就是全部约束。
 
 ## 校验流程
 
 ```mermaid
 graph TB
-    A[生成代码] --> B[执行 cosmic-post-check.py]
+    A[生成代码] --> B[执行 kd_check]
     B --> C{Gradle 项目?}
-    C -->|否| D[post-lint 静态校验]
+    C -->|否| D[kd_check 静态校验]
     C -->|是| E{JAVA_HOME 兼容?}
-    E -->|否| F[post-lint + JDK 设置提示]
+    E -->|否| F[kd_check + JDK 设置提示]
     E -->|是| G[Gradle 编译]
     G -->|失败| H[修复代码 → 重新编译]
-    G -->|成功| I[继续 post-lint 场景/风格校验]
+    G -->|成功| I[继续 kd_check 场景/风格校验]
     I --> J[综合结果]
     D --> J
     F --> J
@@ -53,7 +54,7 @@ graph TB
     J -->|全部通过| M[完成]
 ```
 
-> **注意**：Gradle 编译成功后仍会串联执行 post-lint 的场景/风格校验（SCENE/STYLE/RESOURCE 等规则），编译器不检测这些业务约束。最终以两者综合结果为准。
+> **注意**：Gradle 编译成功后仍要执行 `kd_check` 的场景/风格校验，编译器不检测这些业务约束。最终以两者综合结果为准。
 
 ## 问题级别处理策略
 
@@ -74,9 +75,9 @@ graph TB
 
 补充说明：
 
-- SDK 类名、方法签名和 `@Override` 正确性改为**事前**通过 `cosmic-api-knowledge.py detail/search`、模板、cheat-sheet 或编译验证，不再由 post-lint 的 `API-*` 规则兜底。
+- SDK 类名、方法签名和 `@Override` 正确性改为**事前**通过 `kd_cosmic_api`、模板、cheat-sheet、项目 SDK 或编译验证，不再由事后 lint 的 `API-*` 规则兜底。
 - `SCENE-*` 与 `RESOURCE-*` 中既有明显硬错误，也可能包含偏治理的 warning；解释结果时要结合上下文，不要机械套标签。
-- 需要按 A 层（ERROR）处理的 SCENE/STYLE/RESOURCE 规则 ID，统一定义在 [a-layer-rules.json](a-layer-rules.json)（单一可信源），`cosmic-post-lint.py` 在运行时自动加载。如需新增/移除 A 层规则，直接编辑该 JSON 文件即可，无需改脚本代码。
+- 需要按 A 层（ERROR）处理的 SCENE/STYLE/RESOURCE 规则 ID，统一定义在 [a-layer-rules.json](a-layer-rules.json)（单一可信源）；KCode 会将其中高价值规则逐步迁移到 `kd_check`。
 - `VERIFY-*` 默认不作为当前交付阻断项；只有在 `--strict` 或用户明确要求治理时，才应提高关注度。
 
 ## 修复示例

package/vendor/kingdee-skills/ok-ksql/SKILL.md

@@ -10,11 +10,11 @@ description: "金蝶云苍穹 KSQL/SQL 数据修复与批量数据变更 Skill
 ## 路径约定
 
 - `<SKILL_ROOT>` = 当前 `SKILL.md` 所在目录（即 `skills/ok-ksql/`）
-- `<SKILL_ROOT>/scripts/ksql_lint.py` = 最终 SQL 静态检查脚本。
+- `kd_ksql_lint` = 最终 SQL 静态检查工具。
 
 ## 依赖关系
 
-- 本 Skill 不自带、不复制、不生成元数据脚本。
+- 本 Skill 不自带、不复制、不生成 Python 元数据脚本。
 - 表名、`dbKey`、字段类型、枚举/状态值、基础资料落库字段确认，统一依赖 `$ok-cosmic` 的元数据查询能力。
 - 如果 `$ok-cosmic` 不可用，且用户也没有提供已确认的元数据结果，必须停止并列出待确认项。
 
@@ -22,22 +22,22 @@ description: "金蝶云苍穹 KSQL/SQL 数据修复与批量数据变更 Skill
 
 处理任何 KSQL/SQL 数据修复请求时，必须先完整读取 [references/ksql-datafix.md](references/ksql-datafix.md)，并按其中“确认卡片”模板输出。
 
-## 辅助脚本
+## 辅助工具
 
-- 最终 SQL 文件生成后，优先运行 `python3 <SKILL_ROOT>/scripts/ksql_lint.py <SQL文件>` 做静态检查。
+- 最终 SQL 文件生成后，优先运行 `kd_ksql_lint path=<SQL文件>` 做静态检查。
 - 若 lint 输出 `ERROR`，必须修复 SQL 后再交付；若输出 `WARN`，必须按偏好修复或在结果中说明保留原因。
-- `ksql_lint.py` 会检查高风险项：无 `WHERE` 的 `UPDATE/DELETE`、非备份场景 `SELECT *`、备份语句/备份表命名、时间戳一致性、`EXISTS` 偏好、`NULL` 判断和 PostgreSQL 多表更新风格。
+- `kd_ksql_lint` 会检查高风险项：无 `WHERE` 的 `UPDATE/DELETE`、非备份场景 `SELECT *`、备份语句/备份表命名、时间戳一致性、`EXISTS` 偏好、`NULL` 判断和 PostgreSQL 多表更新风格。
 
 ## Step 0. 依赖预检
 
 1. 先使用 `$ok-cosmic` 完成其 Step 0 配置预检。
 2. 若 `$ok-cosmic` 预检返回 `ERROR`，不得生成最终 KSQL；只说明缺失配置，并把需要用户补齐的信息列入“待确认项”。
-3. 生成最终 KSQL 前，必须通过 `$ok-cosmic` 的元数据能力确认表名和字段名；具体命令以 `$ok-cosmic` 的脚本路由为准。
+3. 生成最终 KSQL 前，必须通过 `$ok-cosmic` / `kd_cosmic_metadata` 的元数据能力确认表名和字段名；具体命令以 `$ok-cosmic` 的 KCode 工具路由为准。
 
 ## 工作流硬约束
 
 1. 先拆解自然语言意图，明确目标对象、操作类型、目标字段、条件字段、新值来源和风险边界。
-2. 必须通过 `$ok-cosmic` 元数据能力（`cosmic-form-metadata.py --sql`）精确确认每个单据的表名和每个数据库字段名；用户给中文或英文都必须查。
+2. 必须通过 `$ok-cosmic` 元数据能力（`kd_cosmic_metadata sql=true`）精确确认每个单据的表名和每个数据库字段名；用户给中文或英文都必须查。
 3. 写 SQL 前必须先判断所有参与表的 `dbName` 是否一致；一致才按普通单库 SQL 处理，不一致就是分库/跨库场景。
 4. 分库/跨库场景不得直接生成普通更新 SQL；必须先让用户确认 dblink / postgres_fdw / 导出导入临时表等处理方式。
 5. 所有表名、`dbKey`、`dbName`、枚举值、状态值、基础资料落库字段全部确认后，才允许生成最终 KSQL。
@@ -51,7 +51,7 @@ description: "金蝶云苍穹 KSQL/SQL 数据修复与批量数据变更 Skill
 13. 所有确认卡片均为 `✔️` 后，最终必须在用户桌面生成 SQL 文本文件；任一卡片为 `✖️` 时，不生成文件。
 14. 默认使用 PostgreSQL 语法生成 SQL；除非用户明确指定其他数据库方言，否则不要输出其他方言写法。
 15. SQL 可读性偏好：成员关系/半连接条件默认使用 `IN`（值列表或子查询），避免使用 `EXISTS`；只有 `IN` 会改变语义或无法表达时才保留 `EXISTS`，并说明原因。
-16. 最终 SQL 文件生成后必须尽量运行 `ksql_lint.py`；如因环境限制无法运行，最终回复中说明未运行原因。
+16. 最终 SQL 文件生成后必须尽量运行 `kd_ksql_lint`；如因环境限制无法运行，最终回复中说明未运行原因。
 
 ## 输出要求
 
@@ -78,4 +78,4 @@ description: "金蝶云苍穹 KSQL/SQL 数据修复与批量数据变更 Skill
 - 时间：文件名里的分钟必须取当前生成时间，与备份表名时间戳保持一致。
 - 风格：SQL 文件使用 `-- ============================================` 分隔章节；文件开头写业务标题、关键条件和执行前提醒；SQL 关键字大写；文件末尾补充“字段映射（来自元数据）”。
 - 禁止：待确认项非空、任一确认卡片为 `✖️` 时，不得创建桌面文件。
-- 检查：文件生成后运行 `python3 <SKILL_ROOT>/scripts/ksql_lint.py <SQL文件>`，无 `ERROR` 后再交付。
+- 检查：文件生成后运行 `kd_ksql_lint path=<SQL文件>`，无 `ERROR` 后再交付。

package/vendor/kingdee-skills/ok-ksql/manifest.json

@@ -9,6 +9,7 @@
   "ignore": [
     ".DS_Store",
     "__pycache__/",
-    "*.pyc"
+    "*.pyc",
+    "*.py"
   ]
 }

package/vendor/kingdee-skills/ok-ksql/references/ksql-datafix.md

@@ -140,7 +140,7 @@
 ## 确认卡片 2：元数据确认
 
 - 确认状态：✔️/✖️
-- 已通过 `$ok-cosmic` 元数据能力确认：`cosmic-form-metadata.py --sql`
+- 已通过 `$ok-cosmic` 元数据能力确认：`kd_cosmic_metadata sql=true`
 - 实际查询命令/依据：
 - 确认结果：
 
@@ -254,7 +254,7 @@
 
 ## 生成 SQL 示例
 
-> 示例仅用于展示输出形态。示例里的表名、字段名、枚举值均假设已通过 `$ok-cosmic` 元数据能力（`cosmic-form-metadata.py --sql`）确认，真实生成时不得照搬。示例假设当前生成时间为 `202604301148`。
+> 示例仅用于展示输出形态。示例里的表名、字段名、枚举值均假设已通过 `$ok-cosmic` 元数据能力（`kd_cosmic_metadata sql=true`）确认，真实生成时不得照搬。示例假设当前生成时间为 `202604301148`。
 
 ### SQL 风格约定