MiaoYan App Store Workflow

SkillDev tools

Lets your agent prepare and validate a Mac App Store build of the MiaoYan app.

Available today. Use it from your connected AI after setup.

No other account needed.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the MiaoYan App Store Workflow skill

About this capability

Prepare and validate a MiaoYan Mac App Store build. Not for GitHub Releases.

What this skill tells your AI

The instructions your AI receives, as published by tw93/miaoyan in .agents/skills/appstore/SKILL.md and read by ahel’s review.

Use this skill only when the maintainer explicitly asks for App Store build or submission work.

Area	App Store	GitHub Release
Build intent	App Store distribution	Direct download and update feed
Entitlements	App Store entitlements	Developer ID entitlements
Sparkle	Not included	Included
Credentials	App Store Connect credentials	Developer ID and notarization credentials

bash scripts/build-appstore.sh
xcrun altool --validate-app -f build/AppStore/Export/MiaoYan.app -t macos --apiKey <KEY_ID> --apiIssuer <ISSUER_ID>

Use Xcode Organizer for upload when that is safer than CLI upload.

MARKETING_VERSION matches the intended release version.
CURRENT_PROJECT_VERSION is incremented when required.
App Store entitlements are used.
The App Store configuration builds cleanly.
Screenshots and metadata are ready in App Store Connect when needed.
Submission copy ships with the build by default: derive Promotional Text and What's New (en and zh-Hans) from .github/RELEASE_NOTES.md, within App Store character limits (Promotional Text 170 chars), and hand them over with the build instead of waiting for the maintainer to ask at the submission form.

Never upload to App Store Connect without explicit maintainer confirmation.
Never commit App Store Connect API keys, certificates, passwords, or local credential paths.
Validate before upload.

Advanced