Appearance
拿到资料后怎么开始
如果你已经看过 00-先读我-阅读路线.md 并选好了自己的场景，这里是快速上手指南。如果你还没看过 00，建议先看 00 再回来——那里有完整的场景路线。
这份文件解决一个问题：你拿到资料后，第一步到底该做什么。
不要一开始就把所有文件读完，也不要一开始就让 AI 写完整项目。先判断你的情况，再选择对应路径。
0. 5 分钟开始用
如果你刚拿到资料链接，只想马上知道怎么用，按下面做：
第 1 步：先选你的情况
| 你的情况 | 先看 |
|---|---|
| 我想从 0 做一个上位机软件 | 10、11 |
| 我已有项目，想改一个功能 | 本文件第 4 节 |
| 我软件有 Bug，要让 AI 帮我查 | 40 |
| 我主要卡在串口/TCP/协议 | 21 |
| 我想安装 Skill/Agent | 60 |
| 我只是普通 ChatGPT 用户 | 50，不用急着装 Skill |
第 2 步：先别追求完整
第一次只要把这些说清楚：
text
我想做/修改什么：
现在是什么情况：
希望变成什么样：
我不希望影响什么：
我手上有什么资料：截图 / 日志 / 协议 / 需求说明 / 项目源码不会写专业词没关系。比如“连接按钮点了以后要变成关闭按钮”就可以，不需要一开始说 Command、Binding、ViewModel。
第 3 步：复制这个通用开场白
text
我正在做 C# WPF/WinForm 上位机相关项目。
请先不要直接写代码，也不要一次性重构。
我先用自然语言描述目标，你帮我判断：
1. 这属于新项目、改功能、修 Bug，还是通信问题。
2. 需要我补充哪些材料。
3. 最小处理路径是什么。
4. 哪些地方有风险。
5. 下一步应该看这套资料里的哪个文件。
我的情况如下：
【把你的目标、现象、截图/日志/协议情况写在这里】如果 AI 能根据这段话给出清楚路线，再继续补材料；如果 AI 开始乱写代码，就提醒它“先分析，不要写代码”。
第 4 步：知道这套资料能帮你到哪
这套资料帮你把“怎么问 AI、怎么拆任务、怎么检查结果”变清楚。它不是现成项目源码，也不是包调通的定制开发服务。
| 能帮你做什么 | 不能承诺什么 |
|---|---|
| 把口头想法整理成需求方案 | 不保证一句话生成完整可交付项目 |
| 把大任务拆成页面、通信、数据、日志、测试 | 不替代你运行、联调和验收 |
| 给你可复制的 Prompt 和检查清单 | 不保证所有 AI 输出代码直接可用 |
| 帮你减少 AI 乱改、漏测、跳步骤 | 不替代真实设备安全确认 |
如果你需要别人根据你的源码、协议和截图直接改出成品，那属于定制开发，不是资料包本身的交付范围。
1. 一个最重要的使用原则
你不需要一开始就知道要改哪个文件、哪个控件、哪个绑定、哪个 Command。
更重要的是：在有限规则范围内，给 AI 最大限度的自由。
你需要告诉 AI：
text
我要达到什么效果
现在是什么情况
有哪些资料可以参考
哪些地方不能乱动
哪些风险必须注意
最后怎么判断完成你不需要一开始就告诉 AI：
text
必须叫什么方法名
必须新建哪个类
每一行代码怎么写
函数内部每一步怎么执行
所有控件和绑定字段叫什么这些具体技术细节，应该优先让 AI 根据项目现状和你的目标自己推导。你只负责给框架、给边界、给验收标准；AI 在框架内自由发挥。只有当某个细节会影响安全、通信、数据、兼容性或交付时，再要求 AI 停下来确认。
实际使用时，你先把目标说清楚就可以。例如：
text
我想把主界面的连接按钮改成关闭按钮。
连接成功后按钮显示关闭，点击关闭后断开设备，再恢复成连接。AI 应该先帮你判断：
- 这个需求可能影响哪些页面或功能。
- 需要确认哪些状态变化。
- 可能涉及哪些代码文件。
- 是否需要补充截图、项目结构、XAML、ViewModel 或日志。
- 应该如何做最小修改和回归验证。
如果 AI 一上来就要求你准确指出 XAML、ViewModel、绑定字段和 Command 名称，说明提问方式太偏技术细节。正确方式是：用户先说业务目标，AI 再反推技术细节。
1.1 需求不是一次确认完的
上位机项目的需求通常需要多轮确认。
第一轮只要说清楚大方向：
- 想做什么软件。
- 谁使用。
- 在什么现场使用。
- 连接什么设备。
- 大概有哪些功能。
- 第一阶段最想先做什么。
AI 先根据这些内容搭出第一版框架。你看到框架后，再继续确认：
- 哪些理解是对的。
- 哪些理解不对。
- 哪些功能暂时不要。
- 哪些流程需要补充。
- 哪些模块要先做。
比较合理的节奏是：
text
模糊想法 -> 问题定义 -> 第一版需求方案 -> 用户确认/纠正 -> 第二版需求方案 -> 单模块细化 -> 开发任务拆解 -> 回归验收 -> 复盘沉淀如果你手上已经有客户需求说明书或技术要求，也不要直接让 AI 写代码。先让 AI 把文档拆成“明确要求、AI 推测、需要确认的问题、第一阶段范围”，再进入开发。
2. 先判断你属于哪类用户
不用纠结自己算不算“会开发”。按你现在能做什么判断即可。
A. 我会一点 C# 或上位机，但不会系统用 AI
这是最适合使用本资料包的情况。
建议先看：
01-适用人群与边界.md80-参考-三种使用路径.md11-上位机项目需求拆解表.md50-常用Prompt库.md
你的重点不是从零学编程，而是学会让 AI 按工程流程帮你做事。
B. 我懂设备调试或自动化测试，但软件经验一般
建议先把现场信息整理清楚：
- 设备是什么。
- 怎么连接。
- 操作人员怎么使用。
- 需要显示哪些数据。
- 需要保存哪些数据。
- 异常时怎么提示。
- 最后怎么验收。
然后填写 11-上位机项目需求拆解表.md，让 AI 先整理需求方案。
C. 我完全零基础
如果你不会 C#，也没有用过 Visual Studio，不知道 WPF/WinForm、串口、TCP 是什么，不建议直接用这套资料做完整项目。
你可以先把这套资料当作学习路线参考，优先补：
- C# 基本语法。
- Visual Studio 创建和运行项目。
- WPF 或 WinForm 基本界面。
- 串口和 TCP 基础。
- 日志、配置、数据保存基础。
等你能运行简单示例、看懂基本报错后，再用本资料包做项目拆解和 AI 协作。
D. 我是经验很足的上位机工程师
如果你已经有成熟项目模板、通信框架、日志系统、测试流程和交付标准，这套资料不会比你的完整体系更强。
你可以重点看 AI 工作流部分：
50-常用Prompt库.md60-host-computer-dev-Skill说明.mdskills/host-computer-dev/
重点参考它如何让 AI 做需求整理、影响分析、Bug 调查、最小修复和回归验证。
3. 如果你是新项目
新项目第一步不是建项目，也不是让 AI 设计目录结构。
第一步是把零散需求整理成第一版需求方案。
建议顺序：
- 打开
10-问题定义与用户场景.md，先写清楚用户、现场、痛点和第一阶段成功标准。 - 再打开
11-上位机项目需求拆解表.md。 - 先按你知道的信息填写，不会的地方写“不确定”。
- 把填写内容发给 AI。
- 要求 AI 先整理第一版需求方案，并列出缺失问题。
- 你确认和纠正后，让 AI 输出第二版需求方案。
- 用
12-AI开发质量门.md检查是否可以进入技术方案。 - 第二版方案基本合理后，再进入
20-WPF上位机AI开发流程.md。 - 有重要技术选择时，用
22-架构决策ADR模板.md记录理由。 - 涉及通信时，再进入
21-串口TCP通信任务模板.md。 - 开发前先看
30-回归测试与验收清单.md，提前确定验收标准。 - 阶段结束后用
31-度量复盘与经验沉淀.md记录返工原因和经验。
第一次可以这样问 AI：
text
我准备做一个 C# WPF 上位机项目。请先不要写代码，也不要直接设计项目结构。
下面是我目前想到的零散需求，请你先整理成第一版需求方案，并列出还需要我确认的问题。
请输出：
1. 一句话问题定义。
2. 目标用户和使用场景。
3. 当前痛点。
4. 项目目标。
5. 操作流程。
6. 页面需求。
7. 通信需求。
8. 数据保存需求。
9. 日志和报警需求。
10. 性能和稳定性要求。
11. 第一阶段最小可运行版本。
12. 非目标。
13. 缺失信息清单。
零散需求如下：
【粘贴你的需求】如果你已经有需求说明书，可以这样问：
text
我手上有一份上位机项目需求说明书。请先不要写代码，也不要直接设计项目结构。
请你先把这份文档拆成可执行的软件需求。
请区分：
1. 文档里已经明确的要求。
2. 你根据经验推测的内容。
3. 需要我继续确认的问题。
4. 第一阶段最小可运行版本。
5. 后续可以再做的功能。
需求说明书如下：
【粘贴需求说明书或技术要求】如果你觉得这段太长，可以先用短版：
text
我有一个上位机新项目。请先不要写代码。
请你先根据我下面的描述，整理：
1. 项目目标。
2. 功能模块。
3. 页面草案。
4. 通信和数据需求。
5. 第一阶段先做什么。
6. 还缺哪些关键信息。
我的描述如下：
【粘贴你的想法或客户技术要求】4. 如果你是已有项目改功能
已有项目可以先描述你想改成什么效果，不需要一开始就准确指出文件名。
建议顺序：
- 先说清楚本次想改什么效果。
- 说明当前现象和期望现象。
- 说明哪些功能不希望被影响。
- 让 AI 先判断可能涉及哪些页面、模块和文件。
- 如果 AI 信息不够，再按它的要求补充截图、项目结构或相关代码。
- 要求 AI 先做影响分析，再给最小修改方案。
- 修改前用
12-AI开发质量门.md检查是否可以进入实现。 - 修改后用
30-回归测试与验收清单.md做检查。 - 如果发生返工，用
31-度量复盘与经验沉淀.md记录原因。
第一次可以这样问 AI：
text
我有一个已有 C# WPF/WinForm 上位机项目，现在只想改一个功能。
请先不要写代码，也不要重构无关部分。
本次修改目标：
【用自然语言描述想改成什么效果】
当前现象：
【现在软件是什么样】
期望现象：
【希望改完后是什么样】
不希望影响：
【哪些功能不要动】
请先输出：
1. 这个需求可能影响哪些页面、状态、命令、数据或服务。
2. 你需要我补充哪些截图、项目结构、文件或日志。
3. 最小修改思路。
4. 风险点。
5. 是否可以进入实现，如果不可以还缺什么。
6. 回归测试点。5. 如果你是修 Bug
修 Bug 时不要一上来让 AI 改代码。
先描述现象，不需要一开始就知道根因或文件位置：
- 问题现象。
- 复现步骤。
- 出现频率。
- 最近改动。
- 报错截图或日志。
- 期望行为。
- 实际行为。
然后使用 40-Bug调查与最小修复流程.md。
第一次可以这样问 AI：
text
请你作为 C# WPF/WinForm 上位机 Bug 调查助手。
请先只调查根因，不要直接修改代码。
问题现象：
复现步骤：
出现频率：
最近改动：
报错截图或日志：
期望行为：
实际行为：
如果信息不够，请告诉我需要补充哪些文件、日志或截图。
请输出：
1. 可能原因列表。
2. 最可能原因和证据。
3. 需要继续补充的信息。
4. 最小复现方法。
5. 是否可以进入最小修复阶段。6. 如果你只是想学习 AI 开发方法
建议不要从代码生成开始。
先按这个顺序学习：
11-上位机项目需求拆解表.md：学习怎么把需求说清楚。20-WPF上位机AI开发流程.md：学习怎么让 AI 从业务目标反推页面和模块。21-串口TCP通信任务模板.md：学习怎么描述通信任务。40-Bug调查与最小修复流程.md：学习怎么让 AI 先分级，小问题直接修，疑难问题再调查。30-回归测试与验收清单.md：学习怎么检查 AI 的修改。50-常用Prompt库.md：学习不同场景下怎么提问。12-AI开发质量门.md：学习什么时候必须停下来补信息。31-度量复盘与经验沉淀.md：学习怎么把经验沉淀成下一次可用的流程。
7. 第一次使用建议不要做什么
- 不要让 AI 一次生成完整项目。
- 不要把几十个文件一次性丢给 AI。
- 不要需求没确认就开始写代码。
- 不要让 AI 同时改界面、通信、数据库、日志。
- 不要强行自己指定不确定的文件名、控件名和字段名。
- 不要只看 AI 说“完成了”，必须自己运行和验证。
- 不要在真实设备上直接运行未经测试的代码。
7.1 常见误区
| 误区 | 正确做法 |
|---|---|
| 一上来就问“帮我写一个完整上位机” | 先让 AI 整理需求和第一阶段范围 |
| 不会专业词就不敢问 | 先用业务语言描述目标和现象 |
| 以为必须安装 Skill 才能用 | 普通 ChatGPT 也能复制 Prompt 使用 |
| 看到文件很多就从头读到尾 | 只读当前场景需要的文件 |
| AI 说完成就算完成 | 必须自己运行、联调和验收 |
| 小改也填完整大模板 | 小改让 AI 先自主反推，验证通过即可 |
| 通信和真实设备也随便让 AI 改 | 通信、线程、数据库、设备动作必须走详细模板和回归 |
8. 你应该提前准备哪些资料
准备得越清楚，AI 输出越稳定。
建议优先准备这些“用户能说清楚”的资料：
- 项目目标。
- 当前现象和期望效果。
- 设备型号或设备类型。
- 通信方式和协议文档。
- 示例报文。
- 界面草图、参考截图或当前界面截图。
- 操作流程。
- 数据保存要求。
- 日志和报警要求。
- 报错截图、日志、复现步骤。
如果 AI 判断需要进一步定位，再补充项目结构、关键代码文件、XAML、ViewModel 或服务类。
9. 什么时候必须人工判断
以下情况不能只靠 AI：
- 设备动作可能造成损坏或危险。
- 协议文档不完整，需要现场确认。
- 数据影响生产记录或质量追溯。
- 涉及权限、账号、客户现场环境。
- 修改后必须连接真实设备验证。
- 需要正式交付、验收或上线运行。
AI 可以提高效率，但最终判断、联调和验收仍然要由人负责。