Appearance
AI 工程能力地图（V10）
能力地图回答两个问题：现在是在做什么任务？这个任务真正需要哪些能力？
V10 不再默认把“需求→设计→开发→测试→文档”串成每次都要执行的流水线，而是先经过 Intent Gate。
1. 先按任务类型找能力
| 当前任务 | 推荐能力 | 主要入口 |
|---|---|---|
| 查当前代码怎么工作 | Read-Only Trace | 读懂 C# 项目 |
| 文案/样式/局部显示 | Fast / MicroPatch | 功能修改最小流程 |
| 阈值、连续次数、报警后果 | BehaviorPatch | 行为与告警语义 |
| 一个数字可能跨 UI/MES/设备 | DomainConstraint | 业务约束跨层传播 |
| 原始值/换算值/单位问题 | Measurement Semantics | 测量值语义 |
| 操作员提示和底层错误混在一起 | Operator / Diagnostic Layering | 操作员界面与维护诊断 |
| 多源日志、不知道第一个异常在哪 | Log Timeline Analysis | 日志与时间线诊断 |
| UI 卡顿、CPU、内存增长、长稳 | Performance / Long-run | 性能与长稳诊断 |
| 真机、高压、运动、阀门等验证 | Hardware Safety / HITL | 真实设备操作安全 |
| 以前正常、最近异常 | Temporal Regression | Bug / 回归定位 |
| 临时边界测试 | ExperimentalChange | 功能修改最小流程 |
| 新项目/新主流程 | Discovery + Design | 完整项目工作流 |
| 测试和回归 | V0–V4 Verification | 验证体系 |
| 正式方案/总结/说明书 | Technical Documentation | 技术文档工程 |
2. V10 核心路由与横切能力
text
Intent Gate
│
├─ Read-Only Trace
├─ Fast
│ └─ MicroPatch
├─ Execution
│ ├─ MicroPatch
│ ├─ BehaviorPatch
│ ├─ RegressionFix
│ └─ ExperimentalChange
└─ Discovery
└─ Decision Tree / Frontier
独立维度：V0–V4 Verification
横切能力：
DomainConstraint
Measurement Semantics
Operator / Diagnostic Layering
Log Timeline Analysis
Performance / Long-run
Hardware Safety / HITL3. 16 个专家 Skill 在哪里发挥作用
| Skill | 主要能力 | 常见触发 |
|---|---|---|
| 00 project-orchestrator | Intent Gate / 编排 | 大型多能力任务 |
| 01 requirement-analyst | Decision Tree / Frontier | Discovery |
| 02 system-designer | 架构、状态机、线程、边界 | 新子系统/跨模块设计 |
| 03 ui-designer | 页面职责、复杂交互 | 新页面/重设计 |
| 04 protocol-designer | 帧、字段、CRC、时序 | 新协议/协议变化 |
| 05 communication-expert | 串口/TCP/UDP、恢复 | 通信实现/故障 |
| 06 data-storage-designer | CSV/DB/兼容/迁移 | 数据设计 |
| 07 code-generator | 已准备好的新能力实现 | Execution |
| 08 feature-updater | MicroPatch / BehaviorPatch / ExperimentalChange | 已有项目修改 |
| 09 bug-investigator | Feedback Ladder / Temporal Regression | 根因未知 |
| 10 bug-fixer | 最小补丁 | 根因已较明确 |
| 11 regression-guardian | 影响与回归范围 | 高风险变更 |
| 12 test-designer | focused test / smoke / matrix | V1–V4 |
| 13 log-analyzer | 多源时间线、首个异常点 | 现场日志/报文问题 |
| 14 performance-analyzer | CPU/UI/内存/IO/长稳 | 性能和资源问题 |
| 15 document-generator | 正式技术文档工程 | 方案/总结/说明书/验收 |
日常不需要用户自己手工拼接这些专家，统一入口按任务需要启用。
4. Discovery 与设计能力
Discovery 只解决会改变最终业务结果的未知：
text
事实由 Agent 查
决策由用户定
→ Decision Tree
→ 当前 Frontier
→ Blocking Unknowns 清零
→ Execution总体/详细设计也只在系统边界真的变化时展开。一个明确局部 BehaviorPatch 不机械补全 UI、通信、数据、状态机和线程五套设计。
5. 开发实现与 DomainConstraint
实现的核心：
text
目标明确
→ 代码事实核对
→ 最小 change surface
→ Diff
→ V0–V4 验证一个数字也可能跨层：
text
UI → Domain/Application → MES/API → DeviceApply → FocusedTests先判断是 DisplayOnly、正式 DomainConstraint 还是临时 ExperimentalChange，再决定传播范围。
6. 操作员体验与维护诊断
text
OperatorSummary
= 简短中文 + 当前后果 + 下一步动作
DiagnosticDetail
= 原始协议 + 错误码 + 寄存器 + 堆栈 + 时间线主界面不应优先展示 PID、线程、内部服务名和原始 SCPI；维护日志也不能只剩“失败”两个字。
7. 日志与时间线能力
现场复杂问题先把多源证据按时间对齐：
text
UI 操作
+ App 状态
+ TX/RX
+ Device error
+ Storage/MES
→ Timeline
→ First anomaly结论只分三层即可：
text
Evidence
Inference
Unknown重点不是找最后一条 Error，而是找到系统第一次偏离正常行为的位置。近期回归再叠加 known-good 时间线，偶发问题尽量转成 Captured Replay。
详见 日志与时间线诊断。
8. 性能与长稳能力
性能分析：
text
Baseline
→ narrow hotspot
→ one change
→ same scenario re-test
→ compare覆盖 Dispatcher、图表/日志增长、接收回调、同步 IO、背压、GC、资源泄漏和 Stop 假死。没有量化证据时，不把“大重构会更快”写成结论。
详见 性能与长稳诊断。
9. 真实设备操作与 HITL
真实设备默认：
text
HardwareAction: ForbiddenByDefault优先：
text
静态/单测
→ Fake / Replay
→ 必要的真实设备只读观察
→ 显式授权的状态改变
→ 高风险动作 HITL没做真机步骤时标记 HardwarePending。
10. Bug 与现场调查
Feedback Ladder：
text
focused test
→ Fake / Simulation
→ Replay
→ logs / timeline / known-good diff
→ harness
→ read-only device
→ HITLEvidenceGrade：A 自动稳定复现；B 稳定 Fake/Replay；C 日志+代码+known-good；D 候选假设。D 级不能写成“根因已确认”。
11. V0–V4 Verification
- V0：静态；
- V1：局部构建；
- V2：设备/通信/数据 focused；
- V3：状态机/联锁/workflow；
- V4：发布/全量。
Verification Level 决定软件验证深度，不等于真机动作授权。
12. Project Knowledge
| 载体 | 用途 |
|---|---|
| Rules | 必须遵守的工程边界 |
CONTEXT.md | 稳定业务术语 |
.agent-memory/ | 历史修改和已验证事实 |
| ADR | 长期重要设计取舍 |
项目记录只保存未来能减少搜索、返工或争议的信息。
13. 技术文档工程
覆盖设计方案、详细设计、研制总结、使用说明、测试/验收、需求规格、接口协议和 Evidence Map。不能确认的内容保持 Unverified / DesignOnly / HardwarePending。
14. Architecture Hotspot Review
这是显式治理能力，不随普通任务自动运行。只有长期 Git hot spot、耦合反复造成返工、状态/副作用过度分散等问题才启用。
15. 最终地图
text
查现状 → Read-Only Trace
小显示 → Fast / MicroPatch
一个数字跨多层 → DomainConstraint
明确规则变化 → BehaviorPatch
操作提示混乱 → Operator / Diagnostic Layering
日志太多看不清 → Log Timeline Analysis
卡顿/内存/长稳 → Performance / Long-run
真机危险动作 → Hardware Safety / HITL
旧版正常新版坏 → RegressionFix
临时测试 → ExperimentalChange
业务未知 → Discovery
系统边界变化 → Architecture / Design
现场复杂问题 → Feedback Ladder
验证 → V0–V4
正式资料 → Technical Documentation
长期知识 → Context / Memory / ADR