技能 streaming-api-patterns

📦

streaming-api-patterns

Name: streaming-api-patterns
Author: AI Agent Hub

v1.0.0 內容修訂 r2 中風險 ⚙️ 外部命令🌐 網路存取

建構串流 API

即時功能會在串流模式省略背壓、重新連線和清理時失敗。此技能提供適用於 Claude、Codex 和 Claude Code 的 SSE、WebSocket 與 ReadableStream 模式。

支援: Claude Codex Code(CC)

📊 71 尚可

Maintain this Skill? Claim it 📊 71 尚可

使用我的智慧代理安裝

將此請求複製給你的智慧代理，其中包含權威 Skill 頁面和清單。

智能體請求

Review the Skillstore skill "streaming-api-patterns" from https://skillstore.io/skills/ariegoldkin-streaming-api-patterns.md and its manifest at https://skillstore.io/api/skills/ariegoldkin-streaming-api-patterns/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.

你的智慧代理仍應顯示其計畫，並依安全政策請求必要確認。

Agent 可讀資源

當 AI Agent、爬蟲或腳本需要乾淨脈絡、而不是讀取完整頁面時，請使用這些連結。

Markdown 詳情 GET /skills/ariegoldkin-streaming-api-patterns.md 已簽名 manifest GET /api/skills/ariegoldkin-streaming-api-patterns/manifest 已簽名 lockfile GET /api/skills/ariegoldkin-streaming-api-patterns/lockfile

測試它

正在使用「streaming-api-patterns」。詢問即時通知動態消息應使用哪種傳輸方式。

預期結果:

建議的傳輸方式：Server-Sent Events，適合單向更新。
關鍵需求：keepalive 訊息、自動重新連線，以及中斷連線時清理。
只有在用戶端必須頻繁傳送即時訊息時才使用 WebSockets。

正在使用「streaming-api-patterns」。要求串流 LLM 回應的正式環境檢查清單。

預期結果:

在開始串流前驗證請求。
傳送清楚的完成標記。
處理部分文字、中斷連線、重試和慢速用戶端。
測量第一個 token 的時間和記憶體使用量。

正在使用「streaming-api-patterns」。詢問如何強化 WebSocket 聊天功能。

預期結果:

此技能會回傳關於驗證、origin 檢查、heartbeat 處理、重新連線、訊息限制和內容驗證的指引。

安全審計

中風險

v9 • 2026/7/23 開啟版本化報告

Static command findings are false positives caused by Markdown fences and TypeScript template literals; no shell execution exists. Network calls are expected examples for a streaming API skill and use local, relative, or standards documentation URLs. Two separate medium-risk example defects remain: unescaped error serialization and an unauthenticated, unvalidated WebSocket broadcast.

已掃描檔案

420

分析行數

複核項目

已忽略的誤報

已確認的安全問題 (2)

中

templates/sse-endpoint-template.ts:34-37

Unsafe SSE Error Serialization and Disclosure

The template inserts error.message directly into quoted JSON and sends it to clients. Quotes or newlines can corrupt framing, and internal details may leak.

Line 36 directly interpolates error.message without JSON.stringify or a public error mapping. The surrounding catch sends it over SSE.

中

SKILL.md:76-86

Unprotected WebSocket Broadcast Example

The server forwards every incoming message to all connected clients without authentication, authorization, origin checks, schema validation, or size limits.

The handler broadcasts raw data immediately. Later checklist guidance mentions safeguards, but the runnable example does not implement them.

審計單位: codex 檢視審計紀錄 →

分享與引用此報告

分享版本化評估報告、中性徽章、嵌入卡片與引用。Skillstore 只報告證據，不判斷該 Skill 是否安全。

開啟版本化報告

複製報告連結

https://skillstore.io/skills/ariegoldkin-streaming-api-patterns/audits/9?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Markdown 徽章

