fiftyone-code-style
套用 FiftyOne Python 程式碼風格
FiftyOne 貢獻者需要在 imports、docstrings、工具函式與驗證方面維持一致的 Python 風格。此技能提供專注的慣例與檢查清單,協助撰寫相容的程式碼。
使用我的智慧代理安裝
將此請求複製給你的智慧代理,其中包含權威 Skill 頁面和清單。
Review the Skillstore skill "fiftyone-code-style" from https://skillstore.io/skills/adonaivera-fiftyone-code-style.md and its manifest at https://skillstore.io/api/skills/adonaivera-fiftyone-code-style/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.你的智慧代理仍應顯示其計畫,並依安全政策請求必要確認。
Agent 可讀資源
當 AI Agent、爬蟲或腳本需要乾淨脈絡、而不是讀取完整頁面時,請使用這些連結。
測試它
正在使用「fiftyone-code-style」。 含有混合 import 順序且缺少 logger 設定的新 FiftyOne 模組。
預期結果:
- 將標準函式庫 imports 移到第三方、eta 與 FiftyOne imports 之前。
- 在 imports 後加入模組層級 logger 設定。
- 對核心模組使用已文件化的 FiftyOne 別名。
正在使用「fiftyone-code-style」。 使用非正式註解而非公開 API docstring 的函式。
預期結果:
- 使用包含簡短摘要的 Google 風格 docstring。
- 為每個參數新增 Args 項目,並在有幫助時包含預設值。
- 僅在函式行為需要時新增 Returns 與 Raises 區段。
正在使用「fiftyone-code-style」。 在模組載入時匯入大型選用依賴的外掛變更。
預期結果:
- 對選用或大型依賴使用 lazy import 指引。
- 為缺少的選用套件新增清楚的 fallback 或警告路徑。
- 確認驗證檢查清單涵蓋 linting、格式化與目標測試。
安全審計
安全All 74 static findings were adjudicated as false positives. The matches are Markdown code fences, inline code, a documentation URL, fixed example validation commands, or a style-guide heading, with no executable malicious behavior found.
風險因素
⚙️ 外部命令 (72)
🌐 網路存取 (1)
分享與引用此報告
分享版本化評估報告、中性徽章、嵌入卡片與引用。Skillstore 只報告證據,不判斷該 Skill 是否安全。
複製報告連結
https://skillstore.io/skills/adonaivera-fiftyone-code-style/audits/8?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_reportMarkdown 徽章
[](https://skillstore.io/skills/adonaivera-fiftyone-code-style?utm_source=security_passport_badge)HTML 徽章
<a href="https://skillstore.io/skills/adonaivera-fiftyone-code-style?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/adonaivera-fiftyone-code-style/security.svg" alt="Skillstore security assessment" loading="lazy"></a>嵌入卡片
<iframe src="https://skillstore.io/embed/skills/adonaivera-fiftyone-code-style.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 引用
AdonaiVera. (2026). fiftyone-code-style security audit report (audit version 8) [Author version unspecified]. Skillstore. https://skillstore.io/skills/adonaivera-fiftyone-code-style/audits/8BibTeX 引用
@techreport{adonaivera-adonaivera-fiftyone-code-style-2026,
author = {AdonaiVera},
title = {fiftyone-code-style security audit report (audit version 8)},
institution = {Skillstore},
year = {2026},
number = {8},
url = {https://skillstore.io/skills/adonaivera-fiftyone-code-style/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: "fiftyone-code-style security audit report (audit version 8)"
version: "unspecified"
type: report
authors:
- name: "AdonaiVera"
date-released: "2026-07-06"
url: "https://skillstore.io/skills/adonaivera-fiftyone-code-style/audits/8"
identifiers:
- type: other
value: "skillstore:adonaivera-fiftyone-code-style:audit:8"
description: "Skillstore immutable audit report identifier"
Skillstore 評分
評分依據 證據置信度: 高你可以打造什麼
準備 FiftyOne 貢獻
在提交 pull request 前,讓新模組、imports、docstrings 與輔助函式符合 FiftyOne 儲存庫慣例。
建立一致的外掛
撰寫 FiftyOne 外掛程式碼時,使用文件化的別名、lazy import 指引與驗證檢查清單。
審查 Python 變更
依據精簡檢查清單,比對提議程式碼的 import 排序、工具重用、docstrings、logging 與測試。
試試這些提示
請審查此 Python 模組是否符合 FiftyOne 程式碼風格。著重於 import 群組、別名、模組版面、logger 設定與私有輔助函式命名。
請依照 FiftyOne Google 風格模式重寫這些 docstrings。僅在適用時包含 Args、Returns 與 Raises 區段。
請檢查此實作是否包含重複的輔助函式。建議可取代自訂路徑、JSON、影像或型別檢查邏輯的現有 FiftyOne 或 eta 工具。
請對此變更執行 FiftyOne 風格檢查。檢查 import 組織、lazy imports、防護模式、警告行為、工具重用、測試與 lint 指令。
最佳實務
- 在進行更深入的風格變更前,先套用 import 群組順序。
- 建立新的輔助函式前,先檢查現有 FiftyOne 與 eta 工具。
- 套用指引後,執行 linting、格式化檢查與目標測試。
避免
- 不要將範例視為儲存庫 CI 的完整替代品。
- 當 lazy imports 適用時,不要在模組載入時加入大型 imports。
- 未先檢查 FiftyOne 與 eta 模組前,不要建立重複工具。
常見問題
此技能能協助什麼?
它會自動修改檔案嗎?
我可以將它用於 FiftyOne 外掛嗎?
它會執行 pylint、black 或 pytest 嗎?
它在 FiftyOne 之外有用嗎?
哪些助理可以使用它?
開發者詳細資訊
作者
AdonaiVera授權
MIT
Skillstore 修訂
r1
版本提示
作者未聲明版本。
引用
c1fdca50ff516318f65fed0d7f9e82797c5171dc
維護新鮮度
2026/7/18
使用量
6 次下載 · 292 次瀏覽
檔案結構
📄 SKILL.md