技能 chatkit-botbuilder
📦

chatkit-botbuilder

内容修订 r1 高风险 🌐 网络访问📁 文件系统访问🔑 环境变量⚙️ 外部命令⚡ 包含脚本

构建生产级 ChatKit 聊天机器人

团队需要可靠的模式，将 ChatKit 连接到真实的应用工作流。此技能为 FastAPI 后端、MCP tools、Next.js 小组件和用户隔离提供架构指导。

支持: Claude Codex Code(CC)
⚠️ 38 差

使用我的智能体安装

将此请求复制给你的智能体，其中包含权威 Skill 页面和清单。

智能体请求
Review the Skillstore skill "chatkit-botbuilder" from https://skillstore.io/skills/92bilal26-chatkit-botbuilder.md and its manifest at https://skillstore.io/api/skills/92bilal26-chatkit-botbuilder/manifest. Verify the artifact. Stop and obtain explicit user consent before installing or changing files.

你的智能体仍应展示其计划，并按安全策略请求必要确认。

Agent 可读资源

当 AI Agent、爬虫或脚本需要干净上下文，而不是读取完整页面时，请使用这些链接。

Markdown 详情 GET /skills/92bilal26-chatkit-botbuilder.md 已签名 manifest GET /api/skills/92bilal26-chatkit-botbuilder/manifest 已签名 lockfile GET /api/skills/92bilal26-chatkit-botbuilder/lockfile

测试它

正在使用“chatkit-botbuilder”。 我需要一个用于管理客户支持工单的 ChatKit 聊天机器人。

预期结果:

  • 一个分层架构，包含 Next.js ChatKit 面板、FastAPI 协议端点以及特定于工单的 MCP 封装器。
  • 一份检查清单，涵盖 JWT 提取、工单所有权过滤器、流式响应和仪表盘刷新行为。

正在使用“chatkit-botbuilder”。 我的 ChatKit 工具为错误的用户创建了数据。

预期结果:

  • 一条诊断路径，用于检查中间件用户提取、封装器闭包作用域和数据库过滤器。
  • 一个修正后的实施计划，将 user_id 保留在服务器端，并将其应用于每次读取和写入。

正在使用“chatkit-botbuilder”。 准备部署此 ChatKit 集成。

预期结果:

  • 一份部署检查清单，涵盖域名注册、后端 URL 配置、CORS、密钥放置和生产令牌验证。
  • 一份发布前需要审查的安全事项列表，包括前端密钥和详细错误响应。

安全审计

高风险
v6 • 2026/7/5 打开版本化报告

Most static findings are false positives caused by Markdown code examples, inline backticks, localhost URLs, and ordinary architecture terms. The confirmed security issue is guidance that places an OpenAI API key in frontend public configuration, with additional semantic concerns around browser token storage and development test-token bypasses. No prompt injection attempt was found in the reviewed skill files.

6
已扫描文件
2,579
分析行数
2
复核项
0
已忽略误报

已确认安全问题 (3)

高
CHATKIT_SKILL_SUMMARY.md:216-222references/frontend_integration.md:385-398
Frontend OpenAI API Key Exposure Guidance
The documentation recommends NEXT_PUBLIC_OPENAI_API_KEY in frontend configuration. In Next.js, NEXT_PUBLIC values are exposed to the browser, so copying this guidance can leak an OpenAI API key.
The exact variable name appears in frontend environment guidance and includes an sk-style placeholder in the detailed integration guide. The risk follows directly from Next.js public environment variable behavior.
中
references/frontend_integration.md:31-45references/frontend_integration.md:326-327
Browser Storage for Bearer Tokens
The frontend examples read and write JWT bearer tokens in localStorage and sessionStorage. This pattern can expose sessions to XSS and should be replaced or mitigated for production deployments.
The cited snippets explicitly store and retrieve access tokens from browser storage. This is a known session handling risk, although some applications may accept it with strong XSS controls.
中
references/backend_architecture.md:34-38
Development Test Token Bypass Pattern
The backend example accepts bearer tokens that start with test-token when the environment is development. This is acceptable for local testing but can become an authentication bypass if the environment gate is misconfigured.
The bypass is explicitly scoped to development, so malicious intent is not evident. The pattern is still risky guidance because a copied or misconfigured deployment could accept forged user IDs.
能力复核项 (2)

这些是真实的本地能力，对此技能可能是预期行为，因此需要复核，但不会按已确认恶意行为计分。

