專案設定

每個步驟都使用相關工具的官方 CLI 或文件（技能 official-docs）。在執行任何遠端操作前，請先詢問。

剛建立（CLI 已建立腳手架、安裝並檢查所有項目）

閱讀 PROJECT.md，並與人類一起用他們的語言填寫 What（名稱、網域、類型、用途）。 {{#dotenv}}
人類將 .env.example 複製為 .env 並填入內容{{#auth}}（{{dlx}} auth@latest secret 可產生驗證密鑰）{{/auth}}。代理程式絕不建立、讀取或寫入 .env。在 .env 存在之前，請使用僅為該指令設定的臨時值進行測試。 {{/dotenv}} {{#postgres}}
本地資料庫：docker compose up -d，然後執行 {{run}} db:migrate（先詢問）。 {{/postgres}} {{#d1}}
本地資料庫：{{run}} db:migrate（先詢問）。 {{/d1}}
{{run}} docs:sync，然後填寫 docs/DEPLOYMENT.md（URL、密鑰設定的位置）。 {{#cloudflare}} 在資源建立後（DEPLOYMENT.md → 首次設定），取代 wrangler.jsonc 中的預留 ID。 {{/cloudflare}}
將 design/DESIGN.md 留給 website-design 技能，它會在首個頁面之前依序收集設計輸入；首頁為預留頁面。
一旦儲存庫上線至 GitHub，人類應開啟設定 → Actions → General →「允許 GitHub Actions 建立並核准拉取請求」，以便每週的代理程式技能更新能開啟其拉取請求。Dependabot 和工作流程變更：技能 dependabot 和 github-actions-hardening。
{{run}} log "專案設定完成" --by <agent>。

{{dlx}} create-agent-ready-app@latest install . 僅加入代理程式設定（AGENTS.md、技能、腳本、護欄）；它會從 package.json 偵測附加元件。舊的 AGENTS.md、CLAUDE.md、.cursorrules 和類似檔案會移至 docs/legacy-agents.md：將仍然適用的規則折疊到 PROJECT.md → 代理程式規則中，然後刪除它（請詢問）。
根據現有內容（package.json、路由、快速資料夾列表）填寫 PROJECT.md。不要深入探索。
不要重組結構。將差距（結構、檢查、SEO、安全性）列為一個提議的重大任務並詢問。

提出一個是/否問題：附加元件、它新增的套件、它建立的檔案。
{{dlx}} create-agent-ready-app@latest add <add-on> . 建立該附加元件尚不存在的檔案，重新整理 AGENTS.md 和技能，安裝其技能包，並列印要新增的套件。
{{add}} 那些套件。然後根據 create-agent-ready-app 儲存庫（template/frameworks/）中該附加元件的檔案以及官方文件，將其接入專案已有的檔案中：
- query：{{#tanstack-start}}src/router.tsx（QueryClient + SSR 整合）和 src/routes/__root.tsx（開發工具面板）{{/tanstack-start}}{{#next}}src/shared/lib/tanstack/query-provider.tsx 在 src/app/layout.tsx 中{{/next}}；
- shadcn：{{dlx}} shadcn@latest apply --preset nova，然後 add 你需要的元件；
- auth：{{#tanstack-start}}src/routes/_private/{{/tanstack-start}}{{#next}}src/app/(private)/{{/next}} 下的守衛以及 {{run}} auth:generate，然後 {{run}} db:generate。
{{run}} docs:sync，{{run}} check，更新 PROJECT.md → 技術棧與決策，並新增一筆記錄。

{{dlx}} create-agent-ready-app@latest remove <add-on> . 會移除其工具包檔案、技能、腳本和權限。刪除其程式碼和套件是一個重大任務：使用 rg 搜尋每次使用，刪除它，然後執行 {{run}} check。

.agents/skills/ 中的社群技能來自其創作者（skills-lock.json 記錄每個來源和雜湊值）。{{run}} skills:update 會重新整理它們；提交前請閱讀差異，就像對待任何程式碼變更一樣。
更多技能：優先使用工具創作者的官方技能（https://www.skills.sh/official）；技能 find-skills，或使用 {{dlx}} skills@latest add <owner/repo> --skill <name> -a universal -a claude-code（先詢問）。可選的工具包：{{dlx}} create-agent-ready-app@latest add <pack> .（行銷、安全審查……）。

{{run}} kit:update 會重新整理 AGENTS.md、技能和腳本。在此專案中已變更的工具包檔案會被保留並回報；請將專案特定規則放在 PROJECT.md 中，而不是編輯工具包檔案。