📦
prompt-engineering-patterns
86优化生产环境 LLM 提示词
LLM 提示词经常失败，是因为指令、示例和评估标准不清晰。此技能提供模板和工作流，用于改进 Claude、Codex、Claude Code 以及类似工具中的提示词。
效率 查看
技能 openapi-spec-generation
📦
openapi-spec-generation
内容修订 r1 安全 ⚙️ 外部命令🌐 网络访问
生成 OpenAPI 规范
API 团队需要准确的契约来支持文档、验证和 SDK 生成。此技能提供 OpenAPI 3.1 模式、模板和工具使用指导。
支持: Claude Codex Code(CC)
使用我的智能体安装
将此请求复制给你的智能体，其中包含权威 Skill 页面和清单。
智能体请求
Review the Skillstore skill "openapi-spec-generation" from https://skillstore.io/skills/wshobson-openapi-spec-generation.md and its manifest at https://skillstore.io/api/skills/wshobson-openapi-spec-generation/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.你的智能体仍应展示其计划，并按安全策略请求必要确认。
Agent 可读资源
当 AI Agent、爬虫或脚本需要干净上下文，而不是读取完整页面时，请使用这些链接。
测试它
正在使用“openapi-spec-generation”。 记录用户管理 API 的请求。
预期结果:
- 包含用户路径、可复用模式、响应模型和安全要求的结构化 OpenAPI 大纲。
- 所需后续详情列表，例如分页规则、错误代码和身份验证行为。
正在使用“openapi-spec-generation”。 准备用于 SDK 生成的规范的请求。
预期结果:
- 针对 operation IDs、模式命名、媒体类型和响应示例的验证检查清单。
- 针对客户端库的推荐生成器目标和包命名决策。
正在使用“openapi-spec-generation”。 改进现有 API 契约的请求。
预期结果:
- 识别缺失描述、不一致模式和薄弱错误文档的审查摘要。
- 面向发布和消费者就绪性的优先级修复步骤。
安全审计
安全v8 • 2026/7/8 打开版本化报告
The flagged patterns are false positives from Markdown code fences, sample OpenAPI URLs, resource links, UUID schema examples, and generic error responses. No prompt injection, hidden command execution, credential access, or data exfiltration intent was found in SKILL.md.
1
已扫描文件
1,029
分析行数
0
复核项
0
已忽略误报
风险因素
⚙️ 外部命令 (11)
最新一次完成的静态与语义审计未检测到已确认的安全发现。这并不能证明该 Skill 没有副作用。
审计者: codex 查看审计历史 →
分享与引用此报告
分享版本化评估报告、中性徽章、嵌入卡片和引用。Skillstore 只报告证据，不判断该 Skill 是否安全。
复制报告链接
https://skillstore.io/skills/wshobson-openapi-spec-generation/audits/8?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_reportMarkdown 徽章
[](https://skillstore.io/skills/wshobson-openapi-spec-generation?utm_source=security_passport_badge)HTML 徽章
<a href="https://skillstore.io/skills/wshobson-openapi-spec-generation?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/wshobson-openapi-spec-generation/security.svg" alt="Skillstore security assessment" loading="lazy"></a>嵌入卡片
<iframe src="https://skillstore.io/embed/skills/wshobson-openapi-spec-generation.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 引用
wshobson. (2026). openapi-spec-generation security audit report (audit version 8) [Author version unspecified]. Skillstore. https://skillstore.io/skills/wshobson-openapi-spec-generation/audits/8BibTeX 引用
@techreport{wshobson-wshobson-openapi-spec-generation-2026,
author = {wshobson},
title = {openapi-spec-generation security audit report (audit version 8)},
institution = {Skillstore},
year = {2026},
number = {8},
url = {https://skillstore.io/skills/wshobson-openapi-spec-generation/audits/8},
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: "openapi-spec-generation security audit report (audit version 8)"
version: "unspecified"
type: report
authors:
- name: "wshobson"
date-released: "2026-07-08"
url: "https://skillstore.io/skills/wshobson-openapi-spec-generation/audits/8"
identifiers:
- type: other
value: "skillstore:wshobson-openapi-spec-generation:audit:8"
description: "Skillstore immutable audit report identifier"
比较变体
2 个可安装变体每位作者的技能都保持为独立的可安装项。推荐变体按 Skillstore 证据排序。
为什么此变体排名第一
Skillstore 评分最高
Skillstore 评分
评分依据 证据置信度: 高 55
架构
85
可维护性
87
内容
71
社区
70
规范符合性
你能构建什么
创建新的 API 契约
在实现前起草 OpenAPI 3.1 规范，包括路径、请求体、错误和身份验证。
记录现有服务
将 FastAPI 或 TypeScript 控制器模式转换为面向内部和外部消费者的一致 OpenAPI 规范。
准备 SDK 生成
在为多种语言生成客户端库之前，验证、打包并组织 OpenAPI 文件结构。
试试这些提示
开始基础规范
为一个简单的资源 API 创建 OpenAPI 3.1 草稿。包括路径、模式、示例、错误和 bearer 身份验证。
审查现有规范
审查此 OpenAPI 文件，检查缺失的 operation IDs、不完整的响应覆盖、模式复用和不清晰的描述。
从代码生成
使用此 FastAPI 或 tsoa 代码设计匹配的 OpenAPI 契约。突出实现与已记录行为之间的差距。
构建验证工作流
为此 OpenAPI 规范设计验证工作流，包括 linting、打包、破坏性变更检查和 SDK 生成就绪性。
最佳实践
- 使用可复用的模式、参数、响应和示例来保持契约一致。
- 为每个受保护的操作定义身份验证、授权和错误响应。
- 在发布文档或生成 SDK 前运行 linting 和打包检查。
避免
- 不要在生产规范中保留占位域名、含糊描述或仅用于示例的模式。
- 不要从存在未解析引用或无效示例的规范生成 SDK。
- 不要让代理在未先审查输出路径的情况下运行安装或生成命令。
常见问题
此技能会创建 OpenAPI 3.1 规范吗？
是。它提供用于 OpenAPI 3.1 路径、模式、响应、示例和安全方案的模板与模式。
它可以基于现有代码工作吗？
可以。它包含 FastAPI 和 TypeScript tsoa 模式的代码优先示例。
它会自动验证规范吗？
它提供验证工作流和命令示例。代理仍需要权限以及正确的本地工具才能运行它们。
它可以生成客户端 SDK 吗？
它说明如何为 TypeScript、Python 和 Go 客户端准备并运行 SDK 生成。
发布它安全吗？
可以，但带有中等风险提示。命令示例是合法的，但用户应在执行前进行审查。
用户应提供什么才能获得最佳结果？
请提供 API 端点、请求和响应模型、身份验证规则、错误格式以及目标 SDK 语言。
开发者详情
作者
wshobson许可证
MIT
Skillstore 修订
r1
版本提示
作者未声明版本。
引用
64ca8af0f54a325752f08bd54e52151061ea659a
维护新鲜度
2026/7/22
使用量
12 次下载 · 242 次浏览
文件结构
📄 SKILL.md
wshobson 的更多技能
查看全部📦
context-driven-development
81管理上下文驱动开发
当产品目标、技术栈选择和工作流规则分散各处时，AI 辅助项目会失去一致性。此技能通过 Conductor 上下文工件指导 Claude、Codex 和 Claude Code。
编码与开发 查看
📦
startup-financial-modeling
80构建初创公司财务模型
初创团队在规划招聘、融资和现金使用之前，需要清晰的预测。此技能将收入、成本、资金可支撑时间和情景分析组织成实用的财务规划输出。
数据与分析 查看
📦
kpi-dashboard-design
79设计推动决策的 KPI 仪表板
团队经常构建展示大量数字却无法指导行动的仪表板。此技能可帮助 Claude、Codex 和 Claude Code 选择有意义的 KPI、组织视图，并清晰呈现指标。
设计与创意 查看
📦
postmortem-writing
79编写无责事故复盘
事故评审常常变得不一致、侧重追责，或难以转化为行动。此技能帮助 Claude、Codex 和 Claude Code 起草结构化复盘，包含清晰的时间线、根本原因和负责人。
写作与内容 查看
📦
data-storytelling
79构建清晰的数据故事
原始指标往往难以说服利益相关者或支持决策。此技能帮助 Claude、Codex 和 Claude Code 将分析塑造成清晰的叙事、视觉呈现和建议。
数据与分析 查看
相关技能
查看全部📦
api-documentation
78创建清晰的 API 文档
由 supercent-io
API 团队需要准确的文档来说明端点、架构、身份验证和错误。此技能可将 API 细节转化为结构化参考文档和指南。
文档 查看
📦
api-documenter
78创建准确的 API 文档
由 sickn33
当规范、示例和门户与真实行为不一致时，API 团队会浪费时间。此技能指导 Claude、Codex 和 Claude Code 创建准确且可维护的 API 文档。
文档 查看
📦
api-documentation-generator
78生成清晰的 API 文档
由 sickn33
当端点行为不清晰时，API 团队常常会浪费时间。此技能可将代码和示例转化为结构化、对开发者友好的文档。
文档 查看
📦
api-doc-generator
80生成 API 文档
由 zhangchenlai-dev
手动编写的 API 文档往往落后于代码，并给开发者造成困惑。此技能可根据可用代码或端点详情，帮助生成 OpenAPI 草稿、请求示例和 Postman collection 指南。
文档 查看
📦
documentation-generation-doc-generate
79生成可维护的代码文档
由 sickn33
手动文档通常会落后于活跃代码。此技能可帮助 Claude、Codex 和 Claude Code 创建清晰的文档和自动化计划。
文档 查看
📦
documentation
79创建完整的技术文档
由 89jobrien
技术团队需要覆盖 API、发布和迁移的清晰文档。此技能可使用模板和实用示例创建结构化文档。
文档 查看