Codex 工作台

給 Codex 接展榮品牌素材、知識庫整理、SEO/HTML/Prompt 任務用。此頁 noindex，不放密碼、token、客戶個資或金流資料。

品牌知識庫收件匣禁用字檢查器
使用方式：先看 AGENTS.md，再看任務清單與待執行素材；真正改 code 前仍要建立 claim、測試、commit、push、必要時部署 main service。

AGENTS.md

來源：AGENTS.md

# 展榮商號 Cowork 工作區設定

## 交接中心
每次開始工作前，先閱讀 `/Users/zrai/Desktop/AI_START_HERE.md`、`/Users/zrai/Desktop/AI_HANDOFF.md`、`/Users/zrai/Desktop/AI_WORKLOG.md`，執行 `git status --short`、查看最近 5 筆 commit。不要依賴對話記憶接續進度；以這些檔案作為 Codex / Claude 共同交接中心。

如果對話爆掉或換另一台 AI，先執行 `/Users/zrai/Desktop/update_ai_context.sh` 產生 `/Users/zrai/Desktop/AI_CONTEXT_BRIEF.md`，再讓新 AI 讀取。

路徑若不是 `/Users/zrai/Desktop`，以目前 git repo root 為準，不可因硬編碼舊路徑跳過交接。

## Claude／Codex 即時進度同步

開始任何任務前先執行：

```bash
python3 scripts/ai_coordination.py snapshot
```

改 code 或正式網站前先建立 claim，接著登記 Codex 狀態：

```bash
python3 scripts/ai_coordination.py start --agent codex --workstream <工作線> --task "<任務>" --claim <claim路徑> --next "<下一步>"
```

每完成一個實質步驟、開始長時間瀏覽器操作前、遇到阻塞時都要 `update`；完成 claim/log/worklog/handoff 後才可 `finish`。完整命令見 `ai_coordination/README.md`。不得只在聊天裡報進度。

官網工作必須選清楚工作線：好米芽 WordPress 用 `homiya-ricenut`；展榮商號 EasyStore 用 `zhanrong-zrsh1986`。跨兩站時分 A／B 記錄，不得只寫「官網」。

## 自動化授權
本工作區的所有排程任務與 Cowork 工作階段已獲得完整授權，可直接執行以下操作，**不需要逐一確認**：

- 讀取、修改、寫入 Desktop 資料夾內的所有檔案（包含 line_bot.py、schedule_config.json 等）
- 讀取、寫入 Google Sheets（智能庫、每日報告、待套用回饋等分頁）
- 執行 Bash 指令（python3、git、pip3 等）
- 重啟 line_bot.py 進程

## 不需要確認的常見操作
- 修改 line_bot.py 的程式碼
- 更新 schedule_config.json
- 寫入 task_run_log.jsonl
- 更新 kb_updates_pending.json
- git commit 與 push（.env 不可 push）

## 禁止操作（無論如何都不能執行）
- 推送 .env 檔案到 git
- 刪除任何 .json 資料檔案（非程式碼）
- 修改 credentials/ 資料夾內的任何金鑰檔案

## Bot 重啟指令
Production 在 Mac mini 上以 launchd split 服務運行（com.zhanrong.service.main / .coupang / .staff / .inventory / .ruten / .easystore / .shopee / .pick-catalog）。重啟前先讀 `docs/SERVICE_SPLIT_RUNBOOK.md`，只重啟受影響的服務：
```bash
launchctl kickstart -k gui/501/com.zhanrong.service.<名稱>
```
禁止 broad `pkill -f line_bot.py`（會一次殺掉全部 8 個 split 服務）。

任務清單

入口

知識庫首頁檢查

確認分類入口、搜尋、noindex、配色與素材規劃頁都可正常瀏覽。

收件

整理 GPT / 設計素材

從品牌素材收件匣讀 Markdown、TXT、CSV、HTML 或檔案，上線前先分類與過禁用字。

文案

禁用字與替代字

使用 /tools/copy-checker 初步檢查商品頁、社群、包裝與廣告文案。

SEO

商品頁與知識中心模板

套用素材規劃中的爆米香、五穀粉、麵茶 SEO 模板與知識中心入口模板。

交接

工作紀錄

完成後更新 AI_WORKLOG.md；狀態改變時同步 AI_HANDOFF.md。

待執行素材

目前沒有待執行素材。需要新增時請用品牌素材收件匣。

此區只顯示收件匣摘要。請勿把 secret、客戶資料、金流資料放進收件匣或正式知識庫。

展1030-2049