AgentSkillsCN

shipany-quick-start

根据简短的项目概要(应用名称、域名/应用URL、产品描述/功能、参考链接以及品牌偏好),自动完成新ShipAny(ShipAny Two)项目的首次定制化配置。当用户表示即将启动新项目时,可使用此技能。

SKILL.md
--- frontmatter
name: shipany-quick-start
description: Automate first-pass customization of a new ShipAny (ShipAny Two) project from a short project brief (app name, domain/app URL, product description/features, reference links, and branding preferences). Use when the user says they are starting a new project.

ShipAny Quick Start (Project Bootstrap)

This skill is intentionally split into small reference modules. Load only the module(s) you need.

v1 edit scope (hard limit)

For the first pass, only modify the files listed in references/09-checklist.md.

  • Do not change any other files (no routing, no components, no templates, no extra locale message files).
  • Do not introduce login/auth/payment features unless explicitly requested.

Dev workflow (required)

  • Before starting edits: run pnpm install (once) to ensure dependencies are installed.
  • After finishing all edits: clear Next.js cache before validation, otherwise you may see stale assets (e.g. old logo.png):
    • macOS/Linux: rm -rf .next
    • Windows (PowerShell): Remove-Item -Recurse -Force .next
    • Windows (cmd): rmdir /s /q .next
  • Then run pnpm build to validate the project (build + lint checks). If it fails, fix issues only within the v1 allowlist unless the user expands scope.

Project brief

Normalize the user’s request first:

  • references/00-project-brief.md

Execution order (ShipAny Two)

  1. App basics (env-driven): references/01-env-app-info.md
  2. SEO metadata: references/02-seo-metadata.md
  3. Landing page (EN/ZH): references/03-landing-page.md
    • Page sections live in src/config/locale/messages/{locale}/pages/index.json
    • Header/footer/nav live in src/config/locale/messages/{locale}/landing.json
  4. Theme styles: references/04-theme-styles.md
  5. Logo + favicon: references/05-logo-favicon.md
  6. Sitemap: references/06-sitemap.md
  7. Legal pages: references/07-legal-pages.md
  8. Images (extract from links or use Picsum placeholders): references/08-images.md
  9. Minimal checklist: references/09-checklist.md

Bundled script

  • scripts/fetch_og_image.py: Best-effort OG/Twitter preview image downloader for a reference link.