mcpField
M
miniapp-official-scaffold-alignment

miniapp-official-scaffold-alignment

github.com/sun-sunshine06Development2841 installsUpdated 6d ago
Repository

About miniapp-official-scaffold-alignment

miniapp-official-scaffold-alignment is a skill for checking whether a WeChat miniapp repository matches the official scaffold expectations before implementation changes. It identifies valid, missing, or risky structure and recommends the smallest next scaffold decision.

Key features

  1. 01Checks repository and miniapp roots
  2. 02Reviews project.config.json and app.json
  3. 03Validates page and component file sets
  4. 04Checks explicit TypeScript configuration
  5. 05Reports risks and next scaffold steps

Use cases

  1. 01Auditing a miniapp before page edits
  2. 02Checking page paths against app.json
  3. 03Reviewing custom component structure
  4. 04Planning the first scaffold correction

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/sun-sunshine06/miniprogram-skills --skill miniapp-official-scaffold-alignment

After installing, type/miniapp-official-scaffold-alignmentin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

agents/
openai.yaml
references/
example-prompts.md
official-scaffold-baseline.md

Details

From the project README

Miniapp Official Scaffold Alignment

Overview

Use this skill when scaffold correctness is the blocker. Validate the repository shape before changing pages, components, or build settings.

Quick Start

  1. Read references/official-scaffold-baseline.md.
  2. Identify the repository root and the miniapp code root.
  3. Check project.config.json, app.json, page paths, component file sets, and TypeScript assumptions.
  4. Report what is already valid, what is incomplete or risky, and the smallest next scaffold decision.

Core Rules

  • Use only official WeChat documentation for normative claims.
  • Prefer the smallest runnable scaffold that matches the project shape.
  • Distinguish repository root from miniapp code root.
  • If the repo authors in TypeScript, make the compiler-plugin path explicit.
  • Require matching path-and-name file quartets for pages and components.
  • Write "not yet specified" instead of inventing missing spec details.

Review Checklist

  • Does project.config.json point at the intended miniapp code root?
  • Does app.json.pages match real page folders?
  • Does every page have matching logic, structure, style, and config files?
  • Do custom components declare component: true and have matching file sets?
  • Is TypeScript support explicit rather than implied?
  • Does the repo layout leave room for sibling folders such as docs/, backend code, or tooling?

Output Format

When answering, keep the result short and action-oriented:

  1. officially valid parts
  2. missing or risky parts
  3. recommended scaffold decision
  4. first edit to make

Resources

  • references/official-scaffold-baseline.md: official rule summary and practical implications
  • references/example-prompts.md: reusable trigger examples and evaluation notes

Comments

Markdown supported