bruno-api
記錄 Bruno API 端點
Bruno API 集合經常會與後端行為脫節。此技能會將 .bru 請求對應到 Django 或 Ninja 程式碼,並產生包含參照的端點文件。
使用我的智慧代理安裝
將此請求複製給你的智慧代理,其中包含權威 Skill 頁面和清單。
Review the Skillstore skill "bruno-api" from https://skillstore.io/skills/diversioteam-bruno-api.md and its manifest at https://skillstore.io/api/skills/diversioteam-bruno-api/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.你的智慧代理仍應顯示其計畫,並依安全政策請求必要確認。
Agent 可讀資源
當 AI Agent、爬蟲或腳本需要乾淨脈絡、而不是讀取完整頁面時,請使用這些連結。
測試它
正在使用「bruno-api」。 使用者要求為一個 Bruno 端點檔案產生文件。
預期結果:
一份 markdown 端點文件,包含概述、請求欄位、回應行為、實作參照、業務邏輯、測試註記和缺口。
正在使用「bruno-api」。 使用者要求對一個 Bruno 請求執行 dry run。
預期結果:
一份簡短計畫,列出端點摘要、可能的 Django 檔案、文件章節和預期的實作複雜度。
正在使用「bruno-api」。 使用者掃描 Bruno 檔案目錄。
預期結果:
為每個檔案分組的端點文件,並在找不到後端 route 或 permission 邏輯時附上阻斷註記。
安全審計
安全All static external command findings are false positives caused by Markdown backticks in documentation text. The skill describes reading Bruno files, searching Django code, and optionally writing generated documentation, with no evidence of prompt injection or malicious intent.
風險因素
⚙️ 外部命令 (38)
分享與引用此報告
分享版本化評估報告、中性徽章、嵌入卡片與引用。Skillstore 只報告證據,不判斷該 Skill 是否安全。
複製報告連結
https://skillstore.io/skills/diversioteam-bruno-api/audits/9?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_reportMarkdown 徽章
[](https://skillstore.io/skills/diversioteam-bruno-api?utm_source=security_passport_badge)HTML 徽章
<a href="https://skillstore.io/skills/diversioteam-bruno-api?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/diversioteam-bruno-api/security.svg" alt="Skillstore security assessment" loading="lazy"></a>嵌入卡片
<iframe src="https://skillstore.io/embed/skills/diversioteam-bruno-api.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 引用
DiversioTeam. (2026). bruno-api security audit report (audit version 9) [Author version unspecified]. Skillstore. https://skillstore.io/skills/diversioteam-bruno-api/audits/9BibTeX 引用
@techreport{diversioteam-diversioteam-bruno-api-2026,
author = {DiversioTeam},
title = {bruno-api security audit report (audit version 9)},
institution = {Skillstore},
year = {2026},
number = {9},
url = {https://skillstore.io/skills/diversioteam-bruno-api/audits/9},
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: "bruno-api security audit report (audit version 9)"
version: "unspecified"
type: report
authors:
- name: "DiversioTeam"
date-released: "2026-07-06"
url: "https://skillstore.io/skills/diversioteam-bruno-api/audits/9"
identifiers:
- type: other
value: "skillstore:diversioteam-bruno-api:audit:9"
description: "Skillstore immutable audit report identifier"
Skillstore 評分
評分依據 證據置信度: 高你可以打造什麼
記錄現有端點
將一個 Bruno 請求轉換為連結後端的端點文件,包含請求、回應、auth 和實作細節。
檢閱 API 覆蓋範圍
掃描 Bruno 檔案目錄,並識別多個後端端點的文件缺口。
準備前端整合註記
產生端點指引,包含請求合約、回應預期和前端整合範例。
試試這些提示
使用 bruno-api 處理 api/users/get-user.bru,並在聊天中回傳文件。
對 api/accounts/update-profile.bru 使用 bruno-api 搭配 --dry-run。顯示你將在哪裡檢查 Django 實作。
使用 bruno-api 搭配 --scan api/bruno/admin。依 Bruno 檔案分組產生的端點文件。
使用 bruno-api 搭配 --scan api/bruno/pulse --output docs/api/pulse-endpoints.md。包含 auth、tenant filtering 和程式碼參照。
最佳實務
- 當端點 route 難以定位時,先執行 dry run。
- 將 Bruno 檔案和後端原始碼保留在同一個工作區中。
- 在將文件發布給其他團隊前,先檢閱產生的假設。
避免
- 當後端原始碼無法取得時,不要使用它。
- 不要將產生的範例視為即時 API 測試結果。
- 不要將輸出檔案寫入作用中專案工作區之外。
常見問題
這項技能需要什麼輸入?
它針對哪些後端框架?
它可以為許多端點產生文件嗎?
它可以將文件寫入檔案嗎?
它會驗證即時 API 回應嗎?
當實作細節不明確時會發生什麼事?
開發者詳細資訊
作者
DiversioTeam授權
MIT
Skillstore 修訂
r1
版本提示
作者未聲明版本。
引用
72d5025b022c77f7a51bdf5c1637c689c80e89d1
維護新鮮度
2026/7/18
使用量
8 次下載 · 175 次瀏覽
檔案結構
📄 SKILL.md