@rishiqing/cli 0.1.5 → 0.1.7

package/generated/command-catalog.json

@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-04-08T09:29:10.864Z",
+  "generatedAt": "2026-04-10T09:03:02.172Z",
   "totalCommands": 54,
   "modules": [
     {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rishiqing/cli",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "Agent-oriented CLI for Rishiqing APIs",
   "license": "MIT",
   "type": "module",

package/rishiqing.openapi.json

@@ -1334,6 +1334,10 @@
                           "type": "string",
                           "description": "流程应用id",
                           "example": "flow-app-001"
+                        },
+                        "flowApplicationName": {
+                          "type": "string",
+                          "description": "流程应用名称"
                         }
                       }
                     },
@@ -1626,11 +1630,6 @@
               "schema": {
                 "type": "object",
                 "properties": {
-                  "flowApplicationId": {
-                    "type": "string",
-                    "description": "流程应用名称",
-                    "example": "flow-app-001"
-                  },
                   "stepInfoName": {
                     "type": "string",
                     "description": "步骤名称",
@@ -1640,6 +1639,13 @@
                     "type": "string",
                     "description": "表单id",
                     "example": "form-001"
+                  },
+                  "executorUsers": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    },
+                    "description": "步骤执行人列表，里面包含执行人id"
                   }
                 }
               },
