NocodeMrLi/mini-program-engineering-skill-suite
mini-program-engineering-suite
VerifiedOrchestrate evidence-first engineering for WeChat and other mini programs from a vague idea or existing repository through project discovery, product specification, architecture, implementation, debugging, device adaptation, verification, and release readiness. Use when users ask to build a mini program from zero to one, take over an existing mini-program project, deliver a cross-stage feature, diagnose project status, coordinate development and testing, or judge whether a mini program is ready to upload or release. Enforces fact discovery, change boundaries, stage gates, evidence-calibrated status, sensitive-information redaction, and continuity after side questions.
scripts/check_i18n_readme_structure.py
View on GitHub#!/usr/bin/env python3
"""Check that all public README translations keep the same core structure."""
from __future__ import annotations
import argparse
import json
import re
import sys
from pathlib import Path
from typing import Sequence
README_HEADINGS: dict[str, list[str]] = {
"README.md": [
"# 小程序开发工程技能套件",
"## 核心亮点",
"## 32 秒看懂这套技能",
"## 项目状态",
"## 它解决了什么问题",
"## 真实项目来源:语宠精灵",
"## 它帮助 Agent 做到这些事",
"## 平台规则保鲜",
"## 能力清单",
"## 设计原则",
"## 适用场景",
"## 使用方法",
"## 它不会做什么",
"## 验证",
"## 包完整性",
"## 当前版本",
"## 许可证",
],
"README.en.md": [
"# Mini Program Engineering Skill Suite",
"## Highlights",
"## Understand the Skill in 32 Seconds",
"## Status",
"## What It Solves",
"## Real Project Origin: WordPet",
"## Component Map",
"## Design Principles",
"## Platform Rule Freshness",
"## Intended Use",
"## How To Use",
"## What It Does Not Do",
"## Verification",
"## Package Integrity",
"## Version",
"## License",
],
"README.zh-Hant.md": [
"# 小程式開發工程技能套件",
"## 核心亮點",
"## 32 秒看懂這套技能",
"## 專案狀態",
"## 它解決了什麼問題",
"## 真實專案來源:語寵精靈",
"## 它幫助 Agent 做到這些事",
"## 能力清單",
"## 設計原則",
"## 平台規則保鮮",
"## 使用方法",
"## 它不會做什麼",
"## 驗證",
"## 包完整性",
"## 目前版本",
"## 授權",
],
"README.ja.md": [
"# Mini Program Engineering Skill Suite",
"## ハイライト",
"## 32 秒で概要を見る",
"## ステータス",
"## 解決する課題",
"## 実プロジェクト由来:WordPet",
"## Agent ができるようになること",
"## コンポーネント一覧",
"## 設計原則",
"## プラットフォーム規則の鮮度保持",
"## 使い方",
"## しないこと",
"## 検証",
"## パッケージ完全性",
"## バージョン",
"## ライセンス",
],
"README.th.md": [
"# Mini Program Engineering Skill Suite",
"## จุดเด่นหลัก",
"## เข้าใจ Skill นี้ใน 32 วินาที",
"## สถานะโปรเจกต์",
"## แก้ปัญหาอะไร",
"## ที่มาจากโปรเจกต์จริง: WordPet",
"## ช่วยให้ Agent ทำอะไรได้",
"## ความสามารถหลัก",
"## หลักการออกแบบ",
"## ความสดของกฎแพลตฟอร์ม",
"## วิธีใช้",
"## สิ่งที่ไม่ทำ",
"## การตรวจสอบ",
"## ความสมบูรณ์ของ package",
"## เวอร์ชัน",
"## สัญญาอนุญาต",
],
"README.id.md": [
"# Mini Program Engineering Skill Suite",
"## Sorotan Utama",
"## Pahami Skill Ini dalam 32 Detik",
"## Status Proyek",
"## Masalah yang Diselesaikan",
"## Asal dari Proyek Nyata: WordPet",
"## Yang Dibantu untuk Agent",
"## Peta Kemampuan",
"## Prinsip Desain",
"## Kesegaran Aturan Platform",
"## Cara Menggunakan",
"## Yang Tidak Dilakukan",
"## Verifikasi",
"## Integritas Paket",
"## Versi",
"## Lisensi",
],
}
HEADING_RE = re.compile(r"^(#{1,2})\s+.+$", re.MULTILINE)
# Cross-language fact alignment (audit finding: structure checks alone cannot
# catch one translation keeping a stale version while others were bumped).
VERSION_RE = re.compile(r"version-(\d+\.\d+\.\d+)-")
TARBALL_RE = re.compile(r"mini-program-engineering-suite-v(\d+\.\d+\.\d+)\.tar\.gz")
def extract_headings(path: Path) -> list[str]:
"""Return top-level and second-level Markdown headings from a README."""
text = path.read_text(encoding="utf-8")
return [match.group(0).strip() for match in HEADING_RE.finditer(text)]
def check_fact_alignment(root: Path, errors: list[str]) -> None:
"""All READMEs must carry the same version as VERSION, everywhere it appears.
Both directions are enforced: a present-but-drifted version is an error,
and a README whose version references are MISSING entirely is an error too
(deleting the badge and tarball commands used to pass silently — audit
finding: presence checks only ran when a regex had matched).
"""
version_file = root / "VERSION"
canonical = version_file.read_text(encoding="utf-8").strip() if version_file.is_file() else ""
if not canonical:
errors.append("VERSION: missing or empty")
return
for readme_name in README_HEADINGS:
path = root / readme_name
if not path.is_file():
continue
text = path.read_text(encoding="utf-8")
badge_versions = set(VERSION_RE.findall(text))
tarball_versions = set(TARBALL_RE.findall(text))
# Presence: the version badge and the tarball command are required
# facts in every translation; stripping them must not pass.
if not badge_versions:
errors.append(f"{readme_name}: version badge missing entirely")
if not tarball_versions:
errors.append(f"{readme_name}: tarball version reference missing entirely")
if badge_versions - {canonical}:
errors.append(f"{readme_name}: badge version drift {sorted(badge_versions)} != {canonical}")
if tarball_versions - {canonical}:
errors.append(f"{readme_name}: tarball version drift {sorted(tarball_versions)} != {canonical}")
if badge_versions and canonical not in badge_versions:
errors.append(f"{readme_name}: badge missing current version {canonical}")
if tarball_versions and canonical not in tarball_versions:
errors.append(f"{readme_name}: tarball missing current version {canonical}")
def check_i18n_readme_structure(root: Path) -> dict[str, object]:
"""Return a structured report for README heading consistency."""
errors: list[str] = []
checked: dict[str, list[str]] = {}
for readme_name, expected in README_HEADINGS.items():
path = root / readme_name
if not path.is_file():
errors.append(f"{readme_name}: missing README")
continue
actual = extract_headings(path)
checked[readme_name] = actual
if actual != expected:
errors.append(
f"{readme_name}: heading structure drifted; expected {len(expected)} headings, got {len(actual)}"
)
check_fact_alignment(root, errors)
return {
"valid": not errors,
"errors": errors,
"checked_readmes": len(checked),
"expected_readmes": len(README_HEADINGS),
}
def main(argv: Sequence[str] | None = None) -> int:
"""Run the README i18n structure check."""
parser = argparse.ArgumentParser(description=__doc__)
parser.add_argument("root", nargs="?", type=Path, default=Path("."), help="Suite root directory")
args = parser.parse_args(argv)
report = check_i18n_readme_structure(args.root.resolve())
print(json.dumps(report, ensure_ascii=False, indent=2, sort_keys=True))
return 0 if report["valid"] else 1
if __name__ == "__main__":
raise SystemExit(main())
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |