前言¶
在飞牛 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
