tool-design
81設計可靠的代理工具
當工具名稱、輸入、輸出或錯誤含糊不清時,代理就會失敗。此技能提供工具描述、結構描述、回應格式與測試的實用模式。
使用 SDK 模式建構 OpenAI Agents
在工具呼叫、交接和防護措施變得難以管理之前,Agent 專案需要清晰的結構。此技能為 Python 團隊提供可重複使用的 OpenAI Agents SDK 模式。
將此請求複製給你的智慧代理,其中包含權威 Skill 頁面和清單。
Review the Skillstore skill "scaffolding-openai-agents" from https://skillstore.io/skills/asmayaseen-scaffolding-openai-agents.md and its manifest at https://skillstore.io/api/skills/asmayaseen-scaffolding-openai-agents/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.你的智慧代理仍應顯示其計畫,並依安全政策請求必要確認。
當 AI Agent、爬蟲或腳本需要乾淨脈絡、而不是讀取完整頁面時,請使用這些連結。
正在使用「scaffolding-openai-agents」。 建立一個用於 Python 概念的初學者教學 agent。
預期結果:
一份包含 tutor agent、非同步 runner 流程、結構化指令和 guardrail 建議的計畫。
正在使用「scaffolding-openai-agents」。 為 assistant 新增天氣查詢工具。
預期結果:
一份工具設計摘要,包含型別化輸入、驗證備註、timeout 指引和 agent wiring 步驟。
正在使用「scaffolding-openai-agents」。 為支援問題設計 triage 流程。
預期結果:
一份多 Agent 路由大綱,包含 specialist 角色、handoff 描述和對話延續指引。
Most static command findings are false positives caused by Markdown fences and inline documentation. One high-risk finding is confirmed because SKILL.md presents eval(expression) in a function tool, which can execute arbitrary Python if copied. No prompt injection language was found, but the FastAPI example also exposes raw exception messages.
這些是真實的本機能力,對此技能而言可能是預期行為,因此需要複核,但不會按已確認的惡意行為計分。
分享版本化評估報告、中性徽章、嵌入卡片與引用。Skillstore 只報告證據,不判斷該 Skill 是否安全。
https://skillstore.io/skills/asmayaseen-scaffolding-openai-agents/audits/13?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report[](https://skillstore.io/skills/asmayaseen-scaffolding-openai-agents?utm_source=security_passport_badge)<a href="https://skillstore.io/skills/asmayaseen-scaffolding-openai-agents?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/asmayaseen-scaffolding-openai-agents/security.svg" alt="Skillstore security assessment" loading="lazy"></a><iframe src="https://skillstore.io/embed/skills/asmayaseen-scaffolding-openai-agents.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>Asmayaseen. (2026). scaffolding-openai-agents security audit report (audit version 13) [Author version unspecified]. Skillstore. https://skillstore.io/skills/asmayaseen-scaffolding-openai-agents/audits/13@techreport{asmayaseen-asmayaseen-scaffolding-openai-agents-2026,
author = {Asmayaseen},
title = {scaffolding-openai-agents security audit report (audit version 13)},
institution = {Skillstore},
year = {2026},
number = {13},
url = {https://skillstore.io/skills/asmayaseen-scaffolding-openai-agents/audits/13},
note = {Author version unspecified}
}cff-version: 1.2.0
message: "If you use this Skill, cite its author and this versioned security audit report."
title: "scaffolding-openai-agents security audit report (audit version 13)"
version: "unspecified"
type: report
authors:
- name: "Asmayaseen"
date-released: "2026-07-09"
url: "https://skillstore.io/skills/asmayaseen-scaffolding-openai-agents/audits/13"
identifiers:
- type: other
value: "skillstore:asmayaseen-scaffolding-openai-agents:audit:13"
description: "Skillstore immutable audit report identifier"
使用範本建立非同步 agents、工具函式,以及用於早期產品驗證的 FastAPI endpoint。
將專門 agents 與 handoffs 結合,讓使用者請求能針對每項任務送達正確的 agent。
調整 tutor、guardrail 和情境範例,用於引導式課程和練習工作流程。
使用此技能來 scaffold 一個簡單的 OpenAI Agents SDK assistant。包含 agent instructions、Runner 呼叫和設定備註。
使用此技能為現有 agent 新增型別化 function tools。包含安全的輸入驗證,並說明每個工具邊界。
使用此技能設計一個具備三位 specialists 的 triage agent。包含路由邏輯、handoff 描述和對話延續。
使用此技能檢視 agent 服務設計中的 guardrails、streaming、context handling、observability 和正式環境安全缺口。
作者
Asmayaseen授權
MIT
Skillstore 修訂
r1
版本提示
作者未聲明版本。
引用
3e4b6c31a74a3bd1a291c98cf585d720cb9fbc88
維護新鮮度
2026/7/20
使用量
9 次下載 · 220 次瀏覽
設計可靠的代理工具
當工具名稱、輸入、輸出或錯誤含糊不清時,代理就會失敗。此技能提供工具描述、結構描述、回應格式與測試的實用模式。
有系統地偵錯軟體問題
缺乏結構的錯誤修復會浪費時間,並可能掩蓋真正的失敗原因。此技能會引導 Claude、Codex 和 Claude Code 進行以證據為基礎的根本原因分析。
提升生產服務可靠性
生產團隊需要明確的可靠性目標與可重複執行的事故處理實務。此技能提供適用於 SLO、錯誤預算、告警與事後檢討的 SRE 範本。
在 Next.js 中建置 shadcn/ui 介面
React 團隊需要能與現代 Next.js 搭配運作的一致 UI 模式。此技能提供 shadcn/ui 設定指南、元件範例、表單驗證、資料表、側邊欄,以及深色模式模式。
建置串流式 AI 聊天介面
當使用者無法看到進度、回應狀態或 UI 變更時,即時 AI 聊天體驗會顯得不完整。此技能為 Claude、Codex 和 Claude Code 提供串流生命週期、進度事件、用戶端效果與用戶端工具的模式。
診斷上下文退化
長時間 AI 工作階段在上下文變長、出現衝突或包含干擾材料時,準確性可能下降。此技能可協助 Claude、Codex 和 Claude Code 識別退化模式,並選擇實用的緩解步驟。
建構可靠的 Async Python
由 0xDarkMatter
Async Python 程式碼經常因阻塞呼叫、未受限制的任務,以及薄弱的清理機制而失敗。此 skill 提供可重複使用的 asyncio 模式、範例與參考資料,用於打造穩健的並行服務。
使用可重用模式建置 FastAPI API
由 0xDarkMatter
FastAPI 專案需要在驗證、依賴項、middleware 和背景工作方面做出一致的選擇。這項技能為 Claude、Codex 和 Claude Code 提供可重用模式,用於實務 Python API 開發。
新增 Python 型別安全模式
由 0xDarkMatter
Python 型別註解在實際專案中可能難以一致套用。此 skill 為 Claude、Codex 和 Claude Code 提供實用模式,用於撰寫更安全的 typed Python code。
使用 pytest TDD 建置 Python 測試
由 89jobrien
Python 團隊經常需要一致的測試、覆蓋率和報告,同時不失去 TDD 紀律。此技能為 Claude、Codex 和 Claude Code 提供以 pytest 為核心的工作流程、範例與報告指南。
執行 Python 問候範例
由 EnactProtocol
新的 Enact 使用者需要一個小範例來證明工具執行能正常運作。此 skill 會執行一個 Python 問候指令,並回傳簡單的執行階段輸出。
安全移除無用程式碼
由 89jobrien
未使用的 imports、functions 和 classes 會增加維護成本與部署大小。此 skill 會引導 Claude、Codex 和 Claude Code 進行保守分析、備份、移除與驗證。