host-computer-dev Skill 说明（V10）

内容类型：权威说明难度：进阶适合：长期使用编码 Agent 开发 C#/.NET/WPF/WinForms 工业上位机的工程师阅读时间：约 15 分钟

host-computer-dev 的目标不是让所有任务都走一套重流程，而是：

先把任务类型分对，再使用最便宜且足够可靠的工程纪律。

它重点解决上位机项目里最容易反复返工的几类问题：小改被做重、明确规格被重新规划、现场回归靠猜、报警/停机语义混乱、Raw/工程量混淆、设备 Session 残留、真机验证边界不清、技术文档结论超过证据。

1. 统一入口：Intent Gate

$host-computer-dev
        ↓
Intent Gate
        │
        ├─ 只是查现状 → Read-Only Trace
        │
        └─ 需要修改
             ↓
        Fast / Execution / Discovery

Read-Only Trace

例如：

• 这个阈值在哪判断？
• 停机窗口是单次还是连续？
• 当前是 SING 还是 RUN？
• 配置到底从哪里读？

默认：

精确目标
→ owner
→ caller / callee
→ 最终 sink
→ 结论 + 证据
→ END

不建修改任务、不 build/test、不写修改记录、不加载无关专家。

Fast

用于文案、样式、列宽、Margin、已有 Style、纯展示和影响范围清楚的小修正。

UI MicroPatch 默认：

• 不自动加载额外 UI Skill；
• 不读取全局 Memory/CONTEXT/ADR；
• 精确定位；
• 最小 Diff；
• V0/V1。

Execution

用户目标和边界已经说清时，不重新写大 Plan，只做简短 Compact Brief 后实施。

Execution 四类：

MicroPatch
BehaviorPatch
RegressionFix
ExperimentalChange

Discovery

只有新项目、新主流程、新子系统，或仍存在会改变业务结果的 Blocking Unknowns 时进入。

使用：

Facts      → Agent 查
Decisions  → 用户定
Frontier   → 当前能决定且阻塞实施的问题
Deferred   → 当前不阻塞的问题

Blocking Frontier 清零就进入实施，不为了“需求完整”继续访谈。

2. BehaviorPatch：用六行契约固定运行规则

Trigger:
Condition:
Action:
Reset:
Record:
NonGoals:

尤其明确事件后果：

类型	含义
Information	仅展示/记录
Advisory	提示，但不应成为硬门禁
AlarmOnly	报警/记录，流程继续
InterlockFault	阻断/停止，按恢复规则处理

“报警”不能自动推导成“停机”。

连续 N 次、平均、防抖等还要确认：

Consecutive?
ResetOnGood?
InvalidSamplePolicy?
ReportOnce?
ResetBoundary?

3. Measurement Semantics

涉及示波器、电源、传感器和采样值时，核对：

RawValue
EngineeringValue
Conversion
ThresholdBasis
Aggregation
LoggedUnit

例如示波器 CH2 原始值可能是 V，经灵敏度换算后才是 A。日志和变量名必须说明记录的是哪一层数据。

4. DomainConstraint：一个数字也可能跨多层

先分类：

DisplayOnly
DomainConstraint
ExperimentalChange

正式业务约束只沿固定链检查一次：

UI
→ Domain/Application
→ MES/API
→ DeviceApply
→ FocusedTests

这样既防止只改 UI，也避免一个阈值导致全仓库漫游。

5. RegressionFix：以前正常，就先看时间差异

出现“昨天正常、最近改完才坏、新旧版本不一样”等表达时：

known-good
→ changed files
→ relevant method/config/protocol diff
→ behavior delta
→ root-cause evidence

硬规则：

当前代码看起来不合理 ≠ 它造成了本次回归。

只有 known-good 差异或直接运行证据，才能升级为 regression cause。

重试后恢复只能先标记 SuspectedTransient。

6. ExperimentalChange：临时测试不污染正式规格

用户说“先放开限制，我做边界测试”时优先：

engineering override
→ 窄入口
→ 正式 Domain/MES/持久化默认保持
→ 明确恢复方法

只有用户明确确认“以后正式规格就这样”，才升级成正式 BehaviorPatch。

