From 6a9c19408e8f2086d60f9b9587c879d507dad45f Mon Sep 17 00:00:00 2001 From: ssw Date: Sat, 13 Jun 2026 08:40:08 +0800 Subject: [PATCH] =?UTF-8?q?=E7=88=B6=E7=9B=AE=E5=BD=95=20.claude=20?= =?UTF-8?q?=E6=A0=A1=E5=87=86:=20=E7=AC=A6=E5=8F=B7=E9=93=BE=E6=8E=A5=20da?= =?UTF-8?q?cli-ts=20+=2011=20=E6=8A=80=E8=83=BD=20+=201=20=E5=91=BD?= =?UTF-8?q?=E4=BB=A4=E5=8E=BB=20Java=20=E7=89=88=E5=BC=95=E7=94=A8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - skills/dacli-ts (新, 符号链接): -> ../../dacli/.claude/skills/dacli-ts v0.8.1 主技能唯一来源是 dacli/ 子项目, 父目录建符号链接避免重复维护 (实际修改: 478 行 SKILL.md + 601 行 troubleshooting.md 自动跟随子项目更新) - 11 SKILL.md: 批量替换过时引用 dacli-architecture → dacli-ts (form-development / form-fix / menu-configuration / code-generator / data-interface / data-management / data-screen / workflow-development / ssw-pack-init / platform-mechanism / troubleshooting) Java 版 dacli 归档后 (v0.7+) 'dacli-architecture' 已是死引用, 实际技能名 = 'dacli-ts' (v0.8.1 22 父命令 / 80+ 子命令) - commands/ssw-flow.md: 改 Java 版连字符命令 → TS 版空格嵌套 'dacli workflow-create --formId=X' (v0.6 Java 版, 不存在) → 'dacli workflow list/launch/approve' (v0.7+ TS 版, 见 dacli-ts 技能) 加 v0.7+ 校准注释 + 子命令列表 CLAUDE.md §11 严守: 替换的是技能路径引用 (通用) + 命令格式 (通用), 不写 tdc app / TDS 验证 / 盲点修复记录等应用特定信息 (那些入 doc/v0.8.1-changelog.md) Co-Authored-By: Claude --- commands/ssw-flow.md | 9 +++++++-- skills/backend-dev/SKILL.md | 4 ++-- skills/code-generator/SKILL.md | 2 +- skills/dacli-ts | 1 + skills/data-interface/SKILL.md | 4 ++-- skills/data-management/SKILL.md | 4 ++-- skills/data-screen/SKILL.md | 4 ++-- skills/form-development/SKILL.md | 4 ++-- skills/menu-configuration/SKILL.md | 2 +- skills/platform-mechanism/SKILL.md | 4 ++-- skills/ssw-pack-init/SKILL.md | 2 +- skills/troubleshooting/SKILL.md | 2 +- skills/workflow-development/SKILL.md | 4 ++-- 13 files changed, 26 insertions(+), 20 deletions(-) create mode 120000 skills/dacli-ts diff --git a/commands/ssw-flow.md b/commands/ssw-flow.md index 6460d9d..67bfcd2 100644 --- a/commands/ssw-flow.md +++ b/commands/ssw-flow.md @@ -20,9 +20,14 @@ autoTrigger: false ## dacli 工作流命令 +> **v0.7+ 校准**: Java 版 `dacli workflow-create` (连字符) 已迁移到 TS 版 `dacli workflow <子>` (空格, 走 Commander.js 嵌套子命令) +> 当前 dacli v0.8.1 workflow 子命令: `list` / `launch` / `approve` (具体见 `dacli-ts` 技能 / `dacli workflow --help`) + ```bash -# 创建简单工作流 -dacli workflow-create --formId=<表单ID> --name=<流程名> --approvers=<审批人ID> +# TS 版创建工作流 (v0.7+, 注意是空格不是连字符) +dacli workflow list +dacli workflow launch --flowId=<流程模板ID> # 发起工作流 +dacli workflow approve --taskId=<待办ID> # 审批 ``` ## 流程类型 diff --git a/skills/backend-dev/SKILL.md b/skills/backend-dev/SKILL.md index de8cb21..36c77d0 100644 --- a/skills/backend-dev/SKILL.md +++ b/skills/backend-dev/SKILL.md @@ -23,7 +23,7 @@ description: "后端业务类开发技能。业务操作类命名、代码生成 > ⚠️ 复杂场景可使用 Python 脚本,但优先考虑 dacli。 > -> 📦 **dacli 已完成 Picocli 完整迁移 (2026-06-05)**:所有命令 `dacli --help` 自动生成精准 help。详见 `dacli-architecture` 技能。 +> 📦 **dacli 已完成 Picocli 完整迁移 (2026-06-05)**:所有命令 `dacli --help` 自动生成精准 help。详见 `dacli-ts` 技能。 使用 dacli 验证数据接口: @@ -363,4 +363,4 @@ dacli apis info "POST /api/xxx/xxx" dacli codegraph trace "jnpf.X::Controller::method" "jnpf.Y::ServiceImpl::method" ``` -> 详细:`dacli-codegraph` / `dacli-architecture` 技能。命令自身支持 `--help` 动态查参数。 +> 详细:`dacli-codegraph` / `dacli-ts` 技能。命令自身支持 `--help` 动态查参数。 diff --git a/skills/code-generator/SKILL.md b/skills/code-generator/SKILL.md index 7cd43a4..1d08acf 100644 --- a/skills/code-generator/SKILL.md +++ b/skills/code-generator/SKILL.md @@ -5,7 +5,7 @@ description: "JNPF 可视化开发代码生成技能。使用 dacli CLI 操作 # 代码生成技能(JNPF + dacli) -> 📦 **dacli codegen 已迁移到 Picocli (2026-06-05)**:`dacli codegen --help` 自动生成。`--formId/--module/--generate` 参数语义不变。详见 `dacli-architecture` 技能。 +> 📦 **dacli codegen 已迁移到 Picocli (2026-06-05)**:`dacli codegen --help` 自动生成。`--formId/--module/--generate` 参数语义不变。详见 `dacli-ts` 技能。 ## ⚠️ 强制规则 diff --git a/skills/dacli-ts b/skills/dacli-ts new file mode 120000 index 0000000..0506a1f --- /dev/null +++ b/skills/dacli-ts @@ -0,0 +1 @@ +../../dacli/.claude/skills/dacli-ts \ No newline at end of file diff --git a/skills/data-interface/SKILL.md b/skills/data-interface/SKILL.md index 8d93d94..ca5ce40 100644 --- a/skills/data-interface/SKILL.md +++ b/skills/data-interface/SKILL.md @@ -5,7 +5,7 @@ description: "JNPF 数据接口开发技能。3 类接口(SQL 操作 / 静态 # 数据接口开发技能(JNPF + dacli) -> 📦 **dacli di 已迁移到 Picocli (2026-06-05)**:`DiCommand` 含 `list/create/preview` 3 个子命令,全部走静态嵌套类,`dacli di --help` 自动生成。详见 `dacli-architecture` 技能。 +> 📦 **dacli di 已迁移到 Picocli (2026-06-05)**:`DiCommand` 含 `list/create/preview` 3 个子命令,全部走静态嵌套类,`dacli di --help` 自动生成。详见 `dacli-ts` 技能。 ## 触发词 @@ -206,4 +206,4 @@ DI_ID=$(curl -s -X POST http://nginx/api/system/DataInterface \ - [data-management](./data-management.md) — DI 引用的物理表 CRUD(`dacli dm`) - [backend-dev](./backend-dev.md) — DI SQL 满足不了时走后端 `ssw-{app_code}` 业务模块 - [troubleshooting](./troubleshooting.md) — preview NPE、参数无效、SQL 注入等问题 -- [dacli-architecture](./dacli-architecture.md) — `dacli di` Picocli 架构与 `DacliKit` 工具类 +- [dacli-ts](./dacli-ts.md) — `dacli di` Picocli 架构与 `DacliKit` 工具类 diff --git a/skills/data-management/SKILL.md b/skills/data-management/SKILL.md index 5be559e..488eca1 100644 --- a/skills/data-management/SKILL.md +++ b/skills/data-management/SKILL.md @@ -6,7 +6,7 @@ type: skill # 数据模型管理技能(JNPF + dacli) -> 📦 **dacli dm 已迁移到 Picocli (2026-06-05)**:`dacli dm --help` 自动生成精准 help。`dacli dm` 共 6 个子命令(list/table/query/create/update/drop),全部走 `DacliKit` 静态工具类,详见 `dacli-architecture` 技能。 +> 📦 **dacli dm 已迁移到 Picocli (2026-06-05)**:`dacli dm --help` 自动生成精准 help。`dacli dm` 共 6 个子命令(list/table/query/create/update/drop),全部走 `DacliKit` 静态工具类,详见 `dacli-ts` 技能。 ## 何时使用 @@ -263,5 +263,5 @@ dacli dm create --table=ct_child_demo --tableName="主子表演示-子" \ - **`form-development`** — `dacli form create --autoTable=true` 内部调 `dm create` - **`data-interface`** — DI 数据接口 `dacli di create --table=X` 引用 dm 表作为数据源 -- **`dacli-architecture`** — 了解 `DacliKit.getDbLinkId` 内部逻辑 +- **`dacli-ts`** — 了解 `DacliKit.getDbLinkId` 内部逻辑 - **`basic-standards`** — 字段命名/类型规范详情 diff --git a/skills/data-screen/SKILL.md b/skills/data-screen/SKILL.md index 021c944..f48c4cb 100644 --- a/skills/data-screen/SKILL.md +++ b/skills/data-screen/SKILL.md @@ -6,7 +6,7 @@ type: skill # 数据大屏 / 可视化门户技能(JNPF + dacli) -> 📦 **dacli portal 已迁移到 Picocli (2026-06-05)**:`PortalCommand` + list/create 2 个子命令。`dacli portal --help` 自动生成。详见 `dacli-architecture` 技能。 +> 📦 **dacli portal 已迁移到 Picocli (2026-06-05)**:`PortalCommand` + list/create 2 个子命令。`dacli portal --help` 自动生成。详见 `dacli-ts` 技能。 ## 触发词 @@ -124,5 +124,5 @@ visual_id=$(dacli portal create --name="运营监控" --enCode=ops_monitor --typ - **data-interface**:大屏图表的数据来自数据接口,3 类型(SQL/静态/API)模板见该技能 - **form-development**:大屏 KPI 卡可引用表单聚合数据,先建表单再 DI 汇总 - **menu-configuration**:大屏可通过菜单挂载(type=7 + 独立 URL)到侧边栏入口 -- **dacli-architecture**:`dacli portal` 命令的 Picocli 实现细节 +- **dacli-ts**:`dacli portal` 命令的 Picocli 实现细节 - **dacli apis**:查 `/api/visualdev/Portal` 接口 schema 时用 `dacli apis info "GET /api/visualdev/Portal"` diff --git a/skills/form-development/SKILL.md b/skills/form-development/SKILL.md index bb9a00a..c621101 100644 --- a/skills/form-development/SKILL.md +++ b/skills/form-development/SKILL.md @@ -5,7 +5,7 @@ description: "JNPF 可视化表单开发技能。使用 dacli CLI 操作。" # 表单开发技能(JNPF + dacli) -> 📦 **dacli form 已迁移到 Picocli (2026-06-05)**:`dacli form --help` 现在自动生成精准 help,参数语义不变。`dacli form list/info/create/release/delete` 全部走 Picocli。详见 `dacli-architecture` 技能。 +> 📦 **dacli form 已迁移到 Picocli (2026-06-05)**:`dacli form --help` 现在自动生成精准 help,参数语义不变。`dacli form list/info/create/release/delete` 全部走 Picocli。详见 `dacli-ts` 技能。 ## 核心流程 @@ -215,7 +215,7 @@ dacli apis info "POST /api/visualdev/OnlineDev/{modelId}" dacli codegraph search "VisualdevModelData" -k class -l java ``` -> 详细:`dacli-codegraph` / `dacli-architecture` 技能。 +> 详细:`dacli-codegraph` / `dacli-ts` 技能。 --- diff --git a/skills/menu-configuration/SKILL.md b/skills/menu-configuration/SKILL.md index fe553c8..ddd900e 100644 --- a/skills/menu-configuration/SKILL.md +++ b/skills/menu-configuration/SKILL.md @@ -5,7 +5,7 @@ description: "JNPF 菜单配置技能。使用 dacli CLI 操作。" # 菜单配置技能(JNPF + dacli) -> 📦 **dacli menu 已迁移到 Picocli (2026-06-05)**:`MenuCommand` + 10 个子命令(list/info/create/update/delete/cleanup/move/clone/export/import)。`--fixDisplay=true` 一键修复菜单不显示仍支持。详见 `dacli-architecture` 技能。 +> 📦 **dacli menu 已迁移到 Picocli (2026-06-05)**:`MenuCommand` + 10 个子命令(list/info/create/update/delete/cleanup/move/clone/export/import)。`--fixDisplay=true` 一键修复菜单不显示仍支持。详见 `dacli-ts` 技能。 > > 📦 **dacli menu 新增 4 子命令 (2026-06-09)**:`move`(改 parentId)/ `clone`(单/级联复制)/ `export`(JSON)/ `import`(JSON 恢复)。JNPF POST 不返 ID,命令内部按 enCode 轮询查。详见下文「菜单备份与恢复」。 diff --git a/skills/platform-mechanism/SKILL.md b/skills/platform-mechanism/SKILL.md index 69fc5ee..0874402 100644 --- a/skills/platform-mechanism/SKILL.md +++ b/skills/platform-mechanism/SKILL.md @@ -7,7 +7,7 @@ description: "JNPF 平台核心机制技能。app_code、system_id、发布流 ## dacli 命令 -> 📦 **架构变更 (2026-06-05)**: dacli 已迁移到 Picocli。`--help` 自动生成更精准,dacli 内部用 `DacliKit` 静态工具类替换了 `BaseCommand`。详见 `dacli-architecture` 技能。 +> 📦 **架构变更 (2026-06-05)**: dacli 已迁移到 Picocli。`--help` 自动生成更精准,dacli 内部用 `DacliKit` 静态工具类替换了 `BaseCommand`。详见 `dacli-ts` 技能。 ```bash # 查看登录状态 @@ -130,7 +130,7 @@ JNPF runtime `OnlineSwapDataUtils.swapDatetime` 当 form **无 date 字段**时 | `dacli codegraph` | 查 JNPF 平台 14 万 + 类/方法/调用链(基于 codegraph.db) | > 工作流范式:API 不确定 → `dacli apis info`;实现不确定 → `dacli codegraph trace`;改动前评估 → `dacli codegraph impact --group`。 -> 详细:`dacli-codegraph` / `dacli-architecture` 技能。 +> 详细:`dacli-codegraph` / `dacli-ts` 技能。 ## 详细参考 diff --git a/skills/ssw-pack-init/SKILL.md b/skills/ssw-pack-init/SKILL.md index 068ba9e..936d59f 100644 --- a/skills/ssw-pack-init/SKILL.md +++ b/skills/ssw-pack-init/SKILL.md @@ -5,7 +5,7 @@ description: "boot 模块编译打包、ssw-{app_code} 业务包创建与修复 # boot 模块编译打包 / ssw-{app_code} 业务包创建 -> 📦 **dacli 架构变更 (2026-06-05)**: 详见 `dacli-architecture` 技能。`dacli codegen` 现已迁移到 Picocli 形式(`CodegenCommandWrapper.java`),`--formId/--module/--generate` 参数与之前一致。 +> 📦 **dacli 架构变更 (2026-06-05)**: 详见 `dacli-ts` 技能。`dacli codegen` 现已迁移到 Picocli 形式(`CodegenCommandWrapper.java`),`--formId/--module/--generate` 参数与之前一致。 ## 编译打包 diff --git a/skills/troubleshooting/SKILL.md b/skills/troubleshooting/SKILL.md index e6ce0aa..70a4cc4 100644 --- a/skills/troubleshooting/SKILL.md +++ b/skills/troubleshooting/SKILL.md @@ -5,7 +5,7 @@ description: "JNPF 故障排查技能。根据症状快速定位问题。" # 故障排查技能(JNPF) -> 📦 **dacli 已完成 Picocli 完整迁移 (2026-06-05)**:详见 `dacli-architecture` 技能。命令语法完全兼容,内部架构已极简(DacliKit 静态工具类 + 100+ @Command 类,无 BaseCommand)。 +> 📦 **dacli 已完成 Picocli 完整迁移 (2026-06-05)**:详见 `dacli-ts` 技能。命令语法完全兼容,内部架构已极简(DacliKit 静态工具类 + 100+ @Command 类,无 BaseCommand)。 ## dacli 排查 diff --git a/skills/workflow-development/SKILL.md b/skills/workflow-development/SKILL.md index 76135c3..ec3067c 100644 --- a/skills/workflow-development/SKILL.md +++ b/skills/workflow-development/SKILL.md @@ -5,7 +5,7 @@ description: "JNPF Flowable 工作流开发:dacli workflow 6 子命令(list/ # 工作流开发技能(JNPF + Flowable + dacli) -> 📦 **dacli workflow 已迁移到 Picocli (2026-06-05)**:`WorkflowCommand` + 6 个子命令,`dacli workflow --help` 自动生成。详见 `dacli-architecture` 技能。 +> 📦 **dacli workflow 已迁移到 Picocli (2026-06-05)**:`WorkflowCommand` + 6 个子命令,`dacli workflow --help` 自动生成。详见 `dacli-ts` 技能。 ## 何时使用 @@ -152,6 +152,6 @@ dacli 无法直接配会签,需在 JNPF 设计器: - [form-development](./form-development/SKILL.md) - 表单启用 `enableFlow=1` + `flowTemplateJson` 绑定 - [menu-configuration](./menu-configuration.md) - 流程发起菜单挂载 -- [dacli-architecture](./dacli-architecture/SKILL.md) - Picocli 嵌套类架构 +- [dacli-ts](./dacli-ts/SKILL.md) - Picocli 嵌套类架构 - [troubleshooting](./troubleshooting/SKILL.md) - 工作流不生效排查 - [platform-mechanism](./platform-mechanism/SKILL.md) - app_code/systemId 机制