@topy-ai/maggie（繁體中文）

English README · 完整繁體中文 README

@topy-ai/maggie 提供 19 個可安裝的 AI website workflow skills，支援 Codex、Claude Code 與相容的 coding agents。

安裝

npx @topy-ai/[email protected] init --agent all
npx @topy-ai/maggie doctor --project .

常用流程：

python3 tools/clis/maggie.py analyze . --json --save
python3 tools/clis/maggie.py bootstrap interview .
maggie memory context --project . --skill <skill-name>
maggie doctor --project . --require-bootstrap --strict

主要 skills 包括 clone、design、template、Blog、SEO/GEO、localization、 deployment、memory、feedback 和 MaggieDash。內容先 draft/review，外部寫入、 publish 與 production deployment 需要明確確認。

0.7.18 加入 staged/untracked changed-surface release gate、QA run 與 release 整合、market/locale-aware service variant route、provider capability matrix fixture evidence，以及 feedback fixed-proof/path privacy gate。0.7.16 補強 review gate 的 CI exit code 與 IndexNow retry regression； 0.7.15 也加入 API schema contract、blog review gate、sitemap freshness warning、change-driven IndexNow 與 page-kind/source-coverage inventory。

MaggieDash 也提供穩定 section identity、可重用 section arrangement、機器可讀 section registry、短期 agent content bridge，以及 translation out-of-band write 後的 restart gate。maggie doctor 會比較 install manifest 與磁碟上的實際 skills。

新版 release gates：

maggie design icon-inventory --project . --source-dir src \
  --runtime public/assets/icons.css --output docs/icon-inventory.json

maggie deployment canary --project . \
  --asset https://example.com/assets/app.js=<sha256> \
  --render-report .maggie/rendered-canary.json \
  --output docs/deployment-canary.json

# MaggieDash section/page quality contracts
maggie dash sections fanout-validate --registry templates/maggiedash/section-registry.json \
  --fanout-file templates/maggiedash/section-fanout.json
maggie dash sections variant-copy-validate --pages-file .maggie/variant-pages.json
maggie dash sections media-validate --pages-file .maggie/variant-pages.json --across-siblings
maggie dash inventory --pages-file .maggie/published-pages.json

# Migration target identity (never prints or stores a database URL)
maggie migration identity --identity-file .maggie/db-identity.json \
  --expected-file .maggie/service-db-identity.json

# Scenario browser QA
maggie qa start --project . --scenario-file .maggie/scenario-manifest.json \
  --environment local --base-url http://localhost:4321
maggie qa summary --project . --run <run-id>

# Provider variant capability matrix
maggie service capability-audit --project . \
  --catalogue .maggie/booking/services.json \
  --capabilities-file .maggie/booking/provider-capabilities.json \
  --fixture .maggie/booking/fixtures/provider.json

完整中文說明、19 個 skills 清單和 roadmap： 繁體中文 README · Roadmap