mcpField
M
miniapp-devtools-cli-repair

miniapp-devtools-cli-repair

github.com/sun-sunshine06开发2841 次安装6 天前更新
代码仓库

关于 miniapp-devtools-cli-repair

miniapp-devtools-cli-repair 是一项技能，通过微信 DevTools 官方命令行诊断小程序编译和预览故障。它优先依据命令行证据，并将自动修复限制在明确且仅影响仓库的问题。

主要功能

  1. 01基于命令行诊断编译与预览
  2. 02使用 open 检查 IDE 连接
  3. 03错误分类与修复边界判定
  4. 04仅修复仓库内的特定问题
  5. 05输出可执行的修复报告

适用场景

  1. 01排查小程序预览失败
  2. 02识别项目路径或页面配置偏差
  3. 03区分命令行问题与图形界面或运行时问题

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/sun-sunshine06/miniprogram-skills --skill miniapp-devtools-cli-repair

安装后在 Claude Code 中输入/miniapp-devtools-cli-repair确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

agents/
openai.yaml
references/
cli-repair-playbook.md
example-prompts.md

详细介绍

小程序开发者工具 CLI 修复

概述

当用户需要来自微信开发者工具的 CLI 可见证据时，使用此技能。将官方 CLI 视为编译和预览失败的主要可观测面。

快速上手

  1. 阅读 references/cli-repair-playbook.md。
  2. 确认官方开发者工具 CLI 存在并可以打印帮助信息。
  3. 使用 open 建立 IDE 连接和实时服务端口。
  4. 使用 preview 作为主要的小程序编译检查。
  5. 将结果分类为：
    • CLI 可见且可自动修复
    • CLI 可见但不安全自动修复
    • 主机或账号阻塞
    • 超出预览范围，更适合由 GUI 或服务级调试处理

核心规则

  • 首次诊断时优先使用官方微信开发者工具 CLI，而非截图。
  • 将 CLI 输出、退出码、进程状态和本地日志视为主要证据。
  • 对于小程序编译诊断，优先使用 preview 而非 engine build。
  • 当实时服务端口未知或当前 IDE 会话可疑时，先使用 open。
  • 仅自动修复仓库范围内的问题，例如根路径漂移、页面路径不匹配，或带有精确位置的小型语法问题。
  • 如果 preview 已经通过，或剩余的阻塞是页面侧的 request:fail，不要继续反复修复 CLI；转向 GUI/运行时或服务调试。
  • 当错误仅存在于 GUI 专属面板、运行时请求或编译模式菜单中时，不要声称已完全覆盖。

自动修复边界

仅当修复一致且局限于仓库时，才自动应用修复：

  • 修复 project.config.json
  • 修复 tsconfig.json
  • 修复 app.json
  • 删除错误根的残留
  • 恢复已跟踪的文件
  • 将精确定位的不受支持的语法形式替换为等效的窄范围修复

当变更会改变应用策略、发布状态、后端设置或仓库范围内的大面积语法时，未经用户明确指示，不要自动修复。

输出格式

回答时，保持结果具有可操作性：

  1. CLI 暴露了什么
  2. 该问题是否可自动修复
  3. 更改了什么，或仍需要哪些进一步证据
  4. 下一条命令或用户操作

资源

  • references/cli-repair-playbook.md：命令阶梯、超时处理和修复边界
  • references/example-prompts.md：可复用的触发示例和评估说明

评论

支持 Markdown