[![Skillstore security assessment](https://skillstore.io/badges/skills/ariegoldkin-streaming-api-patterns/security.svg)](https://skillstore.io/skills/ariegoldkin-streaming-api-patterns?utm_source=security_passport_badge)

HTML 徽章

<a href="https://skillstore.io/skills/ariegoldkin-streaming-api-patterns?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/ariegoldkin-streaming-api-patterns/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

嵌入卡片

<iframe src="https://skillstore.io/embed/skills/ariegoldkin-streaming-api-patterns.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 引用

AI Agent Hub. (2026). streaming-api-patterns security audit report (audit version 9) [Author version 1.0.0]. Skillstore. https://skillstore.io/skills/ariegoldkin-streaming-api-patterns/audits/9

BibTeX 引用

@techreport{ai-agent-hub-ariegoldkin-streaming-api-patterns-2026,
  author = {AI Agent Hub},
  title = {streaming-api-patterns security audit report (audit version 9)},
  institution = {Skillstore},
  year = {2026},
  number = {9},
  url = {https://skillstore.io/skills/ariegoldkin-streaming-api-patterns/audits/9},
  note = {Author version 1.0.0}
}

CITATION.cff

cff-version: 1.2.0
message: "If you use this Skill, cite its author and this versioned security audit report."
title: "streaming-api-patterns security audit report (audit version 9)"
version: "1.0.0"
type: report
authors:
  - name: "AI Agent Hub"
date-released: "2026-07-23"
url: "https://skillstore.io/skills/ariegoldkin-streaming-api-patterns/audits/9"
identifiers:
  - type: other
    value: "skillstore:ariegoldkin-streaming-api-patterns:audit:9"
    description: "Skillstore immutable audit report identifier"

Skillstore 評分

評分依據證據置信度: 高

架構

100

可維護性

內容

社群

規範符合度

你可以打造什麼

設計串流聊天回應

為 token 傳遞、完成標記和用戶端解析選擇 SSE 或 ReadableStream 模式。

新增即時應用程式更新

使用 keepalive 訊息、重新連線行為和中斷連線時的清理，實作伺服器到用戶端通知。

檢查正式環境就緒度

使用檢查清單評估驗證、訊息限制、背壓、測試和失敗處理。

試試這些提示

選擇串流模式

我正在使用 [traffic level] 建構 [feature]。比較 SSE、WebSockets 和 ReadableStream，然後推薦一種模式。

建立 SSE endpoint

為 [data source] 建立 Next.js SSE endpoint。包含 keepalive 訊息、中斷連線清理和用戶端解析步驟。

改善串流可靠性

檢視這個串流設計：[design]。找出重新連線、逾時、背壓和資源清理的缺口。

稽核正式環境串流

稽核這個正式環境串流架構：[architecture]。涵蓋驗證、速率限制、訊息驗證、可觀測性和失敗復原。

最佳實務

在傳送使用者資料前，驗證並認證每個串流連線。
在撰寫用戶端程式碼前，先設計重新連線、逾時和清理行為。
及早測試慢速用戶端、中斷的網路和並行連線。

避免

不要直接複製範例而未加入驗證、授權和速率限制。
不要串流原始錯誤訊息或未驗證的用戶端內容。
不要忽略背壓、瀏覽器連線限制，或中斷連線時的清理。

常見問題

此技能涵蓋哪些串流方法？

它涵蓋 Server-Sent Events、WebSockets、ReadableStream、重新連線邏輯和 LLM token 串流模式。

此技能只適用於 Next.js 嗎？

不是。範例使用 Next.js，但傳輸模式適用於許多支援串流的 Web 框架。

它是否包含正式環境安全性控制？

它列出必要的控制項目，但團隊必須加入驗證、授權、origin 檢查、驗證和速率限制。

它能協助在 SSE 和 WebSockets 之間選擇嗎？

可以。它說明何時單向 SSE 已足夠，以及何時雙向 WebSockets 更適合。

它是否支援 LLM 串流工作流程？

可以。它包含串流模型回應、完成標記、用戶端解析和回應組裝的模式。

Claude Code 或 Codex 可以使用此技能嗎？

可以。此技能已針對 Claude、Codex 和 Claude Code 相容的工作流程編寫文件。

開發者詳細資訊

作者

AI Agent Hub

授權

MIT

作者版本

v1.0.0

Skillstore 修訂

儲存庫

https://github.com/ArieGoldkin/ai-agent-hub/tree/main/skills/streaming-api-patterns

引用

89edfdc710d0846129dcee6a929477b04f08052c

維護新鮮度

2026/7/26

使用量

7 次下載 · 278 次瀏覽

檔案結構

📁 checklists/

📄 streaming-checklist.md

📄 SKILL.md

分析 Harness Model Protocols

由 Dowwie

代理程式框架稽核經常漏掉內部狀態與提供者 API 之間的轉譯層。這項技能會引導 Claude、Codex 和 Claude Code 檢視訊息格式、工具呼叫、串流事件與提供者抽象層。

程式開發查看

streaming-api-patterns

使用我的智慧代理安裝

Agent 可讀資源

測試它

安全審計

已確認的安全問題 (2)

風險因素

複製報告連結

Markdown 徽章

HTML 徽章

嵌入卡片

APA 引用

BibTeX 引用

CITATION.cff

Skillstore 評分

你可以打造什麼

設計串流聊天回應

新增即時應用程式更新

檢查正式環境就緒度

試試這些提示

最佳實務

避免

常見問題

開發者詳細資訊

AI Agent Hub 的更多技能

architecture-decision-record

api-design-framework

brainstorming

code-review-playbook

database-schema-designer

quality-reviewer

相關技能

streaming-llm-responses

stream-chain

ai-model-web

ai-model-wechat

research-agent-optimization

harness-model-protocol