前言¶
在飛牛 fnOS 上做應用開發，第一步往往不是寫代碼，而是找文檔：Manifest 怎麼寫、應用權限怎麼申請、開放 API 有哪些、Docker 鏡像怎麼構建。這些信息分散在官網的不同頁面裏，版本一更新還容易對不上。下面介紹的 fnnas-docs，就是把這套文檔整理成一個 Agent Skill，讓開發問答時能直接按文檔回答，而不是憑訓練數據裏的印象。
這是什麼¶
fnnas-docs 是一個基於通用 SKILL.md 格式的文檔型 Skill，定位是飛牛 fnOS 應用開發的參考手冊。它由社區開發者 user_5c85a23c 維護，在 SkillHub 上以 community 來源發佈，分類爲 dev-programming，當前版本 1.1.2。它解決的問題很具體：當用戶問起飛牛應用開發的相關問題時，Agent 能加載這份結構化文檔，而不是臨時去檢索零散的網頁。
SkillHub 頁面的公開數據是：評分 100000，下載 1356 次，安裝 0 次。安裝量爲 0 可能與上架時間較短或統計口徑有關，不代表文檔內容有問題。
覆蓋內容¶
根據官方簡介，這份文檔包含六個部分，覆蓋從入門到發佈的完整鏈路：
- 快速開始：新建應用、跑通第一個 fnOS 應用的起步流程。
- 開發指南：應用開發的常規流程與約定。
- 開放 API：fnOS 對外暴露的接口，以及調用方式。
- CLI 工具參考：配套命令行工具的參數與用法。
- 應用案例：已有應用的實現示例。
- 更新日誌：文檔和 SDK 自身的版本變化。
從覆蓋範圍看，它沒有把自己做成通用 SDK，而是圍繞 fnOS 這一個目標系統做縱深，這對減少回答裏的臆測有幫助。
安裝與啓用¶
SkillHub 頁面沒有公開標準化的一鍵安裝命令，也沒有給出 Cursor、Codex CLI、Claude Code 各自的差異化安裝說明。目前能覈實到的獲取方式是訪問官方頁面：
https://api.skillhub.cn/user_5c85a23c/fnnas-docs
SkillHub 頁面地址爲：
https://www.skillhub.cn/skills/user_5c85a23c/fnnas-docs
啓用方式遵循通用 SKILL.md 格式的慣例：把該 Skill 放到 Agent 的 Skills 目錄後，當用戶提問涉及飛牛應用開發時觸發。標籤 requires_api_key=false 說明它不依賴外部 API Key，加載後即可直接使用。
典型用法¶
這份 Skill 的用法不是命令行調用，而是問答式。當用戶的問題命中它覆蓋的主題時，Agent 會按文檔內容作答。官方簡介裏列出的觸發場景包括：
- 飛牛應用開發的整體流程；
- 開放 API 的接口與調用；
- JS SDK 的使用；
- 文件授權的配置；
- Manifest 配置字段；
- 應用權限的申請與聲明；
- Docker 構建與鏡像要求。
例如用戶問「飛牛應用的 Manifest 裏權限字段怎麼填」，或「用 Docker 構建飛牛應用需要注意什麼」，這類問題都屬於它明確覆蓋的範圍。回答質量取決於文檔本身，建議在提問時把具體場景說清楚，例如目標 fnOS 版本、是新開發還是遷移已有應用。
適用場景與注意¶
適合三類人：剛開始在 fnOS 上做應用的開發者、需要查開放 API 細節的集成方、以及想按官方約定檢查 Manifest 和權限配置的維護者。
需要留意的點有三個。第一，文檔型 Skill 只提供參考信息，不能替代實際的構建和調試，遇到編譯或運行問題仍需在本機復現。第二，fnOS 本身迭代較快，文檔版本 1.1.2 不一定覆蓋最新接口，使用前建議覈對更新日誌。第三，社區維護的文檔在準確性和時效性上不如官方文檔，遇到關鍵配置建議以飛牛官方渠道爲準。
結尾¶
fnnas-docs 的價值在於把飛牛 fnOS 應用開發分散的文檔收攏成一個可被 Agent 直接加載的 Skill，覆蓋快速開始、開放 API、JS SDK、文件授權、Manifest、權限和 Docker 構建。如果你在 fnOS 上做應用開發，可以從官方頁面開始試用：
https://api.skillhub.cn/user_5c85a23c/fnnas-docs
