@rishiqing/cli 0.1.0

package/rsq-cli.config.json

@@ -0,0 +1,3 @@
+{
+  "baseUrl": "https://www.rishiqing.com"
+}

package/skills/rishiqing/SKILL.md

@@ -0,0 +1,85 @@
+---
+name: rishiqing
+description: 当用户在 agent 对话中提到日事清、rsq、rishiqing，或提到项目、模块、卡片、任务、流程、多维表格、数据、流程应用、流程实例、步骤、表单、字段、审核项、审批、成员、负责人、执行人、参与人等日事清领域词汇时使用。此 skill 用于把这些自然语言快速识别为“要用 rsq-cli 操作日事清”，并优先通过 rsq-cli 的 describe、search、project、task、workflow、datasheet、contacts 等命令完成查询、创建、更新和编排。
+metadata:
+  requires:
+    bins: ["rsq-cli"]
+---
+
+# rishiqing
+
+用 `rsq-cli` 处理日事清领域的通用识别与命令路由。
+
+## 触发原则
+
+只要用户表达的对象或动作明显属于日事清域，就优先启用本 skill，而不是把请求当成泛化的项目管理或表格软件问题。
+
+高频触发词包括：
+
+- 日事清 / rsq / rishiqing
+- 项目 / 模块 / 卡片 / 任务
+- 流程 / 流程应用 / 流程实例 / 步骤
+- 表单 / 字段 / 审核项 / 审批
+- 多维表格 / 数据 / 数据表
+- 成员 / 负责人 / 执行人 / 参与人
+
+如果用户只说“建一个项目模块”“查某个流程实例”“给任务换负责人”“给表单加字段”，也默认这是日事清操作意图。
+
+## 工作方式
+
+### 1. 先把意图归到日事清模块
+
+优先按下面的语义分发：
+
+- `project`: 项目、模块、项目成员、项目概览、项目下计划
+- `task`: 任务、卡片、执行人、负责人、参与人、状态
+- `workflow`: 流程应用、流程实例、步骤、表单、字段、审核项、审批流
+- `datasheet`: 多维表格、表、记录、字段、数据
+- `contacts`: 按姓名解析用户、查成员
+
+### 2. 先查描述，再选命令
+
+优先使用：
+
+```bash
+rsq-cli describe --json
+rsq-cli search "<用户意图>" --json
+rsq-cli describe <module> <command> --json
+```
+
+规则：
+
+- 不确定命令名时，先 `search`
+- 确认到候选命令后，再 `describe` 看参数和 `requestBodySchema`
+- 需要姓名转用户 id 时，先 `rsq-cli contacts resolveUser --user-name <姓名> --json`
+
+### 3. 写操作先预览
+
+创建、更新、绑定、分配这类写操作优先加：
+
+```bash
+--dry-run --json
+```
+
+确认参数结构正确后再正式执行。
+
+## 固定约束
+
+- 所有 `...Id` / `...Ids` 一律按字符串 id 传递
+- 不要传数字 id，也不要传纯数字字符串
+- 组装 `--body` 前先读 `requestBodySchema`
+- 用户给的是中文业务词时，先做语义映射，不要要求用户先说出精确命令名
+- 若用户同时提到“流程 + 项目”，优先确认是否是在某个项目下创建 workflow 模块
+
+## 常见路由示例
+
+- “在某个项目下建流程应用” -> `project` + `workflow`
+- “给任务换执行人” -> `task` + `contacts`
+- “新增一个多维表字段” -> `datasheet`
+- “查某个流程现在到哪个步骤” -> `workflow`
+- “把张三加到项目里” -> `contacts` + `project`
+
+## 边界
+
+本 skill 负责“识别这是日事清请求，并把请求路由到 rsq-cli”。  
+如果用户明确要求“按业务场景自动创建完整流程应用”，继续使用或转到 [../rsq-workflow-createFlowApplication/SKILL.md](../rsq-workflow-createFlowApplication/SKILL.md)。

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

