SkillsAdd

sun-sunshine06/miniprogram-skills · Archived

miniapp-devtools-cli-repair

Diagnose WeChat DevTools failures through the official CLI instead of relying only on GUI screenshots.

First seen May 4, 2026

Installation

$ npx skills add sun-sunshine06/miniprogram-skills --skill miniapp-devtools-cli-repair
View on skills.sh ↗ GitHub repository ↗

Summary

  • Diagnose WeChat DevTools failures through the official CLI instead of relying only on GUI screenshots.
  • Use when Codex needs to run `open`, `preview`, or related commands, discover the live service port, classify whether a failure is CLI-visible, host-side, or outside preview scope, and apply or suggest only safe repo-level fixes.

Stronger alternatives

This repository is archived — consider an actively maintained alternative.

miniapp-devtools-recovery Same source
sun-sunshine06/miniprogram-skills

Recover a WeChat Mini Program repository after wrong-root import, DevTools template residue, st…

35 installs
miniapp-official-scaffold-alignment Same source
sun-sunshine06/miniprogram-skills

Validate or design a WeChat Mini Program scaffold, repository layout, or TypeScript setup again…

34 installs
miniapp-center-hub-refactor Same source
sun-sunshine06/miniprogram-skills

Refactor a growing WeChat Mini Program whose top-level navigation has become scattered across t…

33 installs
miniapp-devtools-gui-check Same source
sun-sunshine06/miniprogram-skills

Use host-side WeChat DevTools automation to inspect GUI-only runtime and interaction failures t…

33 installs

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

frontend-design Same topic
anthropics/skills

Guidance for distinctive, intentional visual design when building new UI or reshaping an existi…

866.4K installs
agent-browser Same topic
vercel-labs/agent-browser

Browser automation CLI for AI agents. Use when the user needs to interact with websites, includ…

810.4K installs
vercel-react-best-practices Same topic
vercel-labs/agent-skills 697.8K installs
web-design-guidelines Same topic
vercel-labs/agent-skills

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "chec…

617.3K installs
microsoft-foundry Same topic
microsoft/azure-skills

Build, deploy, evaluate, optimize, fine-tune, and manage Microsoft Foundry agents, models, and …

576.5K installs
azure-diagnostics Same topic
microsoft/azure-skills

Debug Azure production issues on Azure using AppLens, Azure Monitor, resource health, and safe …

568.9K installs

Also in this package

Other skills from sun-sunshine06/miniprogram-skills.

npx skills add sun-sunshine06/miniprogram-skills
miniapp-devtools-recovery 35 miniapp-official-scaffold-alignment 34 miniapp-center-hub-refactor 33 miniapp-devtools-gui-check 33 miniapp-user-facing-copy-trim 32

Browse all from sun-sunshine06/miniprogram-skills

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 21
License LICENSE
Default branch main
Open issues 3
Status Archived

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,815 B
  • docs SUMMARY.md 366 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 35 installs

SKILL.md

Miniapp Devtools Cli Repair

Overview

Use this skill when the user needs CLI-visible evidence from WeChat DevTools. Treat the official CLI as the primary observability surface for compile and preview failures.

Quick Start

  1. Read references/cli-repair-playbook.md.
  2. Confirm the official DevTools CLI exists and can print help.
  3. Use open to establish IDE connectivity and the live service port.
  4. Use preview as the primary mini program compile check.
  5. Classify the result as:

- CLI-visible and auto-fixable - CLI-visible but not safe to auto-fix - host or account blocker - outside preview scope and better handled by GUI or service-level debugging

Core Rules

  • Prefer the official WeChat DevTools CLI over screenshots for first-pass diagnosis.
  • Treat CLI output, exit code, process state, and local logs as primary evidence.
  • For miniapp compile diagnosis, prefer preview over engine build.
  • Use open first when the live service port is unknown or the current IDE session is suspect.
  • Auto-fix only repository-scoped problems such as root-path drift, page-path mismatch, or small syntax issues surfaced with exact locations.
  • If preview is already green or the remaining blocker is a page-side request:fail, do not keep grinding CLI repair; move to GUI/runtime or service debugging.
  • Do not claim full coverage when the error exists only in GUI-only panels, runtime requests, or compile-mode menus.

Auto-Fix Boundary

Apply fixes automatically only when they are coherent and local to the repo:

  • repair project.config.json
  • repair tsconfig.json
  • repair app.json
  • delete wrong-root residue
  • restore tracked files
  • replace a pinpointed unsupported syntax form with an equivalent narrow fix

Do not auto-fix without explicit user direction when the change would alter app strategy, publish state, backend settings, or broad syntax across the repo.

Output Format

When answering, keep the result operational:

  1. what the CLI exposed
  2. whether the issue is auto-fixable
  3. what was changed or what further evidence is still needed
  4. the next command or user action

Resources

  • references/cli-repair-playbook.md: command ladder, timeout handling, and fix boundaries
  • references/example-prompts.md: reusable trigger examples and evaluation notes