Comet Runtime Diagnose

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

rpamis fe66cf4 2 files · 2.2 KB Updated

File contents

Comet Runtime 诊断

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

确定问题边界

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

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

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

执行真实路径

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

报告诊断结果

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

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

rpamis/comet/tree/main/assets/skills-maintainer/comet-runtime-diagnose commit fe66cf4d38

Frequently asked questions

npx skillmds add rpamis/comet-runtime-diagnose