@@ -0,0 +1,182 @@
+---
+name: rsq-workflow-createFlowApplication
+description: 当用户要求“创建流程应用”“新建审批流程”“按场景搭一个流程”这类需求时使用。先匹配流程模板创建 flow application；若匹配不到模板，则回退到“标准模式”，并继续补齐步骤、表单、审核项，生成完整可用的流程应用。
+metadata:
+  requires:
+    bins: ["rsq-cli"]
+---
+
+# rsq-workflow-createFlowApplication
+
+用 `rsq-cli` 处理“按提示词创建流程应用”的完整编排。
+
+## 触发场景
+
+当用户表达以下意图时使用：
+
+- 创建流程应用
+- 新建审批流程
+- 按某个业务场景生成流程
+- 创建请假、报销、采购、发版、入职等流程
+
+## 固定流程
+
+### 0. 先判断是否要求在某个项目下创建
+
+如果用户明确说明了“在某个项目下创建”“在某个项目模块里创建流程”“挂到某个项目下面”，优先走项目分支：
+
+1. 先确认或定位 `projectId`
+2. 调用创建模块接口，且 `type` 固定传 `"workflow"`
+3. 从返回值中读取 `data.plan.flowApplicationId`
+4. 后续所有步骤、表单、审核项都基于这个 `flowApplicationId` 继续创建
+
+示例：
+
+```bash
+rsq-cli project createPlan --project-id <projectId> --body '{"name":"<流程名称>","type":"workflow"}' --json
+```
+
+记录返回的：
+
+- `data.plan.planId`
+- `data.plan.flowApplicationId`
+
+如果用户没有说明是在某个项目下创建，则沿用下面的独立流程应用创建方式。
+
+### 1. 先查模板
+
+```bash
+rsq-cli workflow listFlowApplicationTemplates --json
+```
+
+读取返回的：
+
+- `data[].flowApplicationTemplateId`
+- `data[].flowApplicationTemplateName`
+
+### 2. 优先按名称匹配模板
+
+按以下优先级匹配：
+
+1. `flowApplicationTemplateName` 精确匹配
+2. `flowApplicationTemplateName` 包含用户给出的流程名称
+3. 用户流程名称包含模板名称
+4. 关键词高度接近时做单一近似匹配
+
+如果只命中一个明显匹配模板，直接使用它的 `flowApplicationTemplateId`。
+
+### 3. 匹配不到时回退到“标准模式”
+
+如果没有明显模板匹配结果，固定选择：
+
+- `flowApplicationTemplateName == "标准模式"`
+
+拿它的 `flowApplicationTemplateId` 去创建流程应用。
+
+如果模板列表里找不到“标准模式”，停止并报告缺少兜底模板，不要自行猜测。
+
+### 4. 创建流程应用或项目下的 workflow 模块
+
+如果用户没有指定项目，调用独立流程应用创建接口：
+
+```bash
+rsq-cli workflow createFlowApplication --body '{"flowApplicationTemplateId":"<templateId>","flowApplicationName":"<name>"}' --json
+```
+
+记录返回的：
+
+- `data.flowApplicationId`
+
+如果用户指定了项目，则不要先调用 `createFlowApplication`，而是调用项目模块创建接口：
+
+```bash
+rsq-cli project createPlan --project-id <projectId> --body '{"name":"<name>","type":"workflow"}' --json
+```
+
+然后记录：
+
+- `data.plan.flowApplicationId`
+
+### 5. 非标准模式直接结束
+
+如果最终使用的是“匹配到的现成模板”，流程应用创建成功后通常直接结束。
+
+只有当用户明确要求继续自定义步骤、表单或审核项时，才继续往下改。
+
+### 6. 标准模式需要继续补全流程
+
+如果最终使用的是“标准模式”，继续执行：
+
+1. 根据用户给的流程名称理解业务场景
+2. 设计合理的步骤
+3. 为每个步骤创建表单
+4. 为每个步骤创建审核项
+5. 必要时把表单绑定回步骤
+
+不要只创建一个空流程应用就结束。
+
+## 标准模式下的编排顺序
+
+详细 API 顺序见 [references/api-sequence.md](references/api-sequence.md)。
+
+最低要求是：
+
+1. 确认当前已经拿到了正确的 `flowApplicationId`
+2. 查询当前流程步骤，找出可作为 `frontStepInfoId` 的锚点
+3. 逐个创建步骤
+4. 为每个步骤创建表单
+5. 用 `updateStepInfo` 绑定 `formId`
+6. 为每个步骤创建审核项
+
+## 业务理解规则
+
+标准模式下，不要机械地创建“步骤1/步骤2/步骤3”。
+
+要根据流程名称理解场景，例如：
+
+- 请假：发起申请 -> 部门审批 -> 人事确认
+- 报销：填写报销单 -> 部门审批 -> 财务审核
+- 采购：提交采购需求 -> 主管审批 -> 采购执行 -> 验收确认
+- 发版：发版申请 -> 研发审核 -> 测试确认 -> 运维发布
+- 入职：信息登记 -> 部门负责人审批 -> HR 办理 -> 入职确认
+
+常见模式参考 [references/scenario-patterns.md](references/scenario-patterns.md)。
+
+## 表单设计规则
+
+每个步骤都应有与场景匹配的表单，而不是空表单。
+
+至少保证：
+
+- 表单名称与步骤语义一致
+- 字段数量足够支撑步骤动作
+- 字段名称可读、业务上合理
+
+## 审核项设计规则
+
+每个审批步骤至少创建一个审核项。
+
+如果用户给了具体人员姓名，先解析成 `userId`：
+
+```bash
+rsq-cli contacts resolveUser --user-name 张三 --json
+```
+
+再把 `userId` 填入 `auditInfoUsers`。
+
+如果用户没有给出审批人姓名：
+
+- 可以按角色命名审核项，例如“部门负责人审批”“财务审核”“HR 审核”
+- 但不要伪造具体人员 ID
+- 在没有明确人员时，可以创建不含 `auditInfoUsers` 的审核项，或者按当前接口允许的最小有效结构创建
+
+## 约束
+
+- 如果用户明确指定了项目，必须先走 `project createPlan` 且 `type` 固定传 `"workflow"`
+- 项目分支后续一律使用 `data.plan.flowApplicationId`，不要再额外创建一个独立流程应用
+- 优先使用现成模板，只有匹配不到时才走“标准模式”
+- “标准模式”下必须继续补步骤、表单、审核项
+- 写操作优先用 `--dry-run --json` 预览
+- 不要伪造 `userId`
+- 如果模板匹配存在多个候选且无法判断唯一最佳项，先向用户确认
+- 如果用户只给了一个短名称，也要尽量结合常见业务场景做合理推断

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

