上位机 AI 开发工作流

Appearance

先读我：阅读路线 ​

这套资料不是一本要从头读到尾的书。

它是一套 AI 辅助上位机开发工具箱。你先判断当前任务属于哪一类，再只读对应文件。

1. 新编号规则 ​

现在根目录文件按数字段分组：

编号段类型作用
00-07入口、地图和环境第一次拿到资料、判断怎么读、选择 AI 开发工具、了解市场现状、处理加密软件环境
10-12新项目和大功能前置问题定义、需求拆解、阶段质量门
20-23开发专题WPF、通信、架构决策、界面原型到 WPF 开发
30-31验收和复盘回归测试、交付验收、经验沉淀
40-50通用辅助材料（ChatGPT/Skill 用户都能用）Bug 流程、Prompt 库、Goal 模式
60-61Skill/Agenthost-computer-dev Skill 使用说明、二次定制和成长
70-81参考材料案例、旧版路径、新手详细说明

看到文件名就应该能判断它的层级，不再使用 00A、02A、03A 这种补丁式编号。

1.1 一条完整开发主线 ​

从工控软件和上位机开发角度看，一条完整链路通常不是“直接写代码”，而是：

text
技术要求 / 客户资料
  -> 需求整理
  -> 需求拆分
  -> 技术设计
  -> 任务拆解
  -> 软件框架
  -> UI 界面
  -> 通信 / 协议 / 数据 / 日志
  -> 联调测试
  -> 回归测试
  -> FAT / SAT / 现场交付
  -> 复盘沉淀

对应到本资料包：

阶段主要看什么输出什么
技术要求进入10、11第一版需求方案、待确认问题
需求拆分11、12页面、流程、通信、数据、验收拆分
技术设计20、21、22、23架构、界面、通信、数据流、风险点
任务下发12、50、Skill 模板可执行任务卡、影响范围、验收点
软件框架和 UI20、23项目结构、页面区域、ViewModel/Service 职责
通信和数据开发21、数据相关 Skill连接、协议、缓存、解析、保存、日志
测试验收30冒烟、回归、通信专项、长稳、验收证据
交付复盘30、31发布记录、FAT/SAT 记录、复盘和模板优化

这条主线只是默认路线。小改、明确 Bug、局部页面调整不需要完整跑一遍。

1.2 两种 AI 协作模式 ​

使用这套资料时，不是永远都要把模板填满。按任务清晰度和风险，分两种模式。

总原则：有限规则内给 AI 最大自由 ​

你给 AI 的重点不是“代码具体怎么写”，而是给它一个清楚的工作框架：

text
目标是什么
现在是什么情况
不希望影响什么
已有材料有哪些
风险边界在哪里
完成后怎么验收

在这个框架内，尽量让 AI 自己发挥。不要一开始就强行规定方法名、类名、字段名、函数内部步骤、具体代码写法。除非你已经确认这些细节必须这样做，否则过早限制 AI，反而会降低它拆方案、找更合适实现方式的能力。

更好的问法是：

text
我给你目标、现状、边界和验收标准。
请你在这些规则范围内，自行判断合适的实现方案。
不要先问我要具体方法名、类名或每一步代码细节。
如果你认为某个技术细节必须确认，再单独列出来问我。

详细模板模式 ​

适合：

  1. 新项目。
  2. 客户技术要求较长。
  3. 通信、数据库、线程、真实设备控制。
  4. 现场交付、产线使用、高风险修改。
  5. AI 已经出现误解、返工或改动范围失控。

做法：

text
按文档模板补充输入
  -> 让 AI 区分已确认、推测、待确认
  -> 输出需求/设计/任务/验收
  -> 人工确认后再写代码

自主发挥模式 ​

适合：

  1. 需求还很粗，只想先要一个方案。
  2. 用户不知道该提供哪些资料。
  3. 低风险小改、页面微调、普通 Bug 初步判断。
  4. 想让 AI 先帮你反推页面、流程、模块和待确认问题。

做法：

text
先用自然语言说明目标和现象
  -> 让 AI 自己判断需要哪些材料
  -> AI 先给方案、问题清单和最小任务拆解
  -> 只有进入高风险或代码修改时再补详细模板

💡 Codex 的 Plan 模式会自动帮你拆任务。 按 Shift+Tab 切换到 Plan 模式（或输入 /plan），你只需要说"我要做一个数据采集上位机，串口连接 FPGA，显示 3 个 ADC 曲线和 4 个电源通道，保存 CSV 和日志"，Codex 会自动拆出数据库设计、接口定义、前端页面、测试用例。你审查计划、指出遗漏，确认后切回 Execute 模式执行。

同时按住 Plan→Execute 分离：Plan 阶段不写代码只做设计，Execute 阶段按计划推进。中途需求变了，先回到 Plan 补变更理由再继续。

