前言¶
做期貨交割研究的人，手上通常同時開着好幾張表：交易所的註冊倉單、指定交割庫的庫存、有效預報、產業庫存、臨近交割合約的持倉，還有合約期限和歷史交割數據。這些數據來自不同口徑——物理噸數、倉單張數、合約手數——直接拼在一起算不出有意義的結論。要麼把數量口徑統一了但忘了手數折算，要麼手數折了但同期基準沒對上。
繁微 Fiona 倉單庫存與交割數據這個 Skill，就是針對這條鏈路做的整合：輸入上述幾類數據，統一數量與合約手數口徑，輸出倉單覆蓋率、持倉保留率和同期對照結果。下面介紹它的定位、能力邊界和使用前需要準備的東西。
這是什麼¶
這是一個面向期貨交割研究的 Agent Skill，由東證期貨發佈，座標爲 @finoview/fiona-warehouse-delivery-pressure，當前版本 1.0.2，來源標記爲 enterprise，在 SkillHub 上分類爲 professional。
它解決的問題是：把分散在不同來源、不同計量單位上的倉單與交割數據，轉換成可以直接對比的比率指標，並提供同期對照，便於判斷某合約在臨近交割時的倉單壓力與持倉留存情況。
核心功能¶
按官方簡介，該 Skill 使用的數據輸入包括：
- 註冊倉單
- 指定交割庫庫存
- 有效預報
- 產業庫存
- 臨近交割合約持倉
- 合約期限
- 歷史交割數據
在口徑處理上，它同時做兩件事：一是統一物理數量口徑，二是把數量換算成合約手數口徑，避免出現「噸數直接當手數用」這類常見錯誤。
輸出側整理三項內容：
- 倉單覆蓋率：用倉單/庫存類數據衡量可供交割的實物對持倉的覆蓋程度。
- 持倉保留率：衡量臨近交割合約持倉中，有多少在交割窗口內保留到交割環節。
- 同期對照結果：把當前計算結果與同期基準放在一張對照裏，用於橫向比較。
安裝與啓用¶
已抓取資料中沒有給出該 Skill 的安裝命令或配置字段，只提供了名稱、座標、版本、來源和標籤。因此這裏不推測安裝方式，請以官方頁面爲準：
官方地址：https://api.skillhub.cn/finoview/fiona-warehouse-delivery-pressure
SkillHub 頁面：https://www.skillhub.cn/skills/finoview/fiona-warehouse-delivery-pressure
配置方面，標籤裏有一條硬性信息：requires_api_key=true。啓用前需要先準備好可用的 API Key，並按你所用的 Agent 運行時（Cursor、Codex CLI、Claude Code 等）把它配置到對應位置。具體字段名以官方頁面說明爲準，本文不做臆測。
典型用法¶
已抓取資料中沒有提供官方的可復現示例。下面按該 Skill 簡介中聲明的輸入與輸出，說明一次典型調用的形態，供你判斷是否需要這類能力；具體參數格式請參照官方頁面。
一次調用需要提供的輸入大致是：
- 目標合約與臨近交割日期，用於確定「臨近交割合約」的範圍。
- 註冊倉單數量、指定交割庫庫存數量、有效預報數量、產業庫存數量。
- 該合約的持倉量（手數）。
- 合約期限信息，以及用於同期對照的歷史交割數據。
調用後得到的是口徑統一後的結果，而不是原始數據表：
- 倉單覆蓋率，數量口徑與手數口徑各一份。
- 持倉保留率。
- 同期對照結果，用於判斷當前值相對同期的位置。
如果只想看某一兩項指標，建議在調用時明確指定，避免返回完整對照帶來的額外開銷。
適用場景與注意¶
適合的場景：
- 臨近交割合約的倉單壓力判斷，需要把倉單、庫存、預報和持倉放在一起看。
- 需要把物理數量換算成合約手數後再做覆蓋率或保留率計算。
- 需要同期對照，而不是隻看單個時點的絕對值。
需要注意的點：
- 需要 API Key。
requires_api_key=true意味着沒有配置好憑證時調用不會成功，先確認憑證可用再排其他問題。 - 版本信息。當前版本 1.0.2，屬於早期版本，接口或字段後續可能有調整，升級前建議覈對官方頁面的版本記錄。
- 輸入數據質量決定輸出質量。註冊倉單、交割庫庫存、產業庫存來自不同口徑，入庫前確認它們的統計時點和統計範圍一致，否則覆蓋率會被口徑差異污染。
- 該 Skill 只做口徑統一與指標計算，不負責數據源採集。你需要先自行拿到上述七類數據，再交給它處理。
- 本文依據的抓取資料未包含安裝命令、配置字段和官方示例，這些部分請以官方頁面爲準。
結尾¶
這個 Skill 的價值在於把交割研究中最容易出錯的環節——數量與手數的口徑統一——固化成一次調用，輸出倉單覆蓋率、持倉保留率和同期對照。它不替代數據採集，也不提供行情預測，只是把已經拿到的數據按統一口徑算清楚。
官方地址：https://api.skillhub.cn/finoview/fiona-warehouse-delivery-pressure
SkillHub 頁面：https://www.skillhub.cn/skills/finoview/fiona-warehouse-delivery-pressure
