OpenParable
Skip to content
← Back to skills

Chat X Custom Component

Development
chat-x-custom-component

Chat X Custom Component is an Agent Skill for development published in the TencentBlueKing/bk-bcs repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

帮助开发者创建 @blueking/chat-x 自定义 message 组件。当用户需要开发自定义消息类型时使用。

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/TencentBlueKing/bk-bcs/blob/HEAD/bcs-services/bcs-project-manager/.cursor/skills/chat-x-custom-component/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/chat-x-custom-component, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Chat-X 自定义 Message 组件开发

概述

自定义 message 组件允许你扩展内置消息类型、渲染任意 UI 组件。

开发流程

1. 声明类型扩展 → 2. 创建组件 → 3. 集成到 MessageContainer → 4. 测试

核心机制

类型扩展

import { type BaseMessage } from '@blueking/chat-x';

declare global {
  interface AIBluekingMessageMap {
    custom: BaseMessage<'custom', { content: string }>;
  }
}

MessageSlot 机制

import { useMessageSlotId } from '@blueking/chat-x';
const { messageSlotId } = useMessageSlotId();
// 用于 Teleport: <Teleport :to="messageSlotId">

常见场景

  • ECharts 图表消息
  • bkui-vue 表格消息
  • 动态表单消息
  • 卡片列表消息

📦 可用资源

  • skill://chat-x-custom-component/references/api-reference.md
  • skill://chat-x-custom-component/references/best-practices.md
  • skill://chat-x-custom-component/references/full-example.md
  • skill://chat-x-custom-component/references/integration-guide.md
  • skill://chat-x-custom-component/references/type-extension.md

📦 可用资源

  • skill://chat-x-custom-component/references/QA.md
  • skill://chat-x-custom-component/references/api-reference.md
  • skill://chat-x-custom-component/references/best-practices.md
  • skill://chat-x-custom-component/references/component-templates.md
  • skill://chat-x-custom-component/references/full-example.md
  • skill://chat-x-custom-component/references/integration-guide.md
  • skill://chat-x-custom-component/references/type-extension.md

根据 SKILL.md 中的 IF-THEN 规则判断是否需要加载