高
CHATKIT_SKILL_SUMMARY.md:219
Generic API/secret keys
- `NEXT_PUBLIC_OPENAI_API_KEY` = Optional (if frontend needs direct OpenAI access)
The guidance suggests NEXT_PUBLIC_OPENAI_API_KEY for frontend use, which would expose an OpenAI secret in browser-visible code if copied. This is a real credential exposure risk, not just a placeholder mention.
高
references/frontend_integration.md:397
Generic API/secret keys
NEXT_PUBLIC_OPENAI_API_KEY=sk-your-key-here
The .env.local example places NEXT_PUBLIC_OPENAI_API_KEY with an sk-style placeholder in frontend configuration. NEXT_PUBLIC variables are bundled for the browser, so this pattern can leak API credentials.

风险因素

🌐 网络访问 (15)
CHATKIT_SKILL_SUMMARY.md:186 CHATKIT_SKILL_SUMMARY.md:187 references/backend_architecture.md:333 references/frontend_integration.md:72 references/frontend_integration.md:271 references/frontend_integration.md:19 references/frontend_integration.md:183 references/frontend_integration.md:391 references/frontend_integration.md:404 references/frontend_integration.md:410 references/user_isolation.md:142 references/user_isolation.md:146 references/user_isolation.md:151 references/user_isolation.md:447 SKILL.md:172
📁 文件系统访问 (2)
CHATKIT_SKILL_SUMMARY.md:7 CHATKIT_SKILL_SUMMARY.md:7
🔑 环境变量 (9)
CHATKIT_SKILL_SUMMARY.md:201 CHATKIT_SKILL_SUMMARY.md:201 CHATKIT_SKILL_SUMMARY.md:219 CHATKIT_SKILL_SUMMARY.md:222 references/frontend_integration.md:19 references/frontend_integration.md:20 references/frontend_integration.md:19 references/frontend_integration.md:20 references/frontend_integration.md:397
⚙️ 外部命令 (51)
references/frontend_integration.md:23-66 references/frontend_integration.md:66-176 references/frontend_integration.md:273-285 references/frontend_integration.md:285-313 references/user_isolation.md:85 references/user_isolation.md:254 references/user_isolation.md:264 SKILL.md:41-59 SKILL.md:59-98 SKILL.md:98-112 SKILL.md:112-116 SKILL.md:116-123 SKILL.md:123-127 SKILL.md:127-134 SKILL.md:134-138 SKILL.md:138-144 SKILL.md:144-150 SKILL.md:150-153 SKILL.md:153-161 SKILL.md:161-165 SKILL.md:165-170 SKILL.md:170-174 SKILL.md:174-178 SKILL.md:178-191 SKILL.md:191-195 SKILL.md:195-209 SKILL.md:209-215 SKILL.md:215-229 SKILL.md:229-233 SKILL.md:233-239 SKILL.md:239-253 SKILL.md:253-263 SKILL.md:263-267 SKILL.md:267-300 SKILL.md:300-304 SKILL.md:304-315 SKILL.md:315-319 SKILL.md:319-334 SKILL.md:334-384 SKILL.md:384-387 SKILL.md:387-394 SKILL.md:394-399 SKILL.md:399-406 SKILL.md:406-409 SKILL.md:409-416 SKILL.md:416-418 SKILL.md:418-419 SKILL.md:419-435 SKILL.md:435-446 SKILL.md:446-507 SKILL.md:507
⚡ 包含脚本 (4)
references/mcp_wrapper_guide.md:183-190 references/user_isolation.md:85 references/user_isolation.md:254 references/user_isolation.md:264
审计者: codex 查看审计历史 →
分享与引用此报告

分享版本化评估报告、中性徽章、嵌入卡片和引用。Skillstore 只报告证据，不判断该 Skill 是否安全。

打开版本化报告
安全评估

复制报告链接

https://skillstore.io/skills/92bilal26-chatkit-botbuilder/audits/6?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Markdown 徽章

