Files
awoooi/CLAUDE.md
OG T 88ac1c7f50
Some checks failed
CD Pipeline / build-and-deploy (push) Failing after 1m44s
feat(phase27): 歷史按鈕雙層頻率統計 + DB frequency_snapshot 持久化
- telegram_gateway: _send_incident_history 改為 Phase 27 雙層策略
  Layer 1: DB frequency_snapshot (建立時刻永久快照)
  Layer 2: Redis AnomalyCounter disposition 累積統計 (35d TTL)
  修復舊版呼叫 record_anomaly() 導致誤計數的 bug
- 新增 migration: phase27_incident_frequency_snapshot.sql (已在 prod 執行)
- CLAUDE.md: 精簡至 123 行,減少 Token 消耗

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-10 01:06:51 +08:00

4.7 KiB
Raw Blame History

AWOOOI Project Configuration

Claude Code 自動載入,定義核心原則


⚠️ Session 啟動第一步

在做任何事之前,先讀:

  1. MEMORY.md — 記憶索引
  2. docs/LOGBOOK.md — 最新進度
  3. docs/HARD_RULES.md — 絕對禁止規則
  4. 涉及主題的 feedback_*.md

🔴🔴 檢查 project_current_status.md 最後更新日期 — 超過 2 天 → 先執行 Memory 清理再開工


四大核心原則

  1. 變更前 → 先讀註解 (理解設計意圖再動手) 🔴
  2. 不可逆操作 → 人工確認 (刪除、logOut、DROP、force push)
  3. 有疑問 → 先問統帥 (不確定就停下來)
  4. 任務完成 → 更新 Memory (不等被問)

🔴 絕對禁止 → HARD_RULES.md

🔴 紅區治理 → RED_ZONES.md

Tier 3 核心檔案 (decision_manager, trust_engine, config 等) 修改需首席架構師授權


專案架構

  • apps/api/ — FastAPI 後端
  • apps/web/ — Next.js 前端
  • k8s/ — Kubernetes 配置

🔴 Gitea CI/CD (ADR-039) → reference_gitea_mirror.md

從 2026-03-29 起,所有 CI/CD 從 Gitea 執行。推版:git push gitea main。GitHub 只讀備份。


🛑 修改前必讀 → HARD_RULES.md

檔案/功能 必讀章節
.github/workflows/* GitHub Billing
*telegram* Telegram Token
apps/web/** i18n
Incident/Approval 流程 Telegram + DB 鏈路
Alertmanager/NetworkPolicy 🔴🔴 ADR-025 告警鏈路 E2E
AI Provider 路由/Fallback 🔴🔴 Phase 24 AI Router

任務前必讀 Memory

主題 Memory
🔴🔴 定期清理 feedback_memory_cleanup_schedule.md
🔴🔴🔴 費用變更 feedback_cost_change_approval.md
變更前必讀 🔴 feedback_read_comments_first.md
變更註解 🔴🔴 feedback_change_annotation_standard.md
重大變更 feedback_product_survival_principles.md
Telegram feedback_telegram_token_disaster.md
OpenClaw feedback_architecture_openclaw_core.md
命名規範 feedback_openclaw_naming.md
i18n feedback_i18n_zero_hardcode.md
防禦性工程 feedback_defensive_engineering.md
積木化強制 🔴🔴 feedback_lewooogo_modular_enforcement.md
API 整合 feedback_api_response_verification.md
構建部署 feedback_build_from_git_only.md
測試 🔴🔴 feedback_no_mock_testing.md
API 路徑 🔴 feedback_api_path_naming.md
部署驗證 🔴🔴 feedback_deployment_verification.md
部署層級 🔴🔴🔴 feedback_deployment_layer_decision.md
告警鏈路 🔴🔴🔴 feedback_alertchain_e2e_validation.md
Telegram Secrets 🔴🔴🔴 feedback_telegram_secrets_injection.md
前端內網禁令 🔴🔴🔴 feedback_frontend_internal_ip_ban.md
AI Router 重構 🔴🔴 project_phase24_ai_router.md
AI Fallback 順序 🔴 feedback_ai_fallback_order.md
前端 Icon 規範 🔴 feedback_no_emoji_use_icons.md
設計稿預覽 🔴 feedback_ui_collaboration_protocol.md

重要規則摘要(詳情在 Memory

  • 前端內網 IP 禁令 🔴🔴🔴NEXT_PUBLIC_* 禁用內網 IP用公網域名build-time 寫死進 JS Bundle
  • Telegram 告警鏈路 🔴🔴🔴 — CD 必須自動注入 K8s Secrets禁止 CHANGE_ME部署後 E2E 驗證 → ADR-035
  • leWOOOgo 積木化 🔴🔴 — 修改 apps/api/ 前必問 5 題Router 層禁止直接存取 Redis/DB
  • Phase 24 AI Router — ADR-052 完成Router 只依賴 Protocol絞殺者開關 USE_AI_ROUTER

Skills 載入

任務類型 Skill 路徑
前端 .agents/skills/01-awoooi-frontend-aesthetics.md
後端 .agents/skills/02-lewooogo-backend-core.md
AI/決策 .agents/skills/03-openclaw-cognitive-expert.md
DevOps .agents/skills/04-awoooi-devops-commander.md
測試 .agents/skills/05-awoooi-sre-qa.md
Git .agents/skills/06-awoooi-monorepo-master.md
Tool 整合 .agents/skills/07-tool-integration-expert.md
模型路由 .agents/skills/08-model-router-expert.md
絞殺者重構 .agents/skills/09-strangler-pattern-expert.md

Memory 系統

Session 結束前

更新相關 Memory → 更新 LOGBOOK → 標記下一步