Appearance
AI + 上位机开发流程总览
完整研发流程仍然重要，但它不应该被误用成“所有任务的固定流水线”。V10 把日常任务路由和项目阶段流程分开：按钮文案、明确行为修改、近期回归可以走短路径；新项目、大功能和正式交付才进入完整阶段门。
1. 先判断是哪类任务
| 场景 | 推荐路径 |
|---|---|
| 只是查当前实现 | Read-Only Trace → 结论 → END |
| 文案、颜色、布局等明确小改 | Fast / MicroPatch → V0/V1 |
| 运行规则已经说清 | Execution / BehaviorPatch → 精准验证 |
| 以前正常、最近改后异常 | RegressionFix → known-good diff → 修复 → 回归 |
| 临时边界试验 | ExperimentalChange → 临时覆盖 → 恢复 |
| 已有项目新增跨模块能力 | 局部需求/设计 → Execution → 回归 |
| 新项目、新子系统、业务未知 | Discovery → 总体设计 → 详细设计 → 开发 → 验收 |
纯显示 MicroPatch 只需要目标、非目标和最小验证；明确 BehaviorPatch 使用 6 行行为契约。只有影响扩大、存在 Blocking Unknowns 或跨越协议/线程/数据库/安全边界时，才升级到局部设计或完整流程。
2. 新项目 / 大功能的十阶段流程
text
01 项目接入 → 02 问题定义 → 03 需求分析 → 04 总体设计 → 05 详细设计
→ 06 设计评审与任务拆分 → 07 分步开发 → 08 代码审查与问题闭环
→ 09 测试、回归与验收 → 10 发布、交付与复盘| 阶段 | 主要解决什么 | 主要产物 |
|---|---|---|
| 01 项目接入 | 资料有哪些、版本是否可信 | 输入清单、材料版本 |
| 02 问题定义 | 为什么做、给谁用、什么不做 | 用户场景、目标、非目标 |
| 03 需求分析 | 软件具体要做什么 | 需求基线、优先级、验收标准 |
| 04 总体设计 | 系统整体怎么组织 | 模块、数据流、线程、关键 ADR |
| 05 详细设计 | 高风险模块具体怎样实现 | UI、通信、数据、状态机、异常、安全设计 |
| 06 任务拆分 | 如何分成可运行、可回退的小闭环 | 任务卡、修改顺序、验证方式 |
| 07 开发 | 如何按闭环实施 | 代码、Diff、构建/测试证据 |
| 08 Review | 是否有隐藏风险和计划外改动 | Review、Bug 闭环 |
| 09 验收 | 怎么证明达到要求 | 需求追踪、回归、真机/模拟证据 |
| 10 交付复盘 | 怎么安全发布并留下经验 | 发布说明、风险、Memory/ADR/文档 |
3. G0–G9 质量门贯穿完整项目
G0 写入/危险动作；G1 材料；G2 问题定义；G3 需求基线；G4 总体设计；G5 详细设计；G6 大功能开发准入；G7 合入；G8 发布；G9 经验沉淀。
G0–G9 不要求每个 Fast MicroPatch 都产出对应文档。详细说明见 全流程质量门。
4. 新项目阶段里 AI 和人工怎么分工
| 阶段 | Agent 主要负责 | 人工主要负责 |
|---|---|---|
| 需求 | 整理事实、找歧义、形成 Decision Tree | 做业务决策、确认验收边界 |
| 设计 | 提方案、暴露取舍、画数据/状态/时序 | 确认设备真实行为、安全边界 |
| 开发 | 小步实现、Diff、focused 验证 | 真机授权、关键交互验收 |
| Bug | Feedback Ladder、known-good、证据分级 | 提供现场条件和不可自动化证据 |
| 验收 | 建追踪矩阵、整理测试证据 | FAT/SAT/现场确认 |
| 文档 | 方案、详细设计、总结、说明书、测试报告 | 核实正式事实与签审口径 |
5. Discovery 不等于无限访谈
Agent 先从资料查事实，只把会改变业务结果的问题交给用户；每轮处理当前 Frontier；Blocking Unknowns 清零后进入 Execution。已有完整规格时不要重新做一轮完整需求访谈。
6. 详细设计按风险选专题
常见设计视图：UI 与操作流程、通信与协议、数据与追溯、状态机与联锁、线程和资源生命周期、异常恢复、部署与配置、安全边界。
明确的小 BehaviorPatch 可以直接使用 Behavior Contract；跨模块新能力再补局部总体/详细设计。
7. 开发阶段按验证强度
text
V0 纯文案
V1 XAML / 普通局部代码
V2 设备 / MES / 存储 / 共享约束
V3 状态机 / 联锁 / 并发 / 告警后果
V4 发布 / 广泛兼容每个逻辑编辑批次尽量只构建一次。focused test 能证明的，不默认跑整套 UnitTests。
8. 真实设备和现场验证
AI 可做模拟、Replay、日志时间线、状态/联锁检查和只读验证方案；不自动执行高压输出、危险联锁绕过、不可逆设备动作和正式现场验收。
9. 项目经验怎么留下
text
CONTEXT.md → 稳定业务语言
.agent-memory → 过去发生过什么、怎么验证过
ADR → 长期重要设计取舍
正式技术文档 → 给评审、用户、测试和交付使用10. 最短选择器
text
问现状 → Read-Only Trace
明确小改 → Fast
规则说清 → Execution
业务未知 → Discovery
“以前正常” → RegressionFix
“先临时放开” → ExperimentalChange