@rishiqing/cli 0.1.3 → 0.1.5

package/package.json

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

package/rishiqing.openapi.json

@@ -2099,17 +2099,10 @@
               "schema": {
                 "type": "object",
                 "required": [
-                  "formId",
                   "flowApplicationId",
-                  "formName",
-                  "fields"
+                  "formName"
                 ],
                 "properties": {
-                  "formId": {
-                    "type": "string",
-                    "description": "表单id",
-                    "example": "form-001"
-                  },
                   "flowApplicationId": {
                     "type": "string",
                     "description": "流程应用id",
@@ -2126,16 +2119,9 @@
                     "items": {
                       "type": "object",
                       "required": [
-                        "fieldId",
-                        "fieldType",
                         "fieldName"
                       ],
                       "properties": {
-                        "fieldId": {
-                          "type": "string",
-                          "description": "表单字段id",
-                          "example": "field-001"
-                        },
                         "fieldType": {
                           "type": "string",
                           "description": "表单字段类型",
@@ -2152,12 +2138,10 @@
                 }
               },
               "example": {
-                "formId": "",
                 "flowApplicationId": "flowApp_019d246a38247515b5fd367f78188422",
                 "formName": "入职登记表",
                 "fields": [
                   {
-                    "fieldId": "",
                     "fieldType": "1",
                     "fieldName": "姓名"
                   }
@@ -8001,4 +7985,4 @@
   },
   "servers": [],
   "security": []
-}
+}

package/skills/rishiqing/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: rishiqing
-description: 当用户在 agent 对话中提到日事清、rsq、rishiqing，或提到项目、模块、卡片、任务、流程、多维表格、数据、流程应用、流程实例、步骤、表单、字段、审核项、审批、成员、负责人、执行人、参与人等日事清领域词汇时使用。此 skill 用于把这些自然语言快速识别为“要用 rsq-cli 操作日事清”，并优先通过 rsq-cli 的 describe、search、project、task、workflow、datasheet、contacts 等命令完成查询、创建、更新和编排。
+description: 当用户在 agent 对话中提到日事清、rsq、rishiqing，或提到项目、模块、卡片、任务、流程、多维表格、数据、流程应用、流程实例、步骤、表单、字段、审核项、审批、成员、负责人、执行人、参与人等日事清领域词汇时使用。此 skill 用于把这些自然语言快速识别为“要用 rsq-cli 操作日事清”，并优先通过 rsq-cli 的 describe、search 与 agent 包装命令完成查询、创建、更新和编排。
 metadata:
   requires:
     bins: ["rsq-cli"]
@@ -51,7 +51,8 @@ rsq-cli describe <module> <command> --json
 
 - 不确定命令名时，先 `search`
 - 确认到候选命令后，再 `describe` 看参数和 `requestBodySchema`
-- 需要姓名转用户 id 时，先 `rsq-cli contacts resolveUser --user-name <姓名> --json`
+- 真正执行时优先走 `rsq-cli agent <module> <command> ...`
+- 需要姓名转用户 id 时，先 `rsq-cli agent contacts resolveUser --user-name <姓名> --json`
 
 ### 3. 写操作先预览
 
@@ -61,13 +62,22 @@ rsq-cli describe <module> <command> --json
 --dry-run --json
 ```
 
+如果命令带 request body，优先使用 `--body-file <path>`，不要默认拼内联 `--body '<json>'`。
+
+原因：
+
+- 更稳定，避免不同 shell / Agent 运行环境下的引号和转义问题
+- 更适合较长 JSON 或多层对象
+
 确认参数结构正确后再正式执行。
 
 ## 固定约束
 
 - 所有 `...Id` / `...Ids` 一律按字符串 id 传递
 - 不要传数字 id，也不要传纯数字字符串
-- 组装 `--body` 前先读 `requestBodySchema`
+- 组装 request body 前先读 `requestBodySchema`
+- 有 request body 时优先写入临时 JSON 文件并通过 `--body-file` 传入
+- Agent 执行命令时优先使用 `rsq-cli agent <module> <command> ...`
 - 用户给的是中文业务词时，先做语义映射，不要要求用户先说出精确命令名
 - 若用户同时提到“流程 + 项目”，优先确认是否是在某个项目下创建 workflow 模块
 

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

@@ -33,7 +33,7 @@ metadata:
 示例：
 
 ```bash
-rsq-cli project createPlan --project-id <projectId> --body '{"name":"<流程名称>","type":"workflow"}' --json
+rsq-cli agent project createPlan --project-id <projectId> --body-file <request.json> --json
 ```
 
 记录返回的：
@@ -46,7 +46,7 @@ rsq-cli project createPlan --project-id <projectId> --body '{"name":"<流程名
 ### 1. 先查模板
 
 ```bash
-rsq-cli workflow listFlowApplicationTemplates --json
+rsq-cli agent workflow listFlowApplicationTemplates --json
 ```
 
 读取返回的：
@@ -80,7 +80,7 @@ rsq-cli workflow listFlowApplicationTemplates --json
 如果用户没有指定项目，调用独立流程应用创建接口：
 
 ```bash
-rsq-cli workflow createFlowApplication --body '{"flowApplicationTemplateId":"<templateId>","flowApplicationName":"<name>"}' --json
+rsq-cli agent workflow createFlowApplication --body-file <request.json> --json
 ```
 
 记录返回的：
@@ -90,7 +90,7 @@ rsq-cli workflow createFlowApplication --body '{"flowApplicationTemplateId":"<te
 如果用户指定了项目，则不要先调用 `createFlowApplication`，而是调用项目模块创建接口：
 
 ```bash
-rsq-cli project createPlan --project-id <projectId> --body '{"name":"<name>","type":"workflow"}' --json
+rsq-cli agent project createPlan --project-id <projectId> --body-file <request.json> --json
 ```
 
 然后记录：
@@ -159,7 +159,7 @@ rsq-cli project createPlan --project-id <projectId> --body '{"name":"<name>","ty
 如果用户给了具体人员姓名，先解析成 `userId`：
 
 ```bash
-rsq-cli contacts resolveUser --user-name 张三 --json
+rsq-cli agent contacts resolveUser --user-name 张三 --json
 ```
 
 再把 `userId` 填入 `auditInfoUsers`。
@@ -176,7 +176,9 @@ rsq-cli contacts resolveUser --user-name 张三 --json
 - 项目分支后续一律使用 `data.plan.flowApplicationId`，不要再额外创建一个独立流程应用
 - 优先使用现成模板，只有匹配不到时才走“标准模式”
 - “标准模式”下必须继续补步骤、表单、审核项
+- Agent 执行时优先走 `rsq-cli agent ...`
 - 写操作优先用 `--dry-run --json` 预览
+- 只要命令带 request body，优先用 `--body-file`，不要默认用内联 `--body`
 - 不要伪造 `userId`
 - 如果模板匹配存在多个候选且无法判断唯一最佳项，先向用户确认
 - 如果用户只给了一个短名称，也要尽量结合常见业务场景做合理推断

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

@@ -5,7 +5,7 @@
 如果用户指定了项目，先创建模块：
 
 ```bash
-rsq-cli project createPlan --project-id <projectId> --body '{"name":"<流程名称>","type":"workflow"}' --json
+rsq-cli agent project createPlan --project-id <projectId> --body-file <request.json> --json
 ```
 
 记录：
@@ -20,7 +20,7 @@ rsq-cli project createPlan --project-id <projectId> --body '{"name":"<流程名
 ## 1. 模板匹配
 
 ```bash
-rsq-cli workflow listFlowApplicationTemplates --json
+rsq-cli agent workflow listFlowApplicationTemplates --json
 ```
 
 目标：
@@ -31,7 +31,7 @@ rsq-cli workflow listFlowApplicationTemplates --json
 ## 2. 创建流程应用
 
 ```bash
-rsq-cli workflow createFlowApplication --body '{"flowApplicationTemplateId":"<templateId>","flowApplicationName":"<name>"}' --json
+rsq-cli agent workflow createFlowApplication --body-file <request.json> --json
 ```
 
 记录：
@@ -43,7 +43,7 @@ rsq-cli workflow createFlowApplication --body '{"flowApplicationTemplateId":"<te
 ## 3. 如果使用标准模式，先获取现有步骤锚点
 
 ```bash
-rsq-cli workflow listStepInfosByFlowApplicationId --flowapplication-id <flowApplicationId> --json
+rsq-cli agent workflow listStepInfosByFlowApplicationId --flowapplication-id <flowApplicationId> --json
 ```
 
 用途：
@@ -54,7 +54,7 @@ rsq-cli workflow listStepInfosByFlowApplicationId --flowapplication-id <flowAppl
 ## 4. 创建步骤
 
 ```bash
-rsq-cli workflow createStepInfo --body '{"flowApplicationId":"<flowApplicationId>","stepInfoName":"部门负责人审批","frontStepInfoId":"<anchorStepInfoId>"}' --json
+rsq-cli agent workflow createStepInfo --body-file <request.json> --json
 ```
 
 记录：
@@ -69,20 +69,20 @@ rsq-cli workflow createStepInfo --body '{"flowApplicationId":"<flowApplicationId
 - `formName`
 - `fields`
 
-不要凭空生成 `formId` 或 `fieldId`。如果 body 中存在这些字段，应该留空或不传。
+不要传 `formId` 或 `fieldId`。`createForm` 的请求体里只保留业务字段。
 
 ## 6. 把表单绑定到步骤
 
 创建表单后，调用：
 
 ```bash
-rsq-cli workflow updateStepInfo --step-info-id <stepInfoId> --body '{"flowApplicationId":"<flowApplicationId>","stepInfoName":"部门负责人审批","formId":"<formId>"}' --json
+rsq-cli agent workflow updateStepInfo --step-info-id <stepInfoId> --body-file <request.json> --json
 ```
 
 ## 7. 创建审核项
 
 ```bash
-rsq-cli workflow createAuditInfo --body '{"flowApplicationId":"<flowApplicationId>","stepInfoId":"<stepInfoId>","auditInfoName":"部门负责人审批","frontAuditInfoId":"","auditInfoUsers":["<userId>"]}' --json
+rsq-cli agent workflow createAuditInfo --body-file <request.json> --json
 ```
 
 如果没有明确人员：