Appearance
资料包文件用途总览
这份文件是文件地图，不是阅读主线。
第一次拿到资料，请先看 00-先读我-阅读路线.md。看完以后，如果还想查每个文件具体干什么，再回来看这里。
1. 文件分组
text
00-07 入口、地图和环境
10-12 新项目和大功能前置
20-23 开发专题
30-31 验收和复盘
40-50 普通 ChatGPT 辅助材料
60-61 Skill/Agent
70-81 参考材料2. 入口和地图
| 文件 | 定位 | 是否必看 | 说明 |
|---|---|---|---|
00-先读我-阅读路线.md | 主入口 | 必看 | 决定后续看什么、不看什么 |
01-适用人群与边界.md | 适用性说明 | 建议看 | 不确定自己是否适合时看 |
02-资料包文件用途总览.md | 文件地图 | 按需 | 查每个文件用途 |
03-AI开发环境选择总览.md | 工具选择总览 | 新手建议看 | 不知道走官方订阅还是第三方 API 路线时看 |
04-官方订阅AI工具路线.md | 官方订阅路线 | 按需 | 使用 Codex、Cursor、Claude Code 等官方工具时看 |
05-第三方API与CodexPlusPlus路线.md | 第三方 API 路线 | 按需 | 使用 Codex++、国内模型 API 或国内 AI IDE 时看 |
06-CSharp上位机AI开发现状.md | 市场和工具现状 | 按需 | 想了解 C# 上位机和 AI 开发工具变化时看 |
07-加密软件环境下的AI开发注意事项.md | 特殊开发环境 | 按需 | 电脑有企业加密软件、AI 读写文件异常时看 |
3. 新项目和大功能前置
| 文件 | 主要用途 | 必看场景 | 可以跳过的场景 |
|---|---|---|---|
10-问题定义与用户场景.md | 先定义用户、现场、痛点、成功标准 | 新项目、大功能、需求模糊 | 小改、小 Bug、需求已清楚 |
11-上位机项目需求拆解表.md | 把需求拆成页面、通信、数据、验收 | 新项目、大功能、需求说明书拆解 | 小改、小 Bug、已有明确需求 |
12-AI开发质量门.md | 判断能不能进入下一阶段 | 高风险、交付前、大改前 | 小改、低风险任务 |
4. 开发专题
| 文件 | 主要用途 | 必看场景 | 可以跳过的场景 |
|---|---|---|---|
20-WPF上位机AI开发流程.md | WPF 页面、ViewModel、Service 拆分 | WPF 新项目、WPF 页面修改 | 非 WPF、纯 Bug、纯通信问题 |
21-串口TCP通信任务模板.md | 通信和协议任务拆解 | 串口/TCP/协议相关任务 | 不涉及通信 |
22-架构决策ADR模板.md | 记录重要技术选择 | 架构、数据库、通信模型、线程模型变化 | 小改、普通 Bug |
23-界面原型到WPF开发流程.md | 先用 AI 做界面效果图，再拆成 WPF 页面任务 | WPF 新项目、界面容易返工、客户需要先确认界面 | 纯通信、纯 Bug、无需界面确认 |
5. 验收和复盘
| 文件 | 主要用途 | 必看场景 | 可以跳过的场景 |
|---|---|---|---|
30-回归测试与验收清单.md | 修改后验证和交付验收 | 几乎所有实际修改 | 只阅读资料、不改项目时 |
31-度量复盘与经验沉淀.md | 记录返工、缺陷、流程改进，并决定工作流怎么持续优化 | 阶段结束、重要 Bug、交付后、AI 输出反复不稳定 | 临时小改且不需要沉淀 |
6. 普通 ChatGPT 辅助材料
| 文件 | 主要用途 | 必看场景 | 可以跳过的场景 |
|---|---|---|---|
40-Bug调查与最小修复流程.md | 普通 ChatGPT 模式下排 Bug | 不用 Skill 修 Bug | 已经使用 Bug Skill/Agent |
50-常用Prompt库.md | 复制提示词 | 不知道怎么问 AI | 已经使用 Skill/Agent 且输出稳定（但 Skill 用户也可参考其中的 Goal 模式和简化模板） |
7. Skill/Agent
| 文件或目录 | 主要用途 | 是否需要普通阅读 |
|---|---|---|
60-host-computer-dev-Skill说明.md | 说明 Skill 怎么安装、怎么调用 | 使用 Skill/Agent 时看 |
61-Skill成长与二次定制.md | 把通用 Skill 改造成自己的行业 Skill | 想长期使用或二次定制时看 |
skills/host-computer-dev/README.md | Skill 体系总说明 | 使用 Skill/Agent 时看 |
skills/host-computer-dev/*/SKILL.md | 每个 Skill 的角色和流程 | 工具加载或按需查看 |
skills/host-computer-dev/*/TEMPLATE.md | 每个 Skill 的输入输出模板 | 输出不稳定时看 |
skills/host-computer-dev/*/EXAMPLE.md | 每个 Skill 的调用示例 | 不知道怎么调用时看 |
8. 参考材料
| 文件 | 用途 | 是否必看 |
|---|---|---|
70-脱敏案例-从需求到交付.md | 看一个完整项目怎么从需求走到交付 | 可跳过 |
80-参考-三种使用路径.md | 旧版路径说明，保留作参考 | 可跳过 |
81-参考-拿到资料后怎么开始.md | 用户第一次打开链接时的详细说明 | 第一次建议看 |
91-参考-AI工具通用技巧.md | Codex/Claude/Cursor/GPT 通用技巧、成本优化 | 任何 AI 工具用户都建议看一次 |
9. 场景路线
从 0 做新项目
必读：
00-先读我-阅读路线.md10-问题定义与用户场景.md11-上位机项目需求拆解表.md30-回归测试与验收清单.md
按需：
- WPF：
20-WPF上位机AI开发流程.md - 通信：
21-串口TCP通信任务模板.md - 架构选择：
22-架构决策ADR模板.md - 阶段检查：
12-AI开发质量门.md - 提示词：
50-常用Prompt库.md - 先确认界面效果：
23-界面原型到WPF开发流程.md
已有项目改功能
必读：
00-先读我-阅读路线.md30-回归测试与验收清单.md
按需：
- WPF 页面：
20-WPF上位机AI开发流程.md - 通信：
21-串口TCP通信任务模板.md - 大功能：
10-问题定义与用户场景.md和11-上位机项目需求拆解表.md - 高风险：
12-AI开发质量门.md - 界面方向不明确：
23-界面原型到WPF开发流程.md
修 Bug
普通 ChatGPT 模式：
text
00 -> 40 -> 30Skill/Agent 模式：
text
00 -> 30通信 Bug 再加：
text
21重要 Bug 修完后再加：
text
31使用 Skill/Agent
必读：
00-先读我-阅读路线.md03-AI开发环境选择总览.md60-host-computer-dev-Skill说明.mdskills/host-computer-dev/README.md
按需：
- 新项目需求不清：
10、11 - 人工验收：
30 - 通信复杂：
21 - 想理解质量门：
12
10. 取舍原则
选择 AI 开发工具
如果用户还没有确定用什么 AI 工具，先看 03-AI开发环境选择总览.md。
然后按情况继续看：
- 官方订阅工具：
04-官方订阅AI工具路线.md - 第三方 API / Codex++：
05-第三方API与CodexPlusPlus路线.md - 暂时没有 AI IDE：先用普通聊天工具整理需求、界面和协议。
- 想了解为什么推荐 Agent 开发：
06-CSharp上位机AI开发现状.md - 电脑有加密软件或文件保存后 AI 读不到：
07-加密软件环境下的AI开发注意事项.md
判断一个文件要不要看，就问三句话：
- 我现在是不是遇到了这个文件解决的问题？
- 我的工具或 Skill 是不是已经覆盖了这个流程？
- 不看这个文件，会不会影响当前任务的安全、需求清晰度或验收？
如果答案是“不会”，就可以先跳过。
11. 持续优化入口
如果你后续要继续维护这套工作流，不建议直接从 50-常用Prompt库.md 开始堆提示词。
先从实际问题反推：
| 实际问题 | 优先更新 |
|---|---|
| 需求反复变 | 10、11 |
| AI 跳过确认直接写代码 | 12、对应 Skill |
| WPF 页面返工多 | 20、23 |
| 通信联调问题多 | 21、通信 Skill 笔记 |
| Bug 修复范围失控 | 40、Bug Skill |
| 验收漏测 | 30 |
| Prompt 或 Skill 输出不稳定 | 31 先复盘，再更新 50 或对应 TEMPLATE.md / EXAMPLE.md |
具体复盘和优化记录模板见：
text
31-度量复盘与经验沉淀.md