ai-ready-website
August 3, 2026 · View on GitHub
一份給 Claude Code 用的 skill：從零建出一個自己擁有、能用聊天更新、Google 與 AI 都讀得懂的靜態網站，免費部署到 GitHub Pages。
適合公司形象站、產品服務介紹、案例、內容型網站。全程用聊天完成，不必會寫程式。
五個原則
| 原則 | 意思 |
|---|---|
| AI-Ready | 內容與版型分離，AI 能安全地讀懂、修改 |
| Updatable | 日後用一般說話的方式請 AI 改（加產品、改介紹） |
| Trackable | 串接 Google Search Console 與 Google Analytics |
| Rankable | 內建 sitemap、robots、JSON-LD、乾淨的標題與描述 |
| Human-Owned | 帳號、網址、原始檔全部在你自己名下，隨時可轉移 |
安裝
# 個人層級
git clone https://github.com/yao-care/ai-ready-website.git ~/.claude/skills/ai-ready-website
# 或專案層級
git clone https://github.com/yao-care/ai-ready-website.git .claude/skills/ai-ready-website
放好後在 Claude Code 裡輸入 /ai-ready-website，或直接說「用 ai-ready-website 這個 skill 幫我建站」。
需要準備
- Claude Code 與 Node.js（≥ 22.12）
- 一個 GitHub 帳號（免費即可，Pages 對公開 repo 免費）
- 一個自己的網域（可選，沒有就先用 GitHub 提供的網址）
- 公司現有資料：簡介、產品或服務、案例、圖片、聯絡方式
完整步驟寫在 SKILL.md。
內容物
| 檔案 | 用途 |
|---|---|
| SKILL.md | 給 Claude Code 執行的建站流程 |
| scripts/check-design.mjs | 設計規範守門：擋 px 字級、token 外硬編顏色、!important、外部 CDN |
| scripts/check-copy.mjs | 中文 AI 腔守門：擋破折號夾註、八股連接詞、浮誇詞、emoji、全形數字 |
| reference/variables.css | 設計 token 範本（oklch＋hex fallback，字級最小 18px） |
| reference/content.config.ts | 內容集 schema 範本 |
| reference/seo.ts | JSON-LD 產生器範本 |
| reference/astro.config.mjs | sitemap 設定，含逐頁 lastmod 的作法與理由 |
| reference/deploy.yml | GitHub Pages 部署 workflow，含部署後逐頁驗證 |
為什麼要有守門
讓 AI 一直改網站，改久了會漂移：樣式各寫各的，文案愈寫愈像機器寫的。人不會每次都抓到，所以把它變成 build 會失敗的規則。兩支腳本複製進專案、package.json 的 build 前面串上去就生效。
它們只擋得住固定樣式。語感層的 AI 腔（一句硬塞三件事、名詞化繞路）正則寫不完，那一層要靠另一雙眼睛，細節寫在 SKILL.md。
誠實提醒
這套做法能提高被搜尋與被 AI 引用的機會，但不保證 Google 排名、不保證被 AI 推薦、不保證帶來訂單。它的價值是把資料整理清楚、持續更新、讓機器容易理解。
免費網站空間由第三方提供，政策可能調整。因為原始檔和網域都在你手上，隨時可以搬走。
English
A Claude Code skill for building a static site you actually own. Content lives in Markdown, so the site can be updated by chatting with an AI rather than through a CMS. It ships with sitemap (including real per-page lastmod), robots.txt and JSON-LD for search and AI answer engines, and deploys free on GitHub Pages under your own account and domain.
It also ships two build-time linters, which is the part most website scaffolds leave out: one fails the build on design-system violations (hard-coded colours, px font sizes, !important, external CDNs), the other on formulaic AI-sounding Chinese copy. Both are regex-based and only catch fixed patterns; the limits are documented rather than glossed over.
Written in Traditional Chinese. Full instructions in SKILL.md.
授權
MIT，見 LICENSE。歡迎自用、改寫、拿去接案。
這份 skill 是 arthurs.tw 建站流程的公開通用版，由藥提醒科技有限公司維護。