Appearance
资料包文件用途总览（V10）
host-computer-dev 是面向 C#/.NET/WPF/WinForms 工业上位机开发的 Agent Skill。V10 先区分“只是查现状”还是“需要修改”，再按 Fast / Execution / Discovery 使用足够但不过量的工程纪律。
**当前状态：**网站页面和仓库核心源码镜像已经是 V10；旧网站 ZIP 已删除。完整 V10 安装包已经在本地生成并校验，但正式网站二进制下载文件尚未重新发布，所以目前不要把
docs/skills/host-computer-dev/当成完整安装包。
1. 完整安装包为什么有 17 个目录
完整 V10 安装结构是：
text
host-computer-dev/ ← 统一入口
host-computer-dev-00-project-orchestrator/
host-computer-dev-01-requirement-analyst/
host-computer-dev-02-system-designer/
...
host-computer-dev-15-document-generator/也就是：
text
1 个统一入口
+ 16 个可独立调用专家
= 17 个可安装 Skill 目录日常主要显式调用：
text
$host-computer-dev独立专家目录用于需要明确指定某一专业能力的情况。
2. 统一入口完整版本内部还有什么
完整安装包里的 host-computer-dev/ 不只是 SKILL.md，还包含：
text
host-computer-dev/
├─ SKILL.md
├─ README.md
├─ workflow-contract.json
├─ 00-project-orchestrator/
├─ 01-requirement-analyst/
├─ ...
├─ 15-document-generator/
├─ references/
├─ templates/
├─ scripts/
├─ evals/
├─ _shared/
└─ agents/这些内容负责统一路由、工程规则、文档能力、自动化入口和回归评估。
3. 网站仓库里的 docs/skills/host-computer-dev/ 是什么
当前 GitHub 仓库保留：
text
docs/skills/host-computer-dev/它是 V10 核心源码镜像，用于快速核对：
- 根
SKILL.md； README.md；workflow-contract.json；- V10 release/migration 说明；
- 关键
references/。
它没有复制完整 17-Skill 安装目录，因此：
text
docs/skills/host-computer-dev/
≠ 完整安装包4. 三种载体的职责
| 载体 | 用途 | 当前状态 |
|---|---|---|
docs/skills/host-computer-dev/ | GitHub 上核对 V10 核心规则 | 已更新 V10 |
docs/public/host-computer-dev-skill.zip | 网站完整安装包预定路径 | 当前未发布 |
25-host-computer-dev-Skill说明.md | 面向用户的权威说明 | 已更新 V10 |
正式恢复 ZIP 下载时，必须保证完整包内容、Skill 说明和核心镜像版本一致。
5. V10 根 Skill 最关键的能力
| 能力 | 用途 |
|---|---|
| Intent Gate | Read-Only / Fast / Execution / Discovery |
| UI MicroPatch Bypass | 小 UI 修改不加载重设计流程 |
| BehaviorPatch | 阈值、连续次数、报警后果、运行规则 |
| RegressionFix | known-good-first 的近期回归定位 |
| ExperimentalChange | 临时边界测试可恢复，不污染正式规格 |
| Measurement Semantics | Raw/工程量/换算/阈值/单位 |
| DomainConstraint | 固定跨层传播链 |
| Operator Message Policy | 操作员信息与维护诊断分层 |
| Feedback Ladder | Test/Fake/Replay/日志/真机逐级取证 |
| Hardware Safety | 真机状态改变默认不自动执行 |
| V0–V4 | 按风险选择验证强度 |
| Context/Memory/ADR | 项目长期知识分层 |
6. 16 个专家 Skill
| 编号 | 名称 | 主要职责 |
|---|---|---|
| 00 | project-orchestrator | Intent Gate、路由和任务状态 |
| 01 | requirement-analyst | Discovery / Decision Tree / Frontier |
| 02 | system-designer | 架构、状态机、线程和边界 |
| 03 | ui-designer | 新页面与复杂交互 |
| 04 | protocol-designer | 帧、字段、CRC、协议状态 |
| 05 | communication-expert | 串口/TCP/UDP、Session、恢复 |
| 06 | data-storage-designer | 文件/数据库、兼容和追溯 |
| 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 / WorkflowSmoke |
| 13 | log-analyzer | 多源日志时间线、首个异常点 |
| 14 | performance-analyzer | UI/CPU/内存/IO/长稳 |
| 15 | document-generator | 方案、详细设计、总结、说明书、验收、协议 |
网站对应专题可从 AI 工程能力地图 查找。
7. 通用 Skill、项目知识和任务记录不要混在一起
text
Skill references
= 通用工程方法
CONTEXT.md
= 当前项目稳定业务术语
.agent-memory/
= 当前项目过去发生过什么、已验证的局部事实
ADR
= 长期重要且不直观的设计取舍
Git / task record
= 当前任务实际改了什么Fast UI MicroPatch 默认不读取全部 Context/ADR/Memory。
8. 常见使用方式
text
查当前行为
→ Read-Only Trace
改文案/样式
→ Fast / MicroPatch
改明确运行规则
→ Execution / BehaviorPatch
以前正常最近坏了
→ RegressionFix
临时放开边界
→ ExperimentalChange
新项目/业务仍不明确
→ Discovery现场日志复杂时可进入 日志与时间线诊断；卡顿和长稳进入 性能与长稳诊断；涉及真实设备状态改变时另走 真实设备操作安全。
9. 当前下载发布原则
完整 V10 包在重新写入网站正式下载路径之前：
- 不保留旧版本 ZIP 冒充 V10；
- 不把核心源码镜像包装成“完整安装包”；
- 页面明确标记当前下载状态；
- 恢复下载后再在 Skill 说明和本页统一开放入口。
这保证“暂时没有下载按钮”也好过“下载到错误版本”。
下一步
一句话原则
核心镜像用于核对规则，完整安装包用于真正安装；两者用途不同，版本状态必须明确。