💡 Codex 的 /goal 目标模式：当一个功能反复改不好、或想尽可能优化时，输入 /goal 进入目标模式，AI 会奔着目标自我迭代、自我优化，直到达成目标或达到迭代上限。适合：性能优化、界面调优、复杂 Bug 攻坚。

💡 批量修改策略：修改代码不要一个小需求跑一次对话。收集多个需求整理成一份修改清单，切到 Plan 模式一次性规划所有改动，然后执行。一次 Plan 会话集中处理比多次零散对话 token 命中率高得多，费用也更低。简单说：小需求攒一攒，Plan 模式批量干。

推荐原则：

情况推荐模式
不知道怎么开始先用模式 B，让 AI 反推
准备动代码进入模式 A 的最小修改和验证要求
只是小改模式 B + 最便宜验证
涉及通信、数据库、线程、设备动作模式 A
AI 输出太散或太敢改切回模式 A

2. 第一次拿到资料怎么读 ​

第一次只需要读：

text
00-先读我-阅读路线.md

如果你还不确定自己是否适合，再读：

text
01-适用人群与边界.md

如果你想查每个文件用途，再读：

text
02-资料包文件用途总览.md

如果你还没有确定用官方订阅路线，还是第三方 API / Codex++ 路线，再读：

text
03-AI开发环境选择总览.md

如果你准备使用官方订阅工具，再读：

text
04-官方订阅AI工具路线.md

如果你准备使用 DeepSeek、MiniMax、智谱等第三方 API，或者想用 Codex++，再读：

text
05-第三方API与CodexPlusPlus路线.md

如果你想先了解现在 C# 上位机和 AI 开发工具的整体使用环境，再读：

text
06-CSharp上位机AI开发现状.md

如果你的开发电脑安装了企业加密软件，或者保存 .cs/.xaml/.csproj 后 AI 读不到文件，再读：

text
07-加密软件环境下的AI开发注意事项.md

不要第一次就把所有文件都读完。

3. 从 0 做新项目 ​

必读：

text
00-先读我-阅读路线.md
10-问题定义与用户场景.md
11-上位机项目需求拆解表.md
30-回归测试与验收清单.md

按需读：

text
WPF 项目：20-WPF上位机AI开发流程.md
先做界面效果图：23-界面原型到WPF开发流程.md
串口/TCP/协议：21-串口TCP通信任务模板.md
重要技术选择：22-架构决策ADR模板.md
进入下一阶段前：12-AI开发质量门.md
不知道怎么问 AI：50-常用Prompt库.md
阶段结束后：31-度量复盘与经验沉淀.md

可以先不读：

text
40-Bug调查与最小修复流程.md
60-host-computer-dev-Skill说明.md
70-脱敏案例-从需求到交付.md
80-参考-三种使用路径.md
81-参考-拿到资料后怎么开始.md

最短路线：

text
00 -> 10 -> 11 -> 30

涉及 WPF 和通信时（23 在 UI 不明确时必读，已有明确 UI 设计稿或非 WPF 项目可跳过）：

text
00 -> 10 -> 11 -> 23 -> 20 -> 21 -> 30

4. 已有项目改功能 ​

小改不用重新填完整需求表。

必读（30 是方法论，建议早读建立验收意识；实际验收在代码完成后执行）：

text
00-先读我-阅读路线.md
30-回归测试与验收清单.md

按需读：

text
改 WPF 页面或结构：20-WPF上位机AI开发流程.md
界面方向不明确或容易返工：23-界面原型到WPF开发流程.md
改通信：21-串口TCP通信任务模板.md
改数据库、配置、线程、真实设备动作：12-AI开发质量门.md
新增一整套大功能：10-问题定义与用户场景.md + 11-上位机项目需求拆解表.md
不知道怎么问 AI：50-常用Prompt库.md

可以先不读：

text
40-Bug调查与最小修复流程.md
70-脱敏案例-从需求到交付.md
80-参考-三种使用路径.md
81-参考-拿到资料后怎么开始.md

判断标准：

  1. 只是改按钮、字段、页面状态：不用看 10 和 11。
  2. 新增完整流程、设备、通信链路、数据链路：要看 10 和 11。
  3. 修改通信、数据库、线程、真实设备动作：要看 12 和 30。

5. 修 Bug ​

如果你已经用 Skill/Agent 实现了 Bug 调查和最小修复流程，可以不读 40-Bug调查与最小修复流程.md。

普通 ChatGPT 修 Bug ​

text
00 -> 40 -> 30

Skill/Agent 修 Bug ​

text
00 -> 30

按需加：

text
通信 Bug：21-串口TCP通信任务模板.md
高风险 Bug：12-AI开发质量门.md
重要 Bug 修完后：31-度量复盘与经验沉淀.md

可以先不读：

text
10-问题定义与用户场景.md
11-上位机项目需求拆解表.md
20-WPF上位机AI开发流程.md
22-架构决策ADR模板.md
70-脱敏案例-从需求到交付.md

6. 使用 Skill/Agent 开发 ​

必读：