@@ -1988,9 +1994,6 @@
             "application/json": {
               "schema": {
                 "type": "object",
-                "required": [
-                  "auditInfoName"
-                ],
                 "properties": {
                   "auditInfoName": {
                     "type": "string",
@@ -2138,10 +2141,12 @@
                 }
               },
               "example": {
+                "formId": "",
                 "flowApplicationId": "flowApp_019d246a38247515b5fd367f78188422",
                 "formName": "入职登记表",
                 "fields": [
                   {
+                    "fieldId": "",
                     "fieldType": "1",
                     "fieldName": "姓名"
                   }
@@ -2184,6 +2189,10 @@
                           "description": "流程表单id",
                           "example": "form-001"
                         },
+                        "formName": {
+                          "type": "string",
+                          "description": "流程表单名称"
+                        },
                         "fields": {
                           "type": "array",
                           "description": "流程表单字段",
@@ -7985,4 +7994,4 @@
   },
   "servers": [],
   "security": []
-}
+}

package/skills/rsq-workflow-createFlowApplication/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: rsq-workflow-createFlowApplication
-description: 当用户要求“创建流程应用”“新建审批流程”“按场景搭一个流程”这类需求时使用。先匹配流程模板创建 flow application；若匹配不到模板，则回退到“标准模式”，并继续补齐步骤、表单、审核项，生成完整可用的流程应用。
+description: 当用户要求“创建流程应用”“新建审批流程”“按场景搭一个流程”这类需求时使用。默认直接用“标准模式”创建；只有用户明确要求匹配模板时才查模板，匹配不到再回退到“标准模式”，并继续补齐步骤、表单、审核项，生成完整可用的流程应用。
 metadata:
   requires:
     bins: ["rsq-cli"]
@@ -43,7 +43,17 @@ rsq-cli agent project createPlan --project-id <projectId> --body-file <request.j
 
 如果用户没有说明是在某个项目下创建，则沿用下面的独立流程应用创建方式。
 
-### 1. 先查模板
+### 1. 默认直接走“标准模式”
+
+如果用户没有明确表达“按模板匹配”“看看有没有现成模板”“优先套用模板”这类意图：
+
+- 不要先查模板
+- 直接选择 `flowApplicationTemplateName == "标准模式"`
+- 用它的 `flowApplicationTemplateId` 创建流程应用
+
+如果当前环境里找不到“标准模式”，停止并报告缺少兜底模板，不要自行猜测。
+
+### 2. 用户明确要求匹配模板时，再查模板
 
 ```bash
 rsq-cli agent workflow listFlowApplicationTemplates --json
@@ -54,7 +64,7 @@ rsq-cli agent workflow listFlowApplicationTemplates --json
 - `data[].flowApplicationTemplateId`
 - `data[].flowApplicationTemplateName`
 
-### 2. 优先按名称匹配模板
+### 3. 优先按名称匹配模板
 
 按以下优先级匹配：
 
@@ -65,9 +75,9 @@ rsq-cli agent workflow listFlowApplicationTemplates --json
 
 如果只命中一个明显匹配模板，直接使用它的 `flowApplicationTemplateId`。
 
-### 3. 匹配不到时回退到“标准模式”
+### 4. 匹配不到时回退到“标准模式”
 
-如果没有明显模板匹配结果，固定选择：
+如果用户明确要求匹配模板，但没有明显模板匹配结果，固定选择：
 
 - `flowApplicationTemplateName == "标准模式"`
 
@@ -75,7 +85,7 @@ rsq-cli agent workflow listFlowApplicationTemplates --json
 
 如果模板列表里找不到“标准模式”，停止并报告缺少兜底模板，不要自行猜测。
 
-### 4. 创建流程应用或项目下的 workflow 模块
+### 5. 创建流程应用或项目下的 workflow 模块
 
 如果用户没有指定项目，调用独立流程应用创建接口：
 
@@ -97,36 +107,41 @@ rsq-cli agent project createPlan --project-id <projectId> --body-file <request.j
 
 - `data.plan.flowApplicationId`
 
-### 5. 非标准模式直接结束
+### 6. 非标准模式直接结束
 
 如果最终使用的是“匹配到的现成模板”，流程应用创建成功后通常直接结束。
 
 只有当用户明确要求继续自定义步骤、表单或审核项时，才继续往下改。
 
-### 6. 标准模式需要继续补全流程
+### 7. 标准模式需要继续补全流程
 
 如果最终使用的是“标准模式”，继续执行：
 
 1. 根据用户给的流程名称理解业务场景
 2. 设计合理的步骤
-3. 为每个步骤创建表单
-4. 为每个步骤创建审核项
-5. 必要时把表单绑定回步骤
+3. 先读取流程应用默认生成的步骤列表
+4. 如果已经有一个默认创建的“未命名步骤”，且用户明确描述了要创建哪些步骤，则优先把这个“未命名步骤”更新为用户需要的第一个步骤，而不是再额外新建一个重复的首步骤
+5. 从第二个业务步骤开始继续往后创建步骤
+6. 为每个步骤创建表单
+7. 为每个步骤创建审核项
+8. 必要时把表单绑定回步骤
 
 不要只创建一个空流程应用就结束。
 
 ## 标准模式下的编排顺序
 
 详细 API 顺序见 [references/api-sequence.md](references/api-sequence.md)。
+字段类型识别见 [references/field-types.md](references/field-types.md)。
 
 最低要求是：
 
 1. 确认当前已经拿到了正确的 `flowApplicationId`
-2. 查询当前流程步骤，找出可作为 `frontStepInfoId` 的锚点
-3. 逐个创建步骤
-4. 为每个步骤创建表单
-5. 用 `updateStepInfo` 绑定 `formId`
-6. 为每个步骤创建审核项
+2. 查询当前流程步骤，识别系统默认创建的“未命名步骤”
+3. 如果用户明确给出了步骤列表，先用 `updateStepInfo` 把这个“未命名步骤”改成第一个业务步骤，并绑定它的表单
+4. 从第二个业务步骤开始逐个创建步骤，`frontStepInfoId` 接在上一个已落地步骤后面
+5. 为每个步骤创建表单
+6. 用 `updateStepInfo` 绑定 `formId`
+7. 为每个步骤创建审核项
 
 ## 业务理解规则
 
@@ -151,6 +166,8 @@ rsq-cli agent project createPlan --project-id <projectId> --body-file <request.j
 - 表单名称与步骤语义一致
 - 字段数量足够支撑步骤动作
 - 字段名称可读、业务上合理
+- 创建字段前先按 [references/field-types.md](references/field-types.md) 映射 `fieldType`
+- 字段名无法唯一推出类型时，必须依赖用户显式指定的类型，不要自行脑补
 
 ## 审核项设计规则
 
@@ -174,8 +191,10 @@ rsq-cli agent contacts resolveUser --user-name 张三 --json
 
 - 如果用户明确指定了项目，必须先走 `project createPlan` 且 `type` 固定传 `"workflow"`
 - 项目分支后续一律使用 `data.plan.flowApplicationId`，不要再额外创建一个独立流程应用
-- 优先使用现成模板，只有匹配不到时才走“标准模式”
+- 如果用户没有明确要求匹配模板，默认不要查模板，直接使用“标准模式”
+- 只有用户明确要求匹配模板时，才去查模板；匹配不到再回退到“标准模式”
 - “标准模式”下必须继续补步骤、表单、审核项
+- 流程应用创建后如果系统默认生成了一个“未命名步骤”，且用户明确给了步骤定义，必须优先复用它作为第一个业务步骤，不要再额外创建一个重复的首步骤
 - Agent 执行时优先走 `rsq-cli agent ...`
 - 写操作优先用 `--dry-run --json` 预览
 - 只要命令带 request body，优先用 `--body-file`，不要默认用内联 `--body`

package/skills/rsq-workflow-createFlowApplication/references/api-sequence.md

@@ -17,7 +17,17 @@ rsq-cli agent project createPlan --project-id <projectId> --body-file <request.j
 
 如果用户没有指定项目，再进入独立流程应用分支。
 
-## 1. 模板匹配
+## 1. 默认直接使用“标准模式”
+
+如果用户没有明确要求“匹配模板”：
+
+- 不查模板列表
+- 直接使用 `"标准模式"` 对应的 `flowApplicationTemplateId`
+- 然后进入创建流程应用步骤
+
+只有在当前环境里尚未缓存“标准模式”模板 id，或者用户明确要求匹配模板时，才需要查询模板列表。
+
+## 2. 用户明确要求匹配模板时，再做模板匹配
 
 ```bash
 rsq-cli agent workflow listFlowApplicationTemplates --json
@@ -28,7 +38,9 @@ rsq-cli agent workflow listFlowApplicationTemplates --json
 - 找到最匹配模板
 - 或兜底找到 `"标准模式"`
 
-## 2. 创建流程应用
+如果用户没有明确要求匹配模板，就跳过这一节。
+
+## 3. 创建流程应用
 
 ```bash
 rsq-cli agent workflow createFlowApplication --body-file <request.json> --json
@@ -40,7 +52,7 @@ rsq-cli agent workflow createFlowApplication --body-file <request.json> --json
 
 如果用户已指定项目，则跳过这一步，不要重复创建独立流程应用。
 
-## 3. 如果使用标准模式，先获取现有步骤锚点
+## 4. 如果使用标准模式，先获取现有步骤并识别默认步骤
 
 ```bash
 rsq-cli agent workflow listStepInfosByFlowApplicationId --flowapplication-id <flowApplicationId> --json
@@ -48,10 +60,26 @@ rsq-cli agent workflow listStepInfosByFlowApplicationId --flowapplication-id <fl
 
 用途：
 
-- 找一个已有步骤作为第一条自定义步骤的 `frontStepInfoId`
+- 识别系统默认创建的“未命名步骤”
+- 如果用户明确给了步骤列表，优先复用这个“未命名步骤”作为第一个业务步骤
+- 只有从第二个业务步骤开始，才继续调用 `createStepInfo`
 - 后续每新建一个步骤，就把新步骤的 `stepInfoId` 当作下一个步骤的 `frontStepInfoId`
 
-## 4. 创建步骤
+## 5. 先更新默认步骤为第一个业务步骤
+
+```bash
+rsq-cli agent workflow updateStepInfo --step-info-id <defaultUnnamedStepInfoId> --body-file <request.json> --json
+```
+
+- 适用条件：
+
+  - 当前流程里确实存在默认“未命名步骤”
+  - 用户明确描述了第一个业务步骤是什么
+
+- 先为这个第一个业务步骤创建表单，再调用 `updateStepInfo` 同时写入 `stepInfoName` 和 `formId`
+- `stepInfoId` 只通过接口路径传入；`request.json` 里不要再传这个字段
+
+## 6. 从第二个业务步骤开始创建后续步骤
 
 ```bash
 rsq-cli agent workflow createStepInfo --body-file <request.json> --json
@@ -61,7 +89,7 @@ rsq-cli agent workflow createStepInfo --body-file <request.json> --json
 
 - `stepInfoId`
 
-## 5. 创建表单
+## 7. 创建表单
 
 `createForm` 只需要传真实业务字段：
 
@@ -69,9 +97,9 @@ rsq-cli agent workflow createStepInfo --body-file <request.json> --json
 - `formName`
 - `fields`
 
-不要传 `formId` 或 `fieldId`。`createForm` 的请求体里只保留业务字段。
+不要传 `formId` 或 `fieldId`。最新接口文档虽然在 example 里出现了空的 `formId` / `fieldId`，但 schema 并没有要求它们，`createForm` 的请求体里仍只保留业务字段。
 
-## 6. 把表单绑定到步骤
+## 8. 把表单绑定到步骤
 
 创建表单后，调用：
 
@@ -79,7 +107,10 @@ rsq-cli agent workflow createStepInfo --body-file <request.json> --json
 rsq-cli agent workflow updateStepInfo --step-info-id <stepInfoId> --body-file <request.json> --json
 ```
 
-## 7. 创建审核项
+对第一个业务步骤，如果复用了默认“未命名步骤”，这里的 `stepInfoId` 就是那个默认步骤的 id。
+`request.json` 里同样不要传 `stepInfoId`。
+
+## 9. 创建审核项
 
 ```bash
 rsq-cli agent workflow createAuditInfo --body-file <request.json> --json
@@ -90,9 +121,19 @@ rsq-cli agent workflow createAuditInfo --body-file <request.json> --json
 - 保留 `auditInfoName`
 - 不要伪造用户 id
 
+如果后续要更新审核项，`auditInfoId` 只通过接口路径传入；请求体里不要再传这个字段。
+
 ## 建议顺序
 
-对每个步骤执行：
+如果默认走“标准模式”，并且存在默认“未命名步骤”且用户明确给了步骤列表：
+
+1. `listStepInfosByFlowApplicationId`
+2. 第一个业务步骤先 `createForm`
+3. 对默认步骤执行 `updateStepInfo`，写入首步骤名称和 `formId`
+4. 对首步骤执行 `createAuditInfo`
+5. 从第二个业务步骤开始执行后续创建
+
+对后续新建步骤执行：
 
 1. `createStepInfo`
 2. `createForm`

package/skills/rsq-workflow-createFlowApplication/references/field-types.md

@@ -0,0 +1,28 @@
+# Workflow Field Types
+
+创建流程表单字段时，`fieldType` 必须以 `FieldEnum.java` 转换后的 TS 枚举为准，不要凭经验猜测。
+
+高频字段：
+
+- `1`: 文本框
+- `2`: 数字
+- `5`: 日期
+- `6`: 附件
+- `15`: 富文本
+- `17`: 手机
+- `18`: 邮箱
+- `19`: 地址
+- `22`: 成员
+- `36`: 部门
+
+本次已确认的误判修正：
+
+- `附件` 不是文本框，必须用 `6`
+- `富文本` 不是普通文本框，必须用 `15`
+
+识别规则：
+
+- 用户直接说字段类型，例如“附件字段”“富文本字段”，优先按枚举中文名精确匹配。
+- 用户给出英文类型词，例如 `RichText`、`File`，按枚举 `valueText` 匹配。
+- 用户给的是带业务名的字段，例如“采购明细附件”，应从字段描述中识别出“附件”并映射到 `6`。
+- 若字段名本身无法唯一推出类型，例如“备注”“说明”“供应商对比”，必须结合用户上文指定的类型判断，不能自行猜测。