메뉴
更新 AI 小鲸 VitePress 主站文档（src/frontend/web/docs）。在发布新功能、修改 chat-x/ai-blueking 行为、补充 changelog、撰写 LLM/系统提示词说明、同步 API 与指南交叉链接时使用。触发词：文档更新、changelog、主站文档、VitePress、蓝鲸行内富文本、提示词文档、web/docs。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Use when 在消费方项目中接入 / 使用 @blueking/chat-x 对话组件库（已 npm 安装、非改库源码）， 涉及「某组件怎么用、有哪些 props / events / slots / expose / v-model、怎么搭 AI 对话界面、 流式输出、停止生成、工具调用 ToolCall、快捷指令、文件上传、@ 资源、自定义消息或侧栏 Tab、 分享多选、HITL 中断审批、Markdown / 代码 / 公式 / 图表渲染、字号与主题 CSS 变量」等问题时优先使用。 若是在 packages/chat-x/src 内改库源码（写组件 / composable / 样式 / 测试），改用 chat-x-dev skill。
本地开发和构建部署 aidev-ai-blueking（AI 小鲸）前端组件到 Django 模板项目的完整流程。涵盖 publish-template 前端开发、Python 包构建部署、常见问题排查。触发场景：构建 ai-blueking、部署小鲸、publish-template 开发调试、make build/deploy-aidev-ai-blueking、Django 模板项目本地运行。
| name | ai-blueking-docs-update |
| description | 更新 AI 小鲸 VitePress 主站文档（src/frontend/web/docs）。在发布新功能、修改 chat-x/ai-blueking 行为、补充 changelog、撰写 LLM/系统提示词说明、同步 API 与指南交叉链接时使用。触发词：文档更新、changelog、主站文档、VitePress、蓝鲸行内富文本、提示词文档、web/docs。 |
| metadata | {"author":"blueking","version":"1.0"} |
| compatibility | 需能读写仓库内 src/frontend/web/docs；本地预览需 Node 20+ 与 pnpm。 |
src/frontend/web、changelog、指南或 API 页ai-blueking-dev 并行：本 Skill 只改文档，不改组件实现（除非用户明确要求）| 路径 | 说明 |
|---|---|
src/frontend/web/docs/ | 唯一源码目录（Markdown 页面） |
src/frontend/web/docs/.vitepress/config.js | 导航、侧边栏、版本号（读 ai-blueking/package.json） |
src/frontend/web/dist/ | 构建产物，不要手改 |
packages/chat-x/wikis/ | chat-x 组件级 Wiki（与主站互补，重大 API 变更时考虑同步） |
版本号来源：src/frontend/ai-blueking/packages/ai-blueking/package.json 的 version（导航栏与 changelog 标题应对齐）。
本地预览（在 src/frontend/web 下）：
pnpm dev # vitepress dev docs
pnpm build # 生产构建
packages/chat-x / ai-blueking 源码注释或 wikis，确认用户可见行为与版本号。docs/changelog.md 顶部插入新版本块，格式见 changelog 模板。::: info / ::: warning 等）。docs/.vitepress/config.js 的 themeConfig.sidebar 中增加链接。chat-interaction、prompts、faq、api/* 等关联页链到新文档，避免孤岛页。docs/guide/core-features/*.md 或 integration-modes/、advanced-usage/chat-interaction 摘要docs/api/ai-blueking/、docs/api/chat-x/、docs/api/chat-helper/当功能依赖模型输出特定格式（如蓝鲸行内富文本 ::bk::）时：
prompts prop：仅用户提问模板，在 prompts.md 中说明与系统提示词的分工src/frontend/web/docs/guide/core-features/markdown-inline-style.md### 变更 或 ### 重大变更docs/guide/migration-2.0.md 或新增版本迁移小节markdown-inline-style.md → /guide/core-features/markdown-inline-styletext 一致@blueking/ai-blueking、style.css）| Skill | 职责 |
|---|---|
ai-blueking-dev | 组件实现、集成代码、chat-x wikis 组件文档 |
ai-blueking-docs-update（本 Skill） | 主站 VitePress、changelog、面向集成方与 LLM 配置者的说明 |
功能开发完成后，用本 Skill 更新主站；若 chat-x 公开 API 变更，评估是否同时更新 packages/chat-x/wikis/。
changelog.md 已添加对应版本条目（版本号与 ai-blueking package.json 一致）.vitepress/config.js sidebarsrc/frontend/web/dist/