Skill
用中文 Skill 组合 Kit 组件、管理会话、接入对话后端和配置服务端数据库
Kit 的中文 Skill 指导 coding agent 选择组件、管理聊天状态、接入对话后端和配置服务端数据库。 每个 Skill 都可以独立复制使用,涉及公开 API 的 Skill 附有接口参考和可编译示例。
Skill 是写代码时读取的指南,不是运行时插件,也不会替应用创建会话或调用百炼。
页面的实际行为仍由 kit-chat-ui、Kit SDK 各功能入口及其 /hooks 和业务后端完成。
选择 Skill
kit-components
覆盖所有已实现的公开组件、子组件和兼容别名,指导 UI 组合与样式接入。
use-kit-chat
接入 useChat,处理连接、发送、停止、会话切换以及工具批准与拒绝。
kit-chat-provider
使用默认 Kit Server,或把自建百炼后端的已转换事件、原始 SSE 接入 Provider。
kit-database
配置 Kit Server 的 SQLite、MySQL 或 PostgreSQL,检查连接和启动迁移。
| 想完成的工作 | 从哪个 Skill 开始 |
|---|---|
| 选择消息、输入、附件、反馈和页面辅助组件 | kit-components |
| 把已有后端连接到页面,管理发送与会话状态 | use-kit-chat |
| 自己有百炼后端,需要适配请求和流数据合同 | kit-chat-provider |
| 为 Kit Server 选择数据库并验证启动 | kit-database |
完整对话页面通常会同时使用对话相关的三个 Skill。只有 UI 组合需求时,可以单独使用
kit-components;已有稳定 Provider 时,不需要重复实现后端适配。
获取与阅读
先阅读安装与更新,再将 Skill 目录复制到 coding agent 支持的目录。
也可以直接下载全部 Skill 的离线包并阅读其中的 SKILL.md。
复制完整目录即可保留每个 Skill 的元数据和随附资源。
Skill 源文件位于 scripts/skills/src/,最终目录生成到 assets/skills/<name>/,离线压缩包
由 pnpm pack:skills 生成到 assets/skills/dist/。没有安装器 CLI,也没有发布 npm 包。
下载的 Skill 包含中文正文、API 说明、示例注释和界面文案。
API 与示例如何保持一致
公开 TypeScript 导出是 API 结构的事实来源。pnpm gen:skills 更新中文 API 参考与本站
示例;pnpm check:skills 只检查,不修改文件,发现公开接口、组件覆盖或示例内容漂移时失败。
pnpm pack:skills 生成离线包。
API 签名、Props 和类型由源码同步。用途、默认行为和接入约束由中文参考资料说明,并与 组件和 SDK 文档核对。本站嵌入的代码来自 Skill 的同一份 TS/TSX 示例,不维护另一套代码。 新增公开组件、子组件或兼容别名时,必须一起补齐 Skill 索引与 API 参考。
运行时 API 的详细用法见组件总览与 SDK 与 Kit 数据接入。