@@ -0,0 +1,100 @@
+# API Sequence
+
+## 0. 先判断是否在项目下创建
+
+如果用户指定了项目，先创建模块：
+
+```bash
+rsq-cli project createPlan --project-id <projectId> --body '{"name":"<流程名称>","type":"workflow"}' --json
+```
+
+记录：
+
+- `data.plan.planId`
+- `data.plan.flowApplicationId`
+
+后续所有步骤、表单、审核项都使用这个 `flowApplicationId`。
+
+如果用户没有指定项目，再进入独立流程应用分支。
+
+## 1. 模板匹配
+
+```bash
+rsq-cli workflow listFlowApplicationTemplates --json
+```
+
+目标：
+
+- 找到最匹配模板
+- 或兜底找到 `"标准模式"`
+
+## 2. 创建流程应用
+
+```bash
+rsq-cli workflow createFlowApplication --body '{"flowApplicationTemplateId":"<templateId>","flowApplicationName":"<name>"}' --json
+```
+
+记录：
+
+- `flowApplicationId`
+
+如果用户已指定项目，则跳过这一步，不要重复创建独立流程应用。
+
+## 3. 如果使用标准模式，先获取现有步骤锚点
+
+```bash
+rsq-cli workflow listStepInfosByFlowApplicationId --flowapplication-id <flowApplicationId> --json
+```
+
+用途：
+
+- 找一个已有步骤作为第一条自定义步骤的 `frontStepInfoId`
+- 后续每新建一个步骤，就把新步骤的 `stepInfoId` 当作下一个步骤的 `frontStepInfoId`
+
+## 4. 创建步骤
+
+```bash
+rsq-cli workflow createStepInfo --body '{"flowApplicationId":"<flowApplicationId>","stepInfoName":"部门负责人审批","frontStepInfoId":"<anchorStepInfoId>"}' --json
+```
+
+记录：
+
+- `stepInfoId`
+
+## 5. 创建表单
+
+`createForm` 只需要传真实业务字段：
+
+- `flowApplicationId`
+- `formName`
+- `fields`
+
+不要凭空生成 `formId` 或 `fieldId`。如果 body 中存在这些字段，应该留空或不传。
+
+## 6. 把表单绑定到步骤
+
+创建表单后，调用：
+
+```bash
+rsq-cli workflow updateStepInfo --step-info-id <stepInfoId> --body '{"flowApplicationId":"<flowApplicationId>","stepInfoName":"部门负责人审批","formId":"<formId>"}' --json
+```
+
+## 7. 创建审核项
+
+```bash
+rsq-cli workflow createAuditInfo --body '{"flowApplicationId":"<flowApplicationId>","stepInfoId":"<stepInfoId>","auditInfoName":"部门负责人审批","frontAuditInfoId":"","auditInfoUsers":["<userId>"]}' --json
+```
+
+如果没有明确人员：
+
+- 保留 `auditInfoName`
+- 不要伪造用户 id
+
+## 建议顺序
+
+对每个步骤执行：
+
+1. `createStepInfo`
+2. `createForm`
+3. `updateStepInfo` 绑定 `formId`
+4. `createAuditInfo`

