106 lines
3.0 KiB
Markdown
106 lines
3.0 KiB
Markdown
# AWOOOI Project Configuration
|
||
|
||
> Claude Code 自動載入，定義核心原則
|
||
|
||
---
|
||
|
||
## 🚨🚨🚨 強制提醒 (每小時自我檢查)
|
||
|
||
**你有確實執行以下動作嗎？沒有就立刻執行！**
|
||
|
||
```
|
||
□ 讀過 MEMORY.md 索引？
|
||
□ 讀過 docs/LOGBOOK.md 最新進度？
|
||
□ 讀過 docs/HARD_RULES.md 絕對禁止規則？
|
||
□ 涉及特定主題時，讀過對應 feedback_*.md？
|
||
```
|
||
|
||
**違反後果**: 重複犯錯、統帥需要反覆提醒、信任度下降
|
||
|
||
---
|
||
|
||
## 🔴 絕對禁止 (Hard Rules)
|
||
|
||
**做任何修改前，先讀對應的鐵律文件：**
|
||
|
||
→ [HARD_RULES.md](docs/HARD_RULES.md)
|
||
|
||
---
|
||
|
||
## ⚠️ Session 啟動第一步
|
||
|
||
**在做任何事之前，先讀：**
|
||
1. `MEMORY.md` - 記憶索引
|
||
2. `docs/LOGBOOK.md` - 最新進度
|
||
3. `docs/HARD_RULES.md` - 絕對禁止規則
|
||
4. 涉及主題的 `feedback_*.md`
|
||
|
||
**不要讓統帥說「你讀過 Memory 了嗎？」**
|
||
|
||
---
|
||
|
||
## 三大核心原則
|
||
|
||
1. **不可逆操作 → 人工確認** (刪除、logOut、DROP、force push)
|
||
2. **有疑問 → 先問統帥** (不確定就停下來)
|
||
3. **任務完成 → 更新 Memory** (不等被問)
|
||
|
||
## 專案架構
|
||
|
||
- `apps/api/` - FastAPI 後端
|
||
- `apps/web/` - Next.js 前端
|
||
- `k8s/` - Kubernetes 配置
|
||
|
||
## 🛑 修改前
|
||
|
||
修改以下檔案前，**必須先讀** [HARD_RULES.md](docs/HARD_RULES.md)：
|
||
|
||
- `.github/workflows/*` → GitHub Billing 章節
|
||
- `*telegram*` → Telegram Token 章節
|
||
- `apps/web/**` → i18n 章節
|
||
- Incident/Approval 流程 → 確認 Telegram + DB 鏈路
|
||
|
||
---
|
||
|
||
## 任務前必讀
|
||
|
||
涉及以下主題時，**先讀取對應 Memory**：
|
||
|
||
| 主題 | Memory 路徑 |
|
||
|------|-------------|
|
||
| **重大變更** | `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_modular_architecture.md` |
|
||
| API 整合 | `feedback_api_response_verification.md` |
|
||
| 構建部署 | `feedback_build_from_git_only.md` |
|
||
| **測試** | `feedback_no_mock_testing.md` 🔴🔴 禁止 Mock |
|
||
| **API 路徑** | `feedback_api_path_naming.md` 🔴 修改需同步前端 |
|
||
| **部署驗證** | `feedback_deployment_verification.md` 🔴🔴 必須驗證 Pod 版本 |
|
||
|
||
## 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` |
|
||
|
||
## Memory 系統
|
||
|
||
- 長期記憶：`~/.claude/projects/-Users-ogt-awoooi/memory/`
|
||
- 索引：`MEMORY.md`
|
||
- 進度：`docs/LOGBOOK.md`
|
||
|
||
## Session 協議
|
||
|
||
**啟動時**：讀 MEMORY.md → LOGBOOK.md → 確認當前任務
|
||
|
||
**結束前**：更新相關 Memory → 更新 LOGBOOK → 標記下一步
|