7. 日志与时间线诊断

13-log-analyzer 的核心不是“搜索 Error”，而是：

多源日志对齐
→ 关键事件时间线
→ 第一个异常点
→ 异常前触发上下文
→ Evidence / Inference / Unknown

通信异常同时区分 Transport / Protocol / Mixed；近期回归叠加 known-good 时间线；现场偶发尽量转成 Captured Replay。

详见 日志与时间线诊断。

8. 性能与长稳诊断

14-performance-analyzer 处理 UI 卡顿、CPU、内存增长、GC、IO、通信延迟和长期运行问题。

推荐纪律：

Baseline
→ narrow hotspot
→ one change
→ same scenario re-test
→ compare

没有 profiling、时间线、基线或明确代码路径证据时，不把“大重构会更快”写成结论。

详见 性能与长稳诊断。

9. Operator Message Policy

OperatorSummary
= 简短中文 + 当前后果 + 下一步动作

DiagnosticDetail
= SCPI / Raw / 错误码 / 寄存器 / 堆栈 / 时间线

操作员界面不应变成开发调试器，维护证据也不能因为“界面简洁”被删掉。

10. Advisory Fail-Open 与安全联锁分开

磁盘空间、日志容量等非安全提示检查可以：

检查异常 → 记录/忽略 → 继续
条件成立 → 提示 → 确认后继续

但真正安全联锁不能照搬 Fail-Open。Safety condition unknown/failure 按项目安全设计处理。

11. 真实设备动作：独立安全维度

V10 默认：

HardwareAction: ForbiddenByDefault

优先：

静态/单测
→ Fake / Replay
→ 必要的真实设备只读观察
→ 显式授权的状态改变
→ 高风险动作 HITL

没有明确授权时，不自动执行高压、信号输出、电机、阀门、继电器、加热、气路和保护参数修改。

高风险动作即使允许真机验证也保持人工在环。

未执行时写：

HardwarePending

详见 真实设备操作与验证安全边界。

12. Bug Feedback Ladder

focused test
→ Fake / Simulation
→ Replay
→ logs / timeline / known-good diff
→ minimal harness
→ read-only device
→ HITL

证据等级：

• A：稳定自动复现；
• B：稳定 Fake/Replay；
• C：日志 + 代码 + known-good；
• D：候选假设。

D 级不能写成 RootCauseConfirmed。

13. V0–V4 Verification

等级	典型范围
V0	文案、静态内容
V1	XAML、局部普通代码
V2	设备、通信、MES、数据、共享约束
V3	状态机、联锁、并发、告警后果
V4	发布、广泛兼容、全量 checkpoint

需求分析深度和验证强度是两回事。

例如：明确的联锁 Bug 可以直接 Execution，但仍需 V3；一个新但很简单的显示行为可能先 Discovery，最后只需要 V1。

Verification Level 也不等于真机权限。

14. E-SafeNet / DLP

已知 E-SafeNet 项目不重复先撞同一个失败路径：

• 优先 HostDev verify；
• affected-project 一次性 preclean；
• 必要时只清受影响 obj；
• 外部 artifacts；
• 同一代码指纹已证明为环境阻断时可记录 EnvironmentBlocked；
• DOCX 优先仓库外临时副本验证，最后 Word/WPS 写回。

15. CONTEXT / Memory / ADR

CONTEXT.md
= 稳定业务语言

.agent-memory/
= 项目以前发生过什么、已验证的局部事实/环境坑

ADR
= 长期重要设计取舍的原因

ADR 只在三个条件同时满足时创建：

1. Hard to reverse；
2. Surprising without context；
3. Real trade-off。

普通小改、一次 Bug、样式选择不是 ADR。

16. 技术文档工程

15-document-generator 覆盖：

• 设计方案；
• 详细设计；
• 研制总结；
• 使用说明；
• 测试/验收；
• 需求规格；
• 接口协议；
• Review / Evidence Map。

正式文档中不能确认的结论保留：

DesignOnly
Unverified
EnvironmentBlocked
HardwarePending

详见 技术文档工程。

17. 当前仓库镜像与下载状态

仓库核心镜像

仓库中的：

