# qdbp-skills **Repository Path**: qdbp/qdbp-skills ## Basic Information - **Project Name**: qdbp-skills - **Description**: No description available - **Primary Language**: YAML - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-08 - **Last Updated**: 2026-11-08 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # Skills 收录可安装到支持 Skill 机制的 AI 客户端的技能。每个技能是一个独立文件夹, 内含 `SKILL.md` 作为核心定义文件 (YAML frontmatter + 使用说明), 可选的 `references/` 目录存放按需加载的参考文档。 ## 已收录技能 | 技能 | 说明 | |------|------| | `qdbp-tools` | Java 基础工具类库 qdbp-able/qdbp-tools 的 API 参考与真实项目使用示例: 字符串/类型转换/日期/校验/MapBuilder 声明式转换/文件与路径/编解码加解密/JSON/树形节点构建与操作/文本对比/比对两段多行文本并对齐排序等 40+ 工具类 | | `qdbp-staticize` | Java 模板静态化引擎 (JSTL 风格语法) 的 API 参考: 表达式语法 `${}`/`#{}`、core 内置标签、自定义标签库、TagParser 解析、Publisher 渲染、StaticizeTask 多线程批量静态化 | ## 目录规范 ``` qdbp-skills/ # 仓库根 ├── README.md # 本文件 ├── qdbp-tools/ # 技能: 基础工具类库 │ ├── SKILL.md # 必须: 技能定义 (含 YAML frontmatter) │ └── references/ # 可选: 参考文档 (按需加载) │ ├── core_utils.md │ ├── map_builder.md │ ├── files_codec_crypto.md │ ├── advanced_tools.md │ ├── jdbc_and_beans.md │ └── usage_examples.md └── qdbp-staticize/ # 技能: 模板静态化引擎 ├── SKILL.md └── references/ ├── publish.md ├── task.md ├── tags.md ├── io.md ├── utils.md ├── parse.md ├── common.md ├── convert.md └── exception.md ``` 技能文件夹是安装单元: `SKILL.md` 必须在文件夹根层, 名称与 frontmatter 的 `name` 一致; `references/` 等子目录保持相对路径不变。 ## 安装方式 各 AI 客户端都有一处存放技能的目录, 把技能文件夹整体复制进去即可: | 位置 | 路径 | |------|------| | 用户级 (仅自己可用) | `<客户端配置目录>/skills/` , 通常是 `~/.<客户端名>/skills/` | | 项目级 (随项目共享) | `<项目根>/.<客户端名>/skills/` | | Windows 用户级 | `C:\Users\<用户名>\.<客户端名>\skills\` | 具体目录名以所使用客户端的文档为准。复制完成后重启客户端或新开对话, 技能即生效。 ### 方法一: 交给 AI 自动安装 (推荐) 在支持 Skill 机制的 AI 客户端中直接发送下面这句话, AI 会自动完成下载、复制与校验: > 从 https://gitee.com/qdbp/qdbp-skills 安装 qdbp-tools 技能 AI 需要执行的动作 (想手动操作也可以照做): 1. 取回仓库内容: `git clone https://gitee.com/qdbp/qdbp-skills` (或下载 zip 解压) 2. 把仓库根下的 `qdbp-tools` 文件夹整体复制到客户端 skills 目录 3. 确认复制后 `SKILL.md` 与 `references/` 均已到位, 文件无缺失 4. 重启客户端或新开对话, 技能即生效 ### 方法二: 网页下载 (最简单, 不用装 Git) 1. 进入本仓库页面, 点 **Code** 按钮 → **Download ZIP** 2. 解压下载的 zip 3. 找到含 `SKILL.md` 的技能文件夹 (如 `qdbp-tools`) 4. 把它整体复制到上表中的技能目录 5. 重启客户端或新开对话 ### 方法三: Git 拉取 (有 Git 环境, 方便更新) ```bash # 克隆整个仓库 (首次) git clone https://gitee.com/qdbp/qdbp-skills # 以后更新 cd qdbp-skills && git pull ``` 技能位于仓库根的 `qdbp-tools`, 克隆后把该文件夹复制到技能目录即可。 ### 方法四: 平台技能市场 `qdbp-tools` 可打包为 zip 提交到所用 AI 平台的技能市场, 审核上架后在客户端内一键安装。zip 包结构要求顶层即为技能文件夹 (打包产物放在仓库外的临时位置, 不纳入版本库): ``` qdbp-tools.zip └── qdbp-tools/ ├── SKILL.md └── references/... ``` ## 更新技能 技能内容变更后: 1. 修改本仓库内的源文件 (以此处为准) 2. 更新 `qdbp-tools/SKILL.md` 中 frontmatter 的 `version` 字段 3. 如发布到平台市场, 在仓库外重新打包 zip 4. 提交并推送; 已安装的副本可用仓库中的新版本覆盖 ## 校验清单 提交前快速自检: - `SKILL.md` frontmatter 含 `name` / `description` (市场版还需 `display_name` / `description_zh` / `description_en` / `examples_zh` / `examples_en` / `version` / `author`) - 文档中出现的类名、方法名均在源码中存在, `@Deprecated` 的不收录 - `references/` 内相对链接可正常打开