mcpField
M
miniapp-devtools-cli-repair

miniapp-devtools-cli-repair

github.com/sun-sunshine06開発2841 回インストール6 日前に更新
リポジトリ

miniapp-devtools-cli-repair について

miniapp-devtools-cli-repair は、WeChat DevTools の公式コマンドラインを使ってミニプログラムのコンパイルやプレビューの失敗を調べるスキルです。CLI の出力を重視し、自動修正を明確なリポジトリ内の問題に限定します。

主な機能

  1. 01CLI によるコンパイル・プレビュー診断
  2. 02open による IDE 接続確認
  3. 03エラー分類と修正範囲の判定
  4. 04リポジトリ内の限定的な自動修正
  5. 05実務向けの修復結果レポート

活用シーン

  1. 01ミニプログラムのプレビュー失敗の調査
  2. 02プロジェクトパスやページ設定のずれの特定
  3. 03CLI で確認できる問題と GUI・実行時の問題の切り分け

インストール

コマンドをコピーしてターミナルで実行します。

$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

詳細

Miniapp Devtools Cli Repair

概要

ユーザーが WeChat DevTools から CLI で確認できる証拠を必要としている場合に、このスキルを使用します。公式 CLI を、コンパイルおよびプレビューの失敗に対する主要な可観測性サーフェスとして扱います。

クイックスタート

  1. references/cli-repair-playbook.md を読みます。
  2. 公式 DevTools CLI が存在し、ヘルプを出力できることを確認します。
  3. open を使用して IDE の接続性とライブサービスポートを確立します。
  4. preview を主要なミニプログラムのコンパイルチェックとして使用します。
  5. 結果を次のように分類します。
    • CLI で確認でき、自動修正可能
    • CLI で確認できるが、自動修正は安全ではない
    • ホストまたはアカウントのブロッカー
    • プレビューのスコープ外であり、GUI またはサービスレベルのデバッグで対応する方が適切

コアルール

  • 一次診断では、スクリーンショットよりも公式 WeChat DevTools CLI を優先します。
  • CLI の出力、終了コード、プロセス状態、ローカルログを主要な証拠として扱います。
  • ミニプログラムのコンパイル診断では、engine build よりも preview を優先します。
  • ライブサービスポートが不明な場合、または現在の 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 対応