Appearance
5 分钟快速开始（V10）
如果你正卡在一个项目问题上，不需要先把整个项目整理成完整需求文档。先说清当前问题、期望结果、不能影响什么、手上有什么证据，让 Agent 判断任务类型。
第一步：你现在是哪种情况
第二步 A：项目用户先按任务分流
| 你现在要做什么 | 最短入口 |
|---|---|
| “我只想知道当前怎么工作的” | Read-Only Trace |
| “改个文案/样式/局部显示” | Fast / MicroPatch |
| “连续 N 次、阈值、报警/停机规则要改” | BehaviorPatch |
| “以前正常，最近改后异常” | RegressionFix |
| “日志很多，只看到最后一条 Error” | 日志与时间线诊断 |
| “UI 越跑越卡、CPU/内存持续增长” | 性能与长稳诊断 |
| “先临时放开限制做边界测试” | ExperimentalChange |
| “需要连真实高压/运动/阀门等设备验证” | 真实设备操作安全 |
| “新项目/新流程，我自己也没完全想清” | Discovery / 完整项目工作流 |
| 串口/TCP/协议问题 | 通信证据包 |
| 正式方案、总结、说明书、验收报告 | 技术文档工程 |
第三步 A：不知道怎么分类时，直接复制这个 Prompt
V10 最短项目 Prompt
$host-computer-dev
请先判断这个任务属于 Read-Only / Fast / Execution / Discovery。
如果是 Execution，再判断 MicroPatch / BehaviorPatch / RegressionFix / ExperimentalChange。
我的问题或目标：
【填写】
当前现象或已有行为：
【填写】
我希望的结果：
【填写】
不希望影响：
【填写】
已有材料：
【截图 / 日志 / 协议 / 代码 / Git / 测试结果】
能从代码、配置、日志或 Git 直接确认的事实请你自己查；只有会改变最终业务结果的决策再问我。
如果任务已经足够明确，请直接进入最短执行路径，不要为了流程重新写完整需求或长计划。
需要真实设备改变状态的验证请单独标出，不要自动执行。
请先判断这个任务属于 Read-Only / Fast / Execution / Discovery。
如果是 Execution，再判断 MicroPatch / BehaviorPatch / RegressionFix / ExperimentalChange。
我的问题或目标：
【填写】
当前现象或已有行为：
【填写】
我希望的结果：
【填写】
不希望影响：
【填写】
已有材料：
【截图 / 日志 / 协议 / 代码 / Git / 测试结果】
能从代码、配置、日志或 Git 直接确认的事实请你自己查；只有会改变最终业务结果的决策再问我。
如果任务已经足够明确，请直接进入最短执行路径，不要为了流程重新写完整需求或长计划。
需要真实设备改变状态的验证请单独标出，不要自动执行。
这个 Prompt 的重点不是“先不要写代码”，而是先分对任务：
- Read-Only：只查事实，不修改、不构建、不测试；
- Fast：明确小改可以直接做；
- Execution：目标已明确，只需要短 Brief 或 Behavior Contract；
- Discovery：只有关键业务规则未定时才深入提问。
第四步 A：只准备足够的证据
不同任务需要的材料不同，不要一次把整个仓库和所有历史资料都丢给 AI。
| 任务 | 最有价值的材料 |
|---|---|
| Read-Only | 目标词、页面、成员名、当前代码 |
| MicroPatch | 当前显示位置、目标效果、相邻样式 |
| BehaviorPatch | 当前行为、目标行为、阈值/状态/日志要求 |
| RegressionFix | known-good、最近改动、日志、复现现象 |
| 日志/现场偶发 | 异常时间窗、TX/RX、状态、用户动作 |
| 性能/长稳 | 可重复场景、CPU、内存、刷新/延迟基线 |
| 通信问题 | 协议原文、TX/RX、时间戳、正常/异常报文 |
| 真机验证 | 软件侧证据、需要执行的设备动作、风险和人工授权 |
| 技术文档 | 当前批准资料、代码/测试证据、历史样稿（仅参考） |
第五步 A：完成后的验证也按任务分级
text
V0 静态
V1 affected build
V2 focused fake/replay/test
V3 workflow/state/interlock
V4 release/full一个 Label 改名通常不需要全量单测；状态机、联锁和设备后果则不能只看编译。
验证结果也要准确描述：
text
Verified
Unverified
EnvironmentBlocked
HardwarePendingFake/Replay 通过不能自动写成真机通过；没有执行真实设备步骤时保留 HardwarePending。
详见 AI 开发验证体系。
第二步 B：如果你是来学习的
学习路线和生产开发不完全一样。学习阶段可以让 AI 慢一点、解释多一点；生产阶段则应让流程与风险匹配。
学习 Prompt
text
我想借助 AI 学习 C# 上位机开发。
我的基础：
【填写】
每天学习时间：
【填写】
想先做出的项目：
【填写】
请帮我区分：
1. 开始项目前必须先学的最小知识；
2. 可以边做边学的知识；
3. 第一个可运行 Demo；
4. 哪些代码必须由我自己解释；
5. 哪些设备和工程结论必须人工验证。第一次使用的原则
先跑通一个可验证的小闭环，再扩展；但小闭环不等于固定流程——先判断任务，选择足够的分析与验证。