AIS 知识库
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_d8529983/ais-skill。
技能介绍
要解决什么问题
在对话里让模型「改知识库」时,常见问题是:把 KB 当成虚构上下文、一次性整篇重写,或在本机假设存在 kb 可执行文件。AIS 是持久化、版本化的远端知识库,仓库 → 目录 → 文档各有稳定 code,同名对象需要消歧;写入会真实生效,也可能因权限、并发或约束失败。
技能如何工作
本技能把 AIS/KB 操作收敛到统一执行路径:普通 kb ... 命令经 scripts/kb_execute.py 发往 KB 执行服务;上传、直下载、生成下载链接走脚本内置文件接口,不走 kb ... 字符串。
推荐流程:
- 先读
references/read.md,用kb ls、kb tree或kb search定范围 - 锁定对象后优先用 code,修改前务必
kb cat读当前内容 - 选用最小操作:
kb write/kb edit --patch正文优先 HTML;复杂 patch 用--command-file避免 shell 转义 - 需要对外链接时再
kb render
执行前必须确认 KB_EXECUTE_URL 与 KB_TOKEN(或 --url / --token);缺 token 应向用户说明如何从已登录 AIS 页面请求头获取。
边界与注意
- 不唯一时不要猜:先消歧再改;以
kb cat返回为准 - 删除、移动、发布属高风险,仅用户明确要求时执行
- PDF、xlsx、docx 等默认先读解析文本,再建语义等价的
.md,除非明确支持原格式编辑 - 命令失败后不要假设状态已变,先重新读取确认
使用场景
- 在远端 AIS 仓库里用 `kb search` 定位同名页面,再用 `code` 执行 `kb cat` 后局部 `kb edit --patch` 改一段 HTML
- 多行 patch 或复杂正文先写入 UTF-8 文件,通过 `--command-file` 提交,避免 shell 转义弄坏 KB 命令
- 需要把本地附件挂到知识库文档时,走脚本上传接口;直下载失败则改用 `--download-link-code` 生成票据再验证链路
- 发布前用 `kb tree` 理清仓库/目录结构,确认目标文档存在且唯一,再按 `references/write.md` 做新建或移动
适合人员
- 负责公司 AIS 工作区维护、需要在对话里精确改 Wiki 页而不是整篇重写的知识管理员
- 把事故复盘、SOP 写入版本化知识库、且要求改动能被 UI 用户立刻看到的运维/平台工程师
- 处理 PDF/Excel 等政策附件、要先读解析文本再在 KB 中建等价 `.md` 页的内容运营
- 集成 Agent 与 KB 执行服务、需统一用 `kb_execute.py` 传 token 与 `KB_EXECUTE_URL` 的后端开发者