docs/skills/host-computer-dev/

当前是 V10 核心源码镜像，用于核对根 Skill、workflow contract、references 和版本说明。

它不是完整的 17-Skill 安装目录，不能直接把这棵核心镜像当成完整安装包。

完整安装包

完整 V10 安装结构包含 17 个 Skill 目录：

host-computer-dev/
host-computer-dev-00-project-orchestrator/
host-computer-dev-01-requirement-analyst/
...
host-computer-dev-15-document-generator/

当前网站旧 ZIP 已移除，正式 V10 二进制下载入口尚未恢复。在完整验证包真正写入 docs/public/host-computer-dev-skill.zip 前，网站不提供一个名字叫 V10、内容却还是旧版的下载文件。

这比“链接能点但下载错版本”更安全。

18. 安装位置

推荐：

C:\Users\你的用户名\.agents\skills\

完整包解压后把 17 个目录一起复制进去。

统一入口默认显式调用：

$host-computer-dev

不建议让整套 Skill 隐式接管所有编程任务。

首次安装可执行：

$SKILL_ROOT = "$env:USERPROFILE\.agents\skills\host-computer-dev"
& "$SKILL_ROOT\scripts\HostDev.cmd" selftest

入口第一次失败，本任务立即 fallback，不让 Agent 花大量时间调试 Skill 自己。

19. 常用调用示例

只查行为

$host-computer-dev
只分析现状：停机窗口电流是单帧还是连续判断？
请追最短调用链，不修改、不 build/test。

BehaviorPatch

$host-computer-dev
停机窗口连续 5 个有效帧达到阈值时只报警，不停止；
正常帧清连续计数，同一窗口只报警一次，下一窗口重置；
记录 5 帧 RawPeak、工程值和单位。

RegressionFix

$host-computer-dev
昨天修改后信号源输出和旧版不一样。
请先确定 known-good 和相关 changed files，再分析根因，不要先改代码。

性能问题

$host-computer-dev
采集 20 分钟后 UI P95 点击延迟约 1.5 s。
请先建立基线和第一个有证据的热点，不做无证据的大重构。

临时边界测试

$host-computer-dev
我要临时放开频率上限做边界测试。
优先可恢复 engineering override；正式 MES/Domain 规则默认保持。

新项目

$host-computer-dev
我要做一个实验室多设备控制平台，目前只有目标和设备清单。
先做 Discovery Frontier，把真实操作流程、异常恢复、状态和验收要求问清，再进入设计。

20. 00–15 专家能力

编号	专家	主要职责
00	project-orchestrator	Intent Gate、路由和任务状态
01	requirement-analyst	Discovery / Frontier
02	system-designer	架构、状态机、线程、边界
03	ui-designer	新页面和复杂交互
04	protocol-designer	帧、字段、CRC、协议状态
05	communication-expert	串口/TCP/UDP、Session、恢复
06	data-storage-designer	文件/DB、迁移、兼容、追溯
07	code-generator	已准备好的新能力实现
08	feature-updater	MicroPatch / BehaviorPatch / ExperimentalChange
09	bug-investigator	Feedback Ladder / Temporal Regression
10	bug-fixer	根因明确后的最小修复
11	regression-guardian	影响范围和回归保护
12	test-designer	focused test / Fake / Replay / smoke
13	log-analyzer	多源时间线和首个异常点
14	performance-analyzer	UI/CPU/内存/IO/长稳
15	document-generator	正式技术文档工程

21. Skill 不替代什么

它不替代：

• 工程师对业务需求的最终决策；
• 设备厂商/协议资料；
• 真实设备安全操作授权；
• 高压、联锁和现场试验 HITL；
• 正式验收责任；
• 对关键结论的人工复核。

它真正解决的是：让 Agent 快速判断当前任务需要多少分析、多少修改、多少证据和多少人工介入。

下一步

• 按问题找方案
• AI 工程能力地图
• 功能修改最小流程
• Bug / 回归定位
• 技术文档工程

一句话原则

查询就查询，小改就小改，明确规格就执行，业务未知才 Discovery；复杂问题靠证据，真机动作靠授权，正式结论不超过实际验证边界。