text
00-先读我-阅读路线.md
03-AI开发环境选择总览.md
60-host-computer-dev-Skill说明.md
skills/host-computer-dev/README.md

如果你想把这套 Skill 改造成适合自己行业和工作习惯的版本，再读：

text
61-Skill成长与二次定制.md

按需读：

text
新项目需求不清：10-问题定义与用户场景.md + 11-上位机项目需求拆解表.md
人工验收：30-回归测试与验收清单.md
通信复杂：21-串口TCP通信任务模板.md
想理解质量门：12-AI开发质量门.md

可以先不读：

text
40-Bug调查与最小修复流程.md
50-常用Prompt库.md
70-脱敏案例-从需求到交付.md
80-参考-三种使用路径.md
81-参考-拿到资料后怎么开始.md

原因：这些内容已经被 Skill 的 SKILL.md、TEMPLATE.md、EXAMPLE.md 吸收了一部分。只有当输出不稳定，或者你想理解原理时，再回来看普通说明文档。

6.1 不同 AI 工具怎么选 ​

先看：

text
03-AI开发环境选择总览.md

如果你会用 Codex、Cursor 或 Claude Code，看：

text
04-官方订阅AI工具路线.md

如果你不想订阅官方套餐，准备使用第三方 API、Codex++、国内 AI IDE 或模型中转，看：

text
05-第三方API与CodexPlusPlus路线.md

核心思路是：

  1. 先让工具读取 00、11、20、30。
  2. 再让工具读取 skills/host-computer-dev/README.md。
  3. 如果工具不支持 Codex Skill，就让它把 SKILL.md 转成当前工具可用的项目规则、快捷指令或专家角色。
  4. 后续开发仍然按需求拆解、影响分析、最小修改、回归验收来走。

7. 最容易误读的文件 ​

11-上位机项目需求拆解表.md ​

它不是任何情况都必填。

必须看：

  1. 从 0 做新项目。
  2. 已有项目新增一整套大功能。
  3. 需求很模糊，需要先整理第一版方案。

可以不看：

  1. 小 Bug 修复。
  2. 小页面调整。
  3. 已有明确需求方案。
  4. 使用 Skill 处理明确的小任务。

40-Bug调查与最小修复流程.md ​

它不是 Skill 模式下的必读文档。

必须看：

  1. 不用 Skill，只用普通 ChatGPT 修 Bug。
  2. 想学习 Bug 应该怎么描述给 AI。
  3. 想手动控制“先调查、再修复”的流程。

可以不看：

  1. 已经调用 Bug 调查 Skill。
  2. 已经调用 Bug 修复 Skill。
  3. 工具已经内置同样的 Bug 路由。

50-常用Prompt库.md ​

它是提示词库，不是教材。需要复制 Prompt 时看；Skill 模式下可以少看。

70-脱敏案例-从需求到交付.md ​

它是案例，不是流程主线。想理解完整项目怎么走时看；急着做项目时可以跳过。

8. 一句话决策表 ​

你的情况最短阅读路线
第一次拿到资料00
不知道用哪个 AI 工具00 -> 03
从 0 做新项目00 -> 10 -> 11 -> 30
WPF 新项目，界面已明确00 -> 10 -> 11 -> 20 -> 30
先确认界面效果再开发00 -> 10 -> 11 -> 23 -> 20 -> 30
串口/TCP 新项目00 -> 10 -> 11 -> 21 -> 30
已有项目小改00 -> 30
已有项目大改00 -> 10 -> 11 -> 12 -> 30
普通 ChatGPT 修 Bug00 -> 40 -> 30
Skill/Agent 修 Bug00 -> 30
使用官方订阅工具开发00 -> 03 -> 04 -> 60 -> skills/host-computer-dev/README.md
使用第三方 API/Codex++ 开发00 -> 03 -> 05 -> 60 -> skills/host-computer-dev/README.md
想看完整案例70

9. 最重要的规则 ​

不要把这套资料当成必须顺序阅读的手册。

正确用法是：

text
先读 00
判断当前场景
只打开当前场景需要的文件
让 AI 先分析和确认
再进入实现
最后用 30 做人工验收

10. 后续怎么持续优化 ​

这套资料后续不要按“想到什么就加什么”的方式膨胀。

更推荐的方式是：

text
真实项目返工 / Bug / 现场反馈 / AI 输出失败
  -> 用 31 记录事实和证据
  -> 判断应该更新哪一份文档、Prompt 或 Skill
  -> 同步补充 30 的回归或验收项
  -> 下次项目验证这条优化是否真的减少返工

也就是说，优化依据应该来自实际开发证据，而不是单纯感觉某段话还不够完整。

如果你已经交付过一个项目、修过一个典型 Bug，或者发现 AI 总是在同一类任务上误判，优先看：

text
31-度量复盘与经验沉淀.md

上位机 AI 开发工作流资料包 | 閑魚：別來無恙 | QQ群：1016188499

Copyright © 2026 別來無恙