AI Playbook

Human + AI Agent Source of Truth

AI Playbook 是 AI 專案開工前的共同工作手冊。

這裡不是 Blog、作品集或行銷網站，而是讓人類、Coding Agent、Design Agent、Content Agent 在同一套規範下開始工作的知識中心。

AI Agent

讀取公開入口

先讀取 `/llms.txt`，取得網站用途、source of truth、工作規則與主要章節入口。

讀取 /llms.txt

Coding Agent

先讀 PRD 與專案狀態

修改網站前，先讀本機 `PRD.md` 與線上專案駕駛艙，確認架構、限制、風險與最近決策。

讀取 PRD.md 讀取專案駕駛艙

Human

從 Start Here 開始

如果你是第一次進來，先看這份首頁，再依任務進入 Brand、Design System、Prompt、Workflow 或 Layouts。

從 Start Here 開始

說明

AI Playbook 是一個給人類與 AI Agent 共同閱讀的知識中心。它提供 AI 專案開工前需要先理解的產品定位、技術決策、品牌規範、Prompt、Workflow、Layout 與修改規則。

網站第一版維持 Astro + Starlight，內容使用 Markdown / MDX 維護，目標是可維護、可搜尋、可被 AI 解析，也能讓人類快速掃讀。

Why

AI Agent 在開始開發、設計、產文或 Review 前，需要一個穩定、可搜尋、可追溯的規範來源，避免每次都依賴零散對話或隱性偏好。

人類也需要一個清楚入口，知道哪些內容是品牌規範、哪些是技術決策、哪些是可複製的 Prompt 或教學模板。

Start Here

AI Agent

先讀 `/llms.txt`；需要完整公開上下文時，再讀 `/llms-full.txt`。

Coding Agent

先讀本機 `PRD.md`、`src/content/docs/docs/project-dashboard.md` 與 `/docs/agent-rules/`。

Human

先看專案駕駛艙了解目前狀態，再依任務進入 Brand、Design、Prompt、Workflow 或 Layouts。

Do

• 先閱讀 Getting Started、專案駕駛艙與相關章節。
• AI Agent 修改前先讀 /docs/agent-rules/。
• Coding Agent 修改前先讀 PRD.md 與 src/content/docs/docs/project-dashboard.md。
• 依章節邊界修改文件。
• 使用 Markdown 或 MDX 維護內容。
• 保持文件結構清楚、可搜尋、容易被 AI 解析。

Don’t

• 不要把 Playbook 內容硬寫在程式碼裡。
• 不要把這裡寫成行銷網站、Blog 或作品集。
• 不要用過度動畫或視覺特效取代資訊架構。
• 不要在沒有閱讀 PRD、專案駕駛艙與 Agent rules 前修改架構。
• 不要把私密資料、token、API key 或未公開素材寫進公開文件。

Checklist

• 確認本站用途
• 選擇 AI Agent / Coding Agent / Human 入口
• 閱讀專案目標
• 確認要修改的章節
• 使用七區塊格式撰寫文件
• 完成後更新 Changelog

Prompt Example

請先閱讀 AI Playbook 首頁、/llms.txt、/docs/agent-rules/ 與專案駕駛艙，再依照文件規範協助我完成這次任務。

任務：
{{task}}

請輸出：
- 會先讀哪些文件
- 會修改哪些章節
- 會如何驗證
- 是否需要更新 Changelog