package/skills/rsq-workflow-createFlowApplication/references/scenario-patterns.md

@@ -0,0 +1,92 @@
+# Scenario Patterns
+
+以下是“标准模式”下的默认推断模板。不是硬编码规则，而是起步参考。
+
+## 请假
+
+步骤建议：
+
+1. 请假申请
+2. 部门负责人审批
+3. 人事确认
+
+字段建议：
+
+- 请假类型
+- 开始时间
+- 结束时间
+- 请假天数
+- 请假原因
+
+## 报销
+
+步骤建议：
+
+1. 报销申请
+2. 部门审批
+3. 财务审核
+
+字段建议：
+
+- 报销类型
+- 金额
+- 事由
+- 发生日期
+- 备注
+
+## 采购
+
+步骤建议：
+
+1. 采购申请
+2. 主管审批
+3. 采购执行
+4. 验收确认
+
+字段建议：
+
+- 采购物品
+- 数量
+- 预算
+- 用途
+- 期望到货时间
+
+## 发版
+
+步骤建议：
+
+1. 发版申请
+2. 研发审核
+3. 测试确认
+4. 运维发布
+
+字段建议：
+
+- 版本号
+- 发布环境
+- 变更说明
+- 风险说明
+- 回滚方案
+
+## 入职
+
+步骤建议：
+
+1. 信息登记
+2. 部门负责人审批
+3. HR 办理
+4. 入职确认
+
+字段建议：
+
+- 姓名
+- 部门
+- 岗位
+- 入职日期
+- 联系方式
+
+## 通用规则
+
+- 一般控制在 2 到 5 个步骤
+- 每个步骤名称都要能被业务人员直接看懂
+- 表单字段宁可少而准，不要堆很多无意义字段