用途：该技能用于实现基于 CopilotKit 的智能体 UX，包括正确的 provider 接线、运行时选择、共享状态、前端动作与中断处理。
主要能力：支持 CopilotKit provider 设置、运行时端点、hooks、共享状态渲染以及人机协同（HITL）UX。
使用方式：先选择运行时拓扑，决定使用 LangGraph 平台端点还是远程后端运行时，再进行 UI 编辑；配置 provider 边界，先设置 <CopilotKit> provider 与运行时端点；按职责选择 hooks，useCoAgent 用于状态耦合，useCopilotAction 用于前端动作，中断 hooks 用于 HITL 流程；定义共享状态契约，区分输入/输出/内部状态并保持序列化稳定；实现 HITL 路径，将中断载荷映射到明确的前端动作处理器；实现持久化行为，选择线程/消息持久化策略并确保恢复一致性；最后验证端到端 UX，测试流式输出、工具可见性、共享状态渲染与恢复流程。
默认模式：保持运行时与 UI 关注点分离；共享状态 schema 明确且最小化；动作处理器保持幂等；将中断视为类型化控制流而非自由格式消息。
适用场景：CopilotKit provider 设置、运行时端点、hooks、共享状态渲染与人机协同 UX。若后端图行为是主要问题，切换到 $langgraph；若协议事件合规是主要问题，切换到 $ag-ui；若核心模型/工具编排逻辑是主要问题，切换到 $langchain。
限制与常见失败：端点不匹配（运行时 URL/类型错误）；hooks 绑定到错误的 agent 名称或 provider 作用域；共享状态更新因 schema 不匹配而未反映；中断动作处理器未接入预期载荷类型。参考文档按需加载：运行时与 provider 设置见 references/runtime-and-provider.md，hooks 与动作见 references/hooks-and-actions.md，CoAgents 与共享状态见 references/coagents-shared-state.md，HITL 与故障排查见 references/hitl-and-troubleshooting.md。