[![Skillstore security assessment](https://skillstore.io/badges/skills/92bilal26-chatkit-botbuilder/security.svg)](https://skillstore.io/skills/92bilal26-chatkit-botbuilder?utm_source=security_passport_badge)

HTML 徽章

<a href="https://skillstore.io/skills/92bilal26-chatkit-botbuilder?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/92bilal26-chatkit-botbuilder/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

嵌入卡片

<iframe src="https://skillstore.io/embed/skills/92bilal26-chatkit-botbuilder.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>
学术引用 (APA · BibTeX · CFF)

APA 引用

92Bilal26. (2026). chatkit-botbuilder security audit report (audit version 6) [Author version unspecified]. Skillstore. https://skillstore.io/skills/92bilal26-chatkit-botbuilder/audits/6

BibTeX 引用

@techreport{92bilal26-92bilal26-chatkit-botbuilder-2026, author = {92Bilal26}, title = {chatkit-botbuilder security audit report (audit version 6)}, institution = {Skillstore}, year = {2026}, number = {6}, url = {https://skillstore.io/skills/92bilal26-chatkit-botbuilder/audits/6}, note = {Author version unspecified} }

CITATION.cff

cff-version: 1.2.0 message: "If you use this Skill, cite its author and this versioned security audit report." title: "chatkit-botbuilder security audit report (audit version 6)" version: "unspecified" type: report authors: - name: "92Bilal26" date-released: "2026-07-05" url: "https://skillstore.io/skills/92bilal26-chatkit-botbuilder/audits/6" identifiers: - type: other value: "skillstore:92bilal26-chatkit-botbuilder:audit:6" description: "Skillstore immutable audit report identifier"

Skillstore 评分

评分依据 证据置信度: 中
45
架构
85
可维护性
87
内容
74
社区
87
规范符合性

你能构建什么

创建内部任务助手

设计一个 ChatKit 助手，用于创建、列出、更新和完成特定用户的任务。

将 ChatKit 添加到现有仪表盘

规划仪表盘集成所需的前端小组件、经过身份验证的 API 调用和后端端点。

审查多用户隔离

检查中间件、封装器和数据库过滤器是否保留每个用户的数据边界。

试试这些提示

规划一个基础 ChatKit 应用 
使用此技能为任务应用概述一个简单的 ChatKit 聊天机器人。包括前端、后端和工具层。
与我的后端集成 
使用此技能调整我的 FastAPI 应用以支持 ChatKit。重点关注协议端点、流式响应和 JWT 上下文。
设计 MCP 工具封装器 
使用此技能为我的应用工具设计 MCP 封装函数。确保每次工具调用都接收经过身份验证的 user_id。
审计生产就绪性 
使用此技能审查我的 ChatKit 架构是否适合生产。检查用户隔离、令牌处理、错误处理、CORS 和部署设置。

最佳实践

  • 将密钥保留在后端，并且只向浏览器暴露公共配置值。
  • 从经过验证的服务器端身份验证上下文注入 user_id，而不是从请求正文或模型输出中获取。
  • 使用至少两个独立用户和冲突资源 ID 的测试来验证用户隔离。

避免

  • 当 MCP tools 需要经过身份验证的用户上下文时，不要将原始 MCP tools 注册到 agent。
  • 不要将 OpenAI 密钥放入 NEXT_PUBLIC 环境变量或浏览器可见的包中。
  • 对于高频工作流，如果未测量后端负载，不要只依赖轮询。

常见问题

此技能是否包含可运行的源代码？
它主要提供文档和实现代码片段。你必须将示例适配到自己的应用程序中。
哪些工具可以使用此技能？
报告列出了对 Claude、Codex 和 Claude Code 的支持。
它面向什么后端技术栈？
示例重点关注 FastAPI、ChatKit 服务器模式、OpenAI Agents SDK、SQLModel 风格的数据库访问和 MCP tools。
它能帮助现有应用吗？
可以。它可以指导端点设计、经过身份验证的 fetch 设置、工具封装器创建和用户隔离检查。
这些指导按原样是否已具备生产就绪性？
不能。生产使用前，请审查安全敏感示例、依赖版本、令牌存储和密钥处理。
主要安全模型是什么？
该技能建议使用身份验证中间件、按请求创建的工具封装器，以及全部使用经过身份验证的 user_id 的数据库过滤器。

开发者详情

作者

92Bilal26

许可证

Complete terms in LICENSE.txt

Skillstore 修订

r1

版本提示

作者未声明版本。

仓库

https://github.com/92Bilal26/TaskPilotAI/tree/main/.claude/skills/chatkit-botbuilder

引用

c4037264bbd363c572662d6154a3ab28f5ca4f53

维护新鲜度

2026/7/18

使用量

14 次下载 · 454 次浏览

文件结构

📄 CHATKIT_SKILL_SUMMARY.md

📁 references/

📄 backend_architecture.md

📄 frontend_integration.md

📄 mcp_wrapper_guide.md

📄 user_isolation.md

📄 SKILL.md

92Bilal26 的更多技能

查看全部

相关技能

查看全部