fnOS Developer Skill 介绍
这是什么？
fnOS Developer Skill 是一套专门用于开发飞牛 fnOS 应用的 AI 开发规则和工具。
安装后，只要在需求里说明“使用 fnos-developer Skill”，就可以让 AI 按照飞牛应用规范，帮助你创建、修改、检查并打包 .fpk 应用。
它更像一本给 AI 使用的“飞牛开发手册”。即使你代码基础不高，也可以先用大白话描述应用功能，再让 AI 完成大部分工程工作。
这个 Skill 能做什么？
1. 从零创建飞牛应用
可以根据你的需求生成一个完整的 fnOS 应用工程，包括：
- 应用名称、版本、说明等基本信息；
- 应用图标和桌面入口；
- 安装、启动、停止、升级和卸载脚本；
- 权限、资源、依赖和数据目录配置；
- 安装向导和应用页面；
- 最终用于打包
.fpk 的完整目录。
2. 改造已有项目
可以把现有的网页、Node.js 服务、Docker 项目或其他开源项目，整理成符合 fnOS 规范的应用包。
它会根据项目情况选择合适的运行方式，例如：
- 静态页面；
- 独立端口服务；
- fnOS 统一网关；
- Docker 应用。
3. 接入飞牛系统能力
可以帮助应用接入：
- 飞牛桌面入口；
- 当前登录用户信息；
- 文件和文件夹选择；
- 用户文件授权；
- 文件访问权限检查；
- 飞牛开放 API；
- 统一网关和 WebSocket。
4. 检查和排查问题
它可以检查已有工程中常见的问题，例如：
manifest 字段错误；- 权限申请过多或配置不正确；
- 启动、停止脚本有问题；
- 写死安装路径；
- Token 泄露；
- 文件路径越权；
- 升级或卸载时误删用户数据；
- 安装失败、接口无权限或应用无法启动。
仓库还带有一个检查脚本：
python scripts/validate_fnos_project.py /你的项目路径
这个脚本适合提前发现常见问题，但最终仍要通过 fnpack 打包并在 fnOS 设备上测试。
如何使用这个 Skill？
安装并加载 Skill 后，直接把需求告诉 AI，并明确要求使用 fnos-developer Skill。
从零开发一个应用
请使用 fnos-developer Skill，帮我开发一个飞牛 fnOS 应用。
应用名称：家庭记账本
主要功能：记录收入和支出，查看每月统计。
使用对象：所有普通用户。
数据要求：保存在应用自己的数据目录中。
界面要求：中文，电脑和手机都能使用。
请先确定合适的运行方式，然后创建完整工程，检查权限和路径安全，最后使用 fnpack 打包为 .fpk。
把现有项目改成 FPK
请使用 fnos-developer Skill 检查当前项目，并把它改造成可以安装到飞牛 fnOS 的 .fpk 应用。
请尽量保留现有代码，补齐 manifest、config、cmd、wizard、图标和应用入口，并给出构建和测试方法。
检查安装失败的问题
请使用 fnos-developer Skill 检查这个 fnOS 项目。
下面是安装或启动时的报错：
【粘贴报错内容】
请先判断最可能的原因，再检查项目文件并直接修复。修复后重新执行项目检查和 fnpack build。
推荐的使用流程
- 用大白话说明应用要实现什么功能。
- 让 Skill 判断应用应该使用哪种运行方式。
- 让它直接创建或修改完整项目文件，不要只输出零散示例代码。
- 运行项目检查脚本。
- 使用官方工具构建：
fnpack build --directory /你的项目路径
- 把生成的
.fpk 安装到专用 fnOS 设备测试。
- 遇到报错时，把完整日志交给 Skill 继续排查。
使用时最好提供哪些信息？
描述需求时，尽量说明：
- 应用名称和主要功能；
- 谁可以使用；
- 是否需要读取用户文件；
- 是否需要联网或调用飞牛 API；
- 数据是否需要长期保留；
- 是否已有网页、程序或 Docker 项目；
- 目标设备是 x86、ARM，还是都要支持。
信息不完整也可以先开始，Skill 会根据项目情况补充必要问题。
需要注意
这个 Skill 能大幅减少查文档、搭目录和排错的工作，但它不能代替真实设备测试。
最终发布前，仍然需要确认：
.fpk 可以正常安装和升级；- 应用可以启动、停止和卸载；
- 普通用户和管理员权限符合预期；
- 用户文件不会被越权访问；
- 卸载和升级不会误删重要数据。
项目地址：FNOSP/fnos-developer-skill
