---
name: comet-runtime-diagnose
description: 通过区分过期配置与源码缺陷，并执行真实打包 Runtime 路径，诊断 Comet Hook、安装、路由、平台、生成 Runtime 或生命周期行为。Hook 或安装报告可能涉及配置、生成资产漂移、不支持的平台或跨项目归属问题时使用。
disable-model-invocation: true
---

# Comet Runtime 诊断

先读取 `../comet-github/references/maintainer-contract.md`。修改源码或重新安装前，先完成诊断。

## 确定问题边界

将报告分类为以下一种或多种：

- 本地安装过期或不完整；
- 项目/全局配置或路径归属问题；
- 源码/Runtime 逻辑缺陷；
- 生成资产漂移；
- 平台注册、安装或卸载不一致；
- 文档或生命周期契约不一致。

检查当前源码、已安装文件、生成资产、平台元数据、生命周期 JSON/配置和相关测试。涉及真实执行时，静态配置检查不足以得出结论。

## 执行真实路径

- 使用宿主提供的项目 `cwd` 和实际平台标识（如果有），调用生成/打包后的 Router 或 Runtime。
- 必要时检查被保护和允许的阶段，以及缺少或存在歧义的项目上下文。
- 跨平台工作对照规范平台注册表，检查每个受影响的 adapter；不要用短的手写平台列表替代规范注册表。
- 怀疑源码时，对照源码入口、生成 bundle、Manifest 和已安装副本。
- 区分项目级和全局 Hook 归属；缺少可信宿主上下文时保持中立，不要自行扫描当前进程目录。

## 报告诊断结果

返回观察到的命令/路径、预期契约、实际结果、分类、证据和最小下一步。明确问题是可复现、仅配置、仅生成物，还是生产缺陷。

除非用户要求，不修改源码、生成资产、安装状态或 GitHub Issue。用户授权修复时，交给 `comet-github-issue-fix`，并从源码重新构建生成 Runtime 后再验证。