简介

安装 fh2-plugin-dev 后，可以直接向 AI 描述要做的插件。AI 会协助澄清需求、查可用接口、提出方案，并在确认后创建或修改工程、执行校验与测试，最后报告实际结果。

不需要先背扩展点和命令，也不必写很长的提示词。说清要解决什么问题、在哪个页面用、数据从哪来，就足够开始。完整说明见 AI 开发 Skill。

一次对话怎样推进

1. 描述目标：例如「在驾驶舱加一个现场问题面板」，也可以提供现有工程和要改的行为。
2. 澄清需求：AI 分轮询问使用场景、数据来源、是否需要保存等问题；推荐项只是建议，不代表已经确认的需求。
3. 查证并确认方案：AI 查当前工程类型和配套知识，给出《插件设计方案概要》。确认范围、目录和操作影响后再执行。
4. 执行与复验：AI 修改源码、补充测试、运行适用命令；有错误就基于证据修复，缺公开接口时说明缺口，不编造 API。
5. 核对实际结果：报告实际执行的命令与观察，区分代码检查、本地页面行为和目标环境验证；没有执行的项目不能报告为通过。

提示词不用写长，按目标、约束、验收三段说明即可：

目标：在驾驶舱加一个现场问题面板，能上报和查看列表。
约束：数据保存到后端，复用现有 issue 接口，不改其他页面。
验收：创建后刷新能读回；缺标题时显示错误；重复提交不产生两条。

可以交给 AI 的任务

想做什么	完成后得到什么	章节
让 AI 认识 FH2 插件开发流程	客户端能加载完整 Skill，环境状态可解释	安装与复验
第一次创建插件工程	经确认创建的完整工作区和验证结果	第一个工程
把示例改成自己的功能	现场问题上报等真实需求的具体对话过程	真实需求示例
给已有插件加功能或加成员	保留现有配置和改动的增量实现	改造已有工程
插件跑不起来，或准备交付	可追溯的诊断、测试结果和交付物	调试与交付

Skill、工具和示例的分工

• Skill：规定 AI 什么时候提问、查什么资料、怎样执行和汇报。
• Toolchain：实际创建、生成、校验、构建和调试工程的工具。
• 示例：提供可阅读、可修改的业务起点。

安装 Skill 不等于安装 Toolchain，注册 CLI 也不会自动安装 Skill。新建工程使用创建向导，选择「完整 Capability」会得到保留完整行业包结构的工作区；只做前端或只做后端时，调整的是成员组合。已有工程先识别结构，不重新创建。

使用边界

方案确认不等于无限授权：安装、配置、常驻服务、真实环境和打包操作需要按类别说明影响并分别确认。代码审查与业务验收仍由相应人员负责，模拟事件或工作流画布不能当作真实飞行结果。

完整章节

AI 开发 Skill；想先手动认识工程，可以看第一个插件。