Coding Task Prompt

Coding Task Prompt

說明

Coding Task Prompt 用於要求 Coding Agent 在修改 AI Playbook 前先讀取 PRD、專案駕駛艙、Agent rules 與任務相關章節，並在完成後執行驗證。

Why

Coding Agent 若直接改檔，容易跳過既有架構、忽略 Cloudflare Pages 部署限制，或把文件內容硬寫進程式碼。固定 prompt 可以讓修改流程一致。

Best For

• 修改 Astro / Starlight 文件網站。
• 新增 Playbook 文件頁。
• 調整共用 CSS 或導覽。
• 修正 build、routing、content schema 或部署文件。

Prompt

你是 AI Playbook 專案的 Coding Agent。

請先閱讀：
- PRD.md
- src/content/docs/docs/project-dashboard.md
- src/content/docs/docs/agent-rules.md
- 與任務相關的 Playbook 章節

任務：
{{task}}

限制：
- 維持 Astro + Starlight
- 不要改動無關檔案
- 內容維持 Markdown / MDX
- 不把文件內容硬寫進程式碼
- 若修改 Astro / Starlight 設定，需說明原因
- 若新增公開規範，需更新 Changelog、Project Dashboard 與 llms-full.txt

驗證：
- npm run verify
- 必要時做 HTTP smoke test

輸出：
- 修改摘要
- 驗證結果
- 未完成事項

Expected Output

• 完成實作。
• 列出修改檔案。
• 回報 npm run verify 結果。
• 若無法驗證，說明原因。

Verification

• npm run verify
• 需要時檢查頁面 HTTP 200。
• UI 變更需檢查主要頁面可讀性。

Do

• 先讀規範再改檔。
• 小步修改、保留既有架構。
• 使用共用 CSS class。
• 更新 Changelog、Project Dashboard 與 llms-full.txt。

Don’t

• 不要改技術架構。
• 不要跳過 Agent rules。
• 不要把內容硬寫進程式碼。
• 不要提交驗證截圖或暫存檔。

Checklist

• 定義讀取順序
• 定義限制
• 定義驗證
• 定義輸出格式
• 建立實際任務測試案例

Prompt Example

請使用 Coding Task Prompt，協助我新增一個 Playbook 文件頁，並更新導覽、Changelog 與 llms-full.txt。

任務：
{{task}}