斗湖云平台 Skill

⚡ 首次使用

定义：用户调用本工具，第一次发起请求时。

强制要求：首次处理用户请求时，必须先执行版本检查，再执行配置与认证，最后处理业务请求。

功能说明

用户意图识别与路由

意图路由表

| 用户意图类别 | 典型问题示例 | 状态 | 参考文档 | |-------------|-------------|------|---------| | 配置与认证 | 如何配置？如何登录？Token过期怎么办？ | ✅ 可用 | references/config.md | | 版本检查 | 当前版本是多少？有新版本吗？ | ✅ 可用 | skills/version-check.md | | 应用信息查询 | 我有哪些应用？获取某个应用的详情？ | ✅ 可用 | skills/app-info.md | | 表单结构探索 | 应用下有哪些表单？这张表有哪些字段？字段类型是什么？ | ✅ 可用 | skills/form-structure.md | | 表单权限查询 | 我能修改这张表吗？有哪些操作权限？ | ✅ 可用 | skills/form-permission.md | | 数据查询与详情 | 查询XX表单数据？查看某条数据详情？ | ✅ 可用 | skills/form-query.md | | 数据分析查询 | 按维度统计数据？计算汇总数据？生成报表？ | ✅ 可用 | skills/form-query.md | | 流程审批查询 | 查看某条申请的审批流程？谁审批的？当前批到哪了？ | ✅ 可用 | skills/flow-query.md | | 文件管理 | 上传附件？预览已上传文件？获取文件资源？ | ✅ 可用 | skills/file-management.md | | 问题反馈 | 提交问题反馈？反馈 bug / 建议？上报产品问题？检测到本 skill 文档有误需上报？ | ✅ 可用 ⭐必看 | skills/feedback.md | | 自上报 | 发现 skill 文档有误；或用户提了合理需求但当前能力不支持（常驻，不依赖意图命中） | ✅ 可用 | 见本文件「自上报（常驻）」 | | 组织架构查询 | 公司有哪些部门？某部门的详情/负责人？组织架构树？ | ✅ 可用 | skills/org-structure.md | | 角色管理 | 有哪些角色？某角色的权限？角色下有哪些成员？ | ✅ 可用 | skills/role-management.md | | 成员管理 | 公司有哪些员工？某部门/角色下的人？某人详情？ | ✅ 可用 | skills/member-management.md | | 页面生成 | 生成页面？做一个可视化页面？把查询结果展示成页面？ | ✅ 可用 | skills/page-generation.md | | 打印模板生成 | 生成某条数据的打印单？打印详情页？导出成可打印页面/PDF？ | ✅ 可用 | skills/page-print-detail.md |

兜底规则（未匹配意图）

若用户意图不在上表任何类别中，或无法归入现有能力，按以下方式处理：

说明原因：礼貌告知该能力当前平台尚未提供或本 SKILL 暂未覆盖，不要臆造接口或命令。
列出支持范围：向用户说明本 SKILL 当前支持的能力，便于用户调整诉求。
上报能力缺口：若用户需求合理且属于本产品应有方向（不是与平台无关的诉求），在完成上述告知后调用 feedback submit 上报，作为产品改进输入。命令见下方「自上报（常驻）」的 B 类。

列出支持范围时，请直接参考上方「意图路由表」中的所有类别（每行"用户意图类别"即一项已支持能力）。不要在此重复罗列具体功能——路由表新增类别后，本段自动覆盖，无需同步修改。

不在路由表范围内的需求（如工作流编排、消息通知、第三方集成等），可先说明当前能力范围暂未包含此类需求，并友好引导用户从路由表已有能力中选择。

"合理需求"的判断：用户诉求落在数据查询、表单管理、页面生成、流程审批、文件与组织成员管理等产品方向内，只是当前能力尚未覆盖 → 属合理需求，应上报。若诉求与平台定位无关（如让 AI 写诗、控制本地硬件）→ 无需上报。

自上报（常驻）

本节常驻上下文，与当前加载了哪个 skills/*.md 无关。两类情形均在完成当前用户任务之后调用 feedback submit 上报。

A. 文档缺陷

使用本技能过程中，发现 skills/*.md 或 references/*.md 存在缺陷（字段说明与实际接口不一致、参数示例错误、调用流程缺失）：

python scripts/feedback.py submit --params '{"title":"skill文档问题","description":"来源：skill 文档问题；<哪个文件的哪一处有问题>","suggestion":"<建议的正确内容>"}'

B. 能力缺口

用户提出的需求合理，但意图路由表与现有能力均无法满足（触发「兜底规则」）。这类"用户真需要、当前做不到"的情形是产品改进最重要的输入，不应只告知了事：

python scripts/feedback.py submit --params '{"title":"能力缺口：<需求一句话概括>","description":"来源：能力缺口；用户诉求：<用户原话或归纳>；当前无法支持的原因：<缺哪个能力>","suggestion":"建议新增：<期望的能力与用法>"}'

判断标准见「兜底规则」的"合理需求"说明。

规则：

先完成用户当前任务，再上报，不打断主流程。
title 为唯一必填项，description / suggestion 可选。
每次会话对同一问题或同一需求最多上报一次，避免重复。
完整参数与返回结构见 skills/feedback.md。

数据探索流程

当用户需要探索数据时，按以下步骤引导（命令均通过 CLI 执行）：

1. 获取应用列表 → python scripts/app.py list           参考 skills/app-info.md
2. 获取表单列表 → python scripts/form.py list          参考 skills/form-structure.md
3. 了解表单结构 → python scripts/form.py meta          参考 skills/form-structure.md
4. 查询数据 → python scripts/query.py list             参考 skills/form-query.md
5. 数据分析 → python scripts/query.py analyze          参考 skills/form-query.md
6. 流程审批 → 先 form-query detail 取 businessKey，再 python scripts/flow.py records  参考 skills/flow-query.md

字段类型参考

字段类型详细说明请参考 references/field-types/index.md

返回格式

所有 CLI 命令返回 JSON 格式：

成功：

{
  "code": 200,
  "message": "success",
  "data": {...}
}

失败：

{
  "code": 401,
  "message": "认证失败",
  "data": null
}

code 说明：

200: 成功
401: 认证失败
403: 无权限
404: 资源不存在
500: 服务器错误
其他: 业务错误

CLI 调用方式统一为 python scripts/<模块>.py <动作> --params '{JSON}'，详见 README.md。

展示规则

除非用户明确要求或调试需要，不要将 ID、唯一标识（如 appId、formId、dataId、userId、entId、recordId 等）直接展示给用户。
展示数据时应优先使用业务可读字段（如名称、标题、编号），ID 类字段仅用于内部传参与路由。
页面生成时，ID 字段默认不在界面上渲染，如需展示应征得用户确认。