Appearance
AI 辅助 C# 开发路线（V10）
AI 辅助 C# 不只是生成代码。真正高效的节奏是：先判断任务是什么，再决定 AI 需要读多少、想多少、改多少和验证多少。
1. 先用 V10 四路入口
| 当前任务 | 推荐入口 |
|---|---|
| 我只想知道当前代码怎么工作 | Read-Only Trace |
| 我有一个明确的小修改 | Fast |
| 规则和目标已经说清 | Execution |
| 我还不知道最终业务应该怎样工作 | Discovery |
Execution 里再区分：
text
MicroPatch
BehaviorPatch
RegressionFix
ExperimentalChange这比“所有任务先让 AI 分析并出完整计划”更适合日常项目。
2. 路线导航
| 目标 | 页面 |
|---|---|
| 不知道当前任务怎么分流 | 阅读路线 |
| 拿到项目看不懂 | 读懂 C# 项目 |
| 报错、Bug、近期回归 | Bug / 回归定位 |
| 多源日志、现场偶发、找首个异常点 | 日志与时间线诊断 |
| UI 卡顿、CPU/内存、Stop 假死、长稳 | 性能与长稳诊断 |
| 修改已有功能 | 功能修改最小流程 |
| 测试与回归 | AI 辅助测试与回归 |
| Review / 重构 | 代码审查与重构 |
| 老 .NET 项目 | 旧项目现代化 |
| 真机、高压、运动等现场验证 | 真实设备操作安全 |
3. 新手怎么用 AI
新手的重点不是让 AI 自主越多越好，而是保持自己能解释代码。
适合 AI 做：
- 解释编译错误；
- 把小段 C# 翻译成人话；
- 给 3–5 个边界测试；
- 检查你的实现；
- 提醒资源释放、线程、异常等常见问题。
推荐练习：
text
先预测
→ 自己写
→ 让 AI Review
→ 跑起来
→ 用自己的话解释导师模式适合学习，但不要把“AI 必须先提问、永远不能直接给答案”写成所有生产任务的规则。
4. 有项目经验的人怎么用 AI
查行为
text
“这个值从哪里来？”
→ Read-Only Trace
→ 最短调用链
→ 结束小改
text
“按钮文字改一下”
→ Fast / MicroPatch
→ 最小 Diff
→ V0/V1改运行规则
text
“连续 5 次高电流才报警，但不要停机”
→ BehaviorPatch
→ Behavior Contract
→ V2/V3 focused verification修近期回归
text
“昨天改完后波形不一样”
→ RegressionFix
→ known-good first临时实验
text
“先放开 1500 Hz 限制测试一下”
→ ExperimentalChange
→ 可恢复 override现场偶发
text
“最后报 timeout，但前面发生了什么不知道”
→ Log Timeline
→ 对齐时间源
→ 找 first anomaly越跑越慢
text
“运行 30 分钟后 UI 越来越卡”
→ Performance / Long-Run
→ Baseline
→ narrow hotspot
→ same-scenario re-test5. 老手最值得让 AI 做的事情
- 追调用链和数据流；
- 根据 Git Diff 找影响；
- 整理现场日志时间线；
- known-good 对比；
- 生成 Fake/Replay；
- focused test；
- 性能基线和热点对比；
- 第一轮 PR Review；
- 技术文档 Evidence Map；
- 找长期 Git hot spot（显式架构体检）。
价值往往不在“多写几行代码”，而在减少搜索、漏项和重复验证。
6. 一个通用但轻量的 Prompt
如果不知道该怎么开始：
text
$host-computer-dev
请先判断任务属于 Read-Only / Fast / Execution / Discovery。
如果是 Execution，再判断 MicroPatch / BehaviorPatch / RegressionFix / ExperimentalChange。
我的问题或目标：
【填写】
请先查能从代码/配置/Git直接确认的事实；只有会改变最终业务结果的决策再问我。更具体模板见 模板中心的最短开场白。
7. 测试不是统一跑全量
修改后按 V0–V4：
text
V0 静态
V1 affected build
V2 focused fake/replay/test
V3 workflow/state/interlock
V4 release/full0 tests matched 不等于 Verified；软件/构建/权限环境阻断写 EnvironmentBlocked；需要真实设备/HITL 但尚未执行写 HardwarePending；普通证据不足写 Unverified。
统一状态：
text
Verified
Unverified
EnvironmentBlocked
HardwarePending8. 最重要的 C# 上位机边界
AI 可以帮助非常多，但下面几件事必须特别谨慎：
- 通信协议和设备状态；
- UI 线程与后台任务；
- SerialPort / Socket / File / Timer 生命周期；
- Device Session Owner；
- 数据库和历史数据兼容；
- 状态机、联锁、报警后果；
- 高压、运动、加热、气路等真实设备动作；
- 发布和现场验收。
真实设备只读查询也要确认安全、授权和不会改变现场状态；危险状态改变动作保持 HITL。
9. 不要把“AI 说合理”当证据
text
代码推测
≠ 根因确认
编译通过
≠ 行为正确
单元测试通过
≠ 真机安全
重试恢复
≠ 根因已确认
回退到旧版恢复
≠ 当前版本已修复根因结论强度跟 EvidenceGrade 走；验证完成度跟 VerificationState 走。回退到旧版只写 RolledBackToKnownGood，修复 causal behavior delta 后才写 RegressionFixed。
10. 推荐阅读顺序
第一次接触 AI 辅助 C#
text
69 路线
→ 70 读项目
→ 32 功能修改
→ 71 Bug
→ 72 测试
→ 73 Review已经在长期项目中使用 Agent
text
68 现代 AI IDE
→ agent-engineering
→ project-context-template
→ ai-output-checklist
→ 25 V10 Skill遇到专项问题时直接从日志、性能、通信或真机安全页面进入，不要求按上面的编号顺序重走。
一句话原则
学习阶段可以让 AI 慢一点帮助你理解；生产阶段则应让流程与风险匹配，别把教学步骤机械带进每个小改。