重點 #9 · Configure Your Environment
官方建議:花一次時間配置好環境,所有後續 session 都自動受惠。八個官方推薦的擴充點,從上到下堆起來。
= 配置好的 Agent
env × discipline
❌ 開箱即用
✅ 配置完整
任務:在電商加「使用者追蹤功能」(新 API + UI + 測試 + 部署)
❌ 沒配置環境
$ 加 follow 功能,要:
- 用 TypeScript,禁止 any
- 命名要 camelCase
- 寫完跑 npm test
- 用 conventional commit
- 不要動 src/legacy
- 不要碰 .env
- 加完要 lint
- 加 unit test 跟 e2e test
- PR 不要超過 300 行
... (再 50 條)
⚠️ AI 寫到後面忘記前面規則
⚠️ 你下次又要重貼一次
⚠️ 新人加入要學「咒語」
✅ 配置完整
$ 加 follow 功能
# 就這樣,10 個字
背後環境自動處理:
📜 CLAUDE.md → coding style / commit / 禁忌
🪝 PreToolUse hook → 阻擋 .env / legacy
🪝 PostToolUse hook → 自動跑 lint + test
🛡️ permissions → 危險指令需確認
⚙️ husky → commit 訊息格式自動檢查
✓ 寫完自動 lint + test,錯了它自己 retry
✓ 規則永久在環境裡,新人 clone 就有
# 一句話心法
花一次時間配置環境 — 之後每個 session 都自動受惠