VSCode Codex 擴(kuò)展：日常對(duì)話(huà)、讀取文件、修改代碼
VSCode 命令面板：添加選中代碼、添加當(dāng)前文件、實(shí)現(xiàn) TODO
VSCode 終端：安裝、檢查版本、執(zhí)行一次性命令
AGENTS.md：項(xiàng)目長(zhǎng)期規(guī)則
.agents/skills：專(zhuān)項(xiàng)能力包
.codex/agents：自定義 Agent
.codex/config.toml：Codex 配置

打開(kāi) VSCode 項(xiàng)目
→ 打開(kāi) Codex 側(cè)邊欄
→ 讓 Codex 讀取 AGENTS.md
→ 選中文件或代碼加入上下文
→ 使用 Skill 或 Agent 完成專(zhuān)項(xiàng)任務(wù)
→ 查看 diff
→ 測(cè)試項(xiàng)目

Extensions
→ 搜索 Codex
→ 安裝 OpenAI Codex 擴(kuò)展

Ctrl + Shift + P
→ 輸入 Extensions: Install Extensions
→ 搜索 Codex

File
→ Open Folder
→ 選擇項(xiàng)目根目錄

D:\ai\test

請(qǐng)只讀分析當(dāng)前項(xiàng)目，不要修改任何文件。
請(qǐng)說(shuō)明：
1. 后端入口在哪里
2. 前端入口在哪里
3. 數(shù)據(jù)庫(kù)相關(guān)代碼在哪里
4. 啟動(dòng)命令是什么
5. 當(dāng)前項(xiàng)目可能有哪些風(fēng)險(xiǎn)點(diǎn)

請(qǐng)根據(jù)當(dāng)前項(xiàng)目結(jié)構(gòu)，告訴我如果要修改“任務(wù)恢復(fù)”和“分頁(yè)顯示”，會(huì)涉及哪些文件。
暫時(shí)不要修改。

可以按方案修改。
要求：
1. 只修改必要文件
2. 不要?jiǎng)訜o(wú)關(guān)代碼
3. 不要?jiǎng)h除數(shù)據(jù)
4. 涉及數(shù)據(jù)庫(kù)只給 SQL，不要直接執(zhí)行
5. 修改完成后給出測(cè)試步驟

請(qǐng)總結(jié)本次修改：
1. 修改了哪些文件
2. 每個(gè)文件改了什么
3. 是否涉及數(shù)據(jù)庫(kù) SQL
4. 是否涉及刪除邏輯
5. 后端如何啟動(dòng)
6. 前端如何啟動(dòng)
7. 如何驗(yàn)證功能
8. 如何回滾

npm install -g @openai/codex

codex --version

cd D:\ai\test

codex --sandbox read-only --ask-for-approval on-request

codex --sandbox workspace-write --ask-for-approval on-request

codex exec "分析當(dāng)前項(xiàng)目結(jié)構(gòu)，輸出后端、前端、數(shù)據(jù)庫(kù)、任務(wù)隊(duì)列、目錄監(jiān)聽(tīng)相關(guān)模塊"

codex exec --sandbox read-only "檢查當(dāng)前項(xiàng)目中是否存在 DELETE、TRUNCATE、DROP、shutil.rmtree、os.remove、rmdir /s /q 等危險(xiǎn)操作"

/

項(xiàng)目是什么
技術(shù)棧是什么
啟動(dòng)命令是什么
哪些文件不能隨便改
數(shù)據(jù)庫(kù)修改要注意什么
刪除操作有哪些限制
代碼風(fēng)格是什么
任務(wù)完成后要輸出什么

D:\ai\test\AGENTS.md

C:\Users\你的用戶(hù)名\.codex\AGENTS.md

# AGENTS.md
## 項(xiàng)目背景
這是一個(gè)本地部署的 xxxxx管理系統(tǒng)，用于xxxxxxx。
## 技術(shù)棧
- 后端：FastAPI + Uvicorn
- 前端：前后端分離
- 數(shù)據(jù)庫(kù)：MySQL
- 目錄監(jiān)聽(tīng)：watchdog
## 工作規(guī)則
- 修改代碼前，必須先閱讀項(xiàng)目結(jié)構(gòu)。
- 修改前必須說(shuō)明會(huì)影響哪些文件。
- 修改后必須給出啟動(dòng)命令和測(cè)試步驟。
- 不允許把所有功能堆在一個(gè)頁(yè)面或一個(gè)文件里。
- 不允許把 HTML 寫(xiě)死在 Python 字符串中。
- 不允許默認(rèn)使用 SQLite，數(shù)據(jù)庫(kù)優(yōu)先使用 MySQL。
- 涉及數(shù)據(jù)庫(kù)結(jié)構(gòu)修改時(shí)，必須給出完整 SQL。
- 涉及刪除文件、刪除結(jié)果、清空數(shù)據(jù)庫(kù)時(shí)，必須有二次確認(rèn)、操作日志和回滾說(shuō)明。
## 輸出規(guī)范
- 原圖文件名不能被破壞。
- xxxxx
- xxxxx
- xxxxx
- JSON 輸出需要穩(wěn)定，可供其他系統(tǒng)對(duì)接。
## 完成標(biāo)準(zhǔn)
每次任務(wù)完成后必須說(shuō)明：
1. 修改了哪些文件。
2. 每個(gè)文件修改了什么。
3. 如何啟動(dòng)后端。
4. 如何啟動(dòng)前端。
5. 如何驗(yàn)證功能。
6. 是否涉及數(shù)據(jù)庫(kù) SQL。
7. 是否存在風(fēng)險(xiǎn)和回滾方式。

檢查 YOLO 項(xiàng)目代碼
生成 MySQL 遷移 SQL
檢查危險(xiǎn)刪除邏輯
整理 MQTT 設(shè)備 API 文檔
重構(gòu)前端頁(yè)面
生成測(cè)試步驟

請(qǐng)使用 $code-review 檢查當(dāng)前項(xiàng)目的任務(wù)隊(duì)列和斷點(diǎn)續(xù)掃邏輯。

請(qǐng)使用 $mysql-safe-migration 生成本次數(shù)據(jù)庫(kù)修改 SQL、備份 SQL、回滾 SQL。

請(qǐng)使用 $dangerous-delete-guard 檢查當(dāng)前項(xiàng)目是否存在高風(fēng)險(xiǎn)刪除邏輯。

D:\ai\helmet\.agents\skills\yolo-code-review\SKILL.md

---
name: code-review
description: 當(dāng)任務(wù)涉及 xxxxx管理系統(tǒng)、FastAPI 后端、MySQL、watchdog 監(jiān)聽(tīng)、任務(wù)隊(duì)列、斷點(diǎn)續(xù)掃、分頁(yè)、識(shí)別結(jié)果 JSON 輸出時(shí)使用。
---
#代碼審查 Skill
## 使用場(chǎng)景
當(dāng)用戶(hù)要求檢查或修改以下內(nèi)容時(shí)使用：
- xxxxx管理系統(tǒng)
- FastAPI 后端
- MySQL 數(shù)據(jù)庫(kù)
- watchdog 目錄監(jiān)聽(tīng)
- 任務(wù)隊(duì)列
- 斷點(diǎn)續(xù)掃
- 分頁(yè)
- 輸出結(jié)果
- 識(shí)別結(jié)果 JSON
## 工作流程
1. 先閱讀項(xiàng)目結(jié)構(gòu)，不要直接修改。
2. 找到后端入口、數(shù)據(jù)庫(kù)模型、任務(wù)服務(wù)、監(jiān)聽(tīng)服務(wù)、前端頁(yè)面。
3. 修改前說(shuō)明會(huì)影響哪些文件。
4. 涉及數(shù)據(jù)庫(kù)變更時(shí)給出完整 SQL。
5. 涉及刪除功能時(shí)必須要求二次確認(rèn)、操作日志和回滾方式。
6. 修改完成后給出啟動(dòng)命令、測(cè)試步驟和風(fēng)險(xiǎn)點(diǎn)。
## 禁止事項(xiàng)
- 不允許默認(rèn)清空數(shù)據(jù)庫(kù)。
- 不允許刪除模型權(quán)重文件。
- 不允許把 HTML 寫(xiě)死在 Python 字符串里。
- 不允許只改前端不改后端接口。
- 不允許破壞原始圖片文件名。

D:\ai\test\.agents\skills\mysql-safe-migration\SKILL.md

---
name: mysql-safe-migration
description: 當(dāng)任務(wù)涉及 MySQL 表結(jié)構(gòu)修改、數(shù)據(jù)遷移、清庫(kù)、刪除識(shí)別結(jié)果、DELETE、TRUNCATE、DROP、備份和回滾時(shí)使用。
---
# MySQL 安全遷移 Skill
## 觸發(fā)場(chǎng)景
- 修改 MySQL 表結(jié)構(gòu)
- 新增字段
- 刪除字段
- 清理識(shí)別結(jié)果
- 刪除任務(wù)數(shù)據(jù)
- 批量刪除 JSON 或圖片
- 使用 DELETE / TRUNCATE / DROP
- 生成數(shù)據(jù)庫(kù)升級(jí) SQL
## 工作步驟
1. 先識(shí)別涉及哪些表。
2. 判斷是否會(huì)影響歷史數(shù)據(jù)。
3. 給出備份 SQL。
4. 給出遷移 SQL。
5. 給出回滾 SQL。
6. 給出驗(yàn)證 SQL。
7. 對(duì) DELETE / TRUNCATE / DROP 做高風(fēng)險(xiǎn)提示。
## 輸出格式
必須輸出：
- 涉及表
- 風(fēng)險(xiǎn)等級(jí)
- 執(zhí)行前備份 SQL
- 正式執(zhí)行 SQL
- 回滾 SQL
- 驗(yàn)證 SQL
- 注意事項(xiàng)
## 禁止事項(xiàng)
- 不允許直接清空數(shù)據(jù)庫(kù)。
- 不允許沒(méi)有 WHERE 的 DELETE。
- 不允許沒(méi)有備份方案的 DROP / TRUNCATE。
- 不允許忽略外鍵、索引、歷史數(shù)據(jù)兼容問(wèn)題。

D:\ai\test\.agents\skills\dangerous-delete-guard\SKILL.md

---
name: dangerous-delete-guard
description: 當(dāng)任務(wù)涉及刪除文件、刪除目錄、刪除數(shù)據(jù)庫(kù)記錄、清空識(shí)別結(jié)果、shutil.rmtree、os.remove、rm、rmdir、DELETE、TRUNCATE、DROP 時(shí)使用。
---
# 危險(xiǎn)刪除保護(hù) Skill
## 檢查范圍
需要重點(diǎn)檢查：
- Python: os.remove
- Python: os.unlink
- Python: shutil.rmtree
- Shell: rm -rf
- Windows: rmdir /s /q
- SQL: DELETE
- SQL: TRUNCATE
- SQL: DROP
- 前端批量刪除按鈕
- 后端批量刪除接口
## 強(qiáng)制要求
任何刪除功能必須包含：
1. 二次確認(rèn)。
2. 刪除范圍預(yù)覽。
3. 操作日志。
4. 操作人或來(lái)源記錄。
5. 刪除數(shù)量統(tǒng)計(jì)。
6. 異?；貪L或失敗記錄。
7. 不允許刪除模型權(quán)重文件。
8. 不允許誤刪 raw 原始圖片。
## 輸出格式
請(qǐng)輸出：
- 高風(fēng)險(xiǎn)代碼位置
- 風(fēng)險(xiǎn)說(shuō)明
- 可能后果
- 推薦修復(fù)方式
- 是否必須立即修改

project_explorer：只讀分析項(xiàng)目結(jié)構(gòu)
reviewer：專(zhuān)門(mén)做代碼審查
mysql_guardian：專(zhuān)門(mén)檢查數(shù)據(jù)庫(kù)風(fēng)險(xiǎn)

D:\ai\test\.codex\agents\project-explorer.toml

name = "project_explorer"
description = "只讀項(xiàng)目結(jié)構(gòu)分析 Agent，用于在修改代碼前梳理目錄、模塊、調(diào)用鏈和風(fēng)險(xiǎn)點(diǎn)。"
model_reasoning_effort = "medium"
sandbox_mode = "read-only"
developer_instructions = """
你是只讀項(xiàng)目探索 Agent。
你的任務(wù)：
1. 閱讀項(xiàng)目結(jié)構(gòu)。
2. 定位后端入口。
3. 定位前端入口。
4. 定位數(shù)據(jù)庫(kù)模型。
5. 定位任務(wù)隊(duì)列和目錄監(jiān)聽(tīng)邏輯。
6. 輸出風(fēng)險(xiǎn)點(diǎn)和下一步建議。
禁止修改任何文件。
"""

D:\ai\test\.codex\agents\reviewer.toml

name = "reviewer"
description = "代碼審查 Agent，重點(diǎn)檢查正確性、安全風(fēng)險(xiǎn)、測(cè)試缺失和可維護(hù)性。"
model_reasoning_effort = "high"
sandbox_mode = "read-only"
developer_instructions = """
你是嚴(yán)格的代碼審查 Agent。
重點(diǎn)檢查：
1. 邏輯錯(cuò)誤
2. 安全問(wèn)題
3. 數(shù)據(jù)庫(kù)風(fēng)險(xiǎn)
4. 刪除操作風(fēng)險(xiǎn)
5. 并發(fā)問(wèn)題
6. 測(cè)試缺失
7. 可維護(hù)性問(wèn)題
不要修改代碼，只輸出審查結(jié)果。
每個(gè)問(wèn)題必須包含：
- 問(wèn)題位置
- 風(fēng)險(xiǎn)說(shuō)明
- 修改建議
- 是否必須修復(fù)
"""

D:\ai\test\.codex\agents\mysql-guardian.toml

name = "mysql_guardian"
description = "MySQL 數(shù)據(jù)庫(kù)安全 Agent，用于檢查表結(jié)構(gòu)修改、DELETE、TRUNCATE、DROP、清庫(kù)、遷移和回滾風(fēng)險(xiǎn)。"
model_reasoning_effort = "high"
sandbox_mode = "read-only"
developer_instructions = """
你是 MySQL 數(shù)據(jù)庫(kù)安全 Agent。
重點(diǎn)檢查：
1. 是否存在 DROP / TRUNCATE / DELETE 無(wú)條件執(zhí)行
2. 是否缺少事務(wù)
3. 是否缺少備份方案
4. 是否缺少回滾 SQL
5. 是否影響歷史識(shí)別結(jié)果
6. 是否存在連接池耗盡風(fēng)險(xiǎn)
7. 是否存在字段兼容問(wèn)題
不要直接執(zhí)行數(shù)據(jù)庫(kù)命令。
輸出必須包含：
- 風(fēng)險(xiǎn)等級(jí)
- 涉及表
- 涉及 SQL
- 修復(fù)建議
- 備份方案
- 回滾方案
"""

請(qǐng)啟動(dòng) 3 個(gè) subagents 并行分析當(dāng)前項(xiàng)目：
1. project_explorer：分析項(xiàng)目結(jié)構(gòu)、入口文件和調(diào)用鏈。
2. reviewer：檢查代碼質(zhì)量、安全風(fēng)險(xiǎn)和測(cè)試缺失。
3. mysql_guardian：檢查 MySQL 表結(jié)構(gòu)、刪除邏輯和遷移風(fēng)險(xiǎn)。
要求：
- 不要修改文件。
- 每個(gè) Agent 單獨(dú)輸出發(fā)現(xiàn)。
- 最后由主 Agent 匯總成一份修改優(yōu)先級(jí)清單。

大項(xiàng)目整體審查
前后端同時(shí)修改前的風(fēng)險(xiǎn)分析
數(shù)據(jù)庫(kù)遷移前檢查
刪除功能上線(xiàn)前檢查
任務(wù)隊(duì)列和并發(fā)問(wèn)題排查

C:\Users\你的用戶(hù)名\.codex\config.toml

D:\ai\test\.codex\config.toml

approval_policy = "on-request"
sandbox_mode = "workspace-write"

[agents]
max_threads = 4
max_depth = 1

[profiles.readonly]
approval_policy = "on-request"
sandbox_mode = "read-only"

[profiles.dev]
approval_policy = "on-request"
sandbox_mode = "workspace-write"

[profiles.strict]
approval_policy = "untrusted"
sandbox_mode = "read-only"

codex --profile readonly

codex --profile dev

請(qǐng)讀取 AGENTS.md，并只讀分析當(dāng)前項(xiàng)目結(jié)構(gòu)。
不要修改任何文件。
請(qǐng)告訴我：
1. 項(xiàng)目整體結(jié)構(gòu)
2. 后端入口
3. 前端入口
4. 數(shù)據(jù)庫(kù)相關(guān)文件
5. 任務(wù)隊(duì)列相關(guān)文件
6. 目錄監(jiān)聽(tīng)相關(guān)文件
7. 當(dāng)前項(xiàng)目主要風(fēng)險(xiǎn)點(diǎn)

請(qǐng)給出修改方案。
要求說(shuō)明：
1. 要修改哪些文件
2. 每個(gè)文件為什么要修改
3. 是否涉及數(shù)據(jù)庫(kù)
4. 是否涉及刪除操作
5. 風(fēng)險(xiǎn)點(diǎn)是什么
6. 如何驗(yàn)證
暫時(shí)不要修改。

請(qǐng)使用 $code-review 檢查當(dāng)前項(xiàng)目的任務(wù)隊(duì)列、watchdog 監(jiān)聽(tīng)、斷點(diǎn)續(xù)掃和分頁(yè)邏輯。
先給出問(wèn)題清單和修改方案，不要直接修改。

請(qǐng)使用 $dangerous-delete-guard 檢查當(dāng)前項(xiàng)目中所有刪除相關(guān)邏輯。
重點(diǎn)搜索：
- os.remove
- os.unlink
- shutil.rmtree
- rm -rf
- rmdir /s /q
- DELETE
- TRUNCATE
- DROP
- 批量刪除接口
- 前端刪除按鈕
不要修改文件，只輸出風(fēng)險(xiǎn)清單和修復(fù)建議。

請(qǐng)使用 $mysql-safe-migration 分析這次數(shù)據(jù)庫(kù)修改需求。
要求輸出：
1. 涉及表
2. 備份 SQL
3. 修改 SQL
4. 回滾 SQL
5. 驗(yàn)證 SQL
6. 風(fēng)險(xiǎn)說(shuō)明
不要直接執(zhí)行 SQL。

請(qǐng)啟動(dòng) 3 個(gè) subagents 并行審查當(dāng)前項(xiàng)目：
1. project_explorer：只讀分析項(xiàng)目結(jié)構(gòu)和調(diào)用鏈。
2. reviewer：檢查代碼正確性、安全性和測(cè)試缺失。
3. mysql_guardian：檢查數(shù)據(jù)庫(kù)結(jié)構(gòu)、刪除邏輯和遷移風(fēng)險(xiǎn)。
要求：
- 不要直接修改代碼。
- 每個(gè) Agent 單獨(dú)輸出發(fā)現(xiàn)。
- 最后由主 Agent 匯總成一份修改優(yōu)先級(jí)清單。

請(qǐng)總結(jié)本次修改：
1. 修改了哪些文件
2. 每個(gè)文件修改了什么
3. 是否涉及數(shù)據(jù)庫(kù)
4. 是否涉及刪除操作
5. 如何啟動(dòng)后端
6. 如何啟動(dòng)前端
7. 如何驗(yàn)證功能
8. 如何回滾

幫我把整個(gè)項(xiàng)目?jī)?yōu)化一下。

請(qǐng)先只讀分析當(dāng)前項(xiàng)目結(jié)構(gòu)，不要修改文件。
然后告訴我如果要優(yōu)化任務(wù)恢復(fù)邏輯，需要改哪些文件。

涉及數(shù)據(jù)庫(kù)的部分只給 SQL，不要直接執(zhí)行。
請(qǐng)同時(shí)給出備份 SQL、修改 SQL、回滾 SQL 和驗(yàn)證 SQL。

涉及刪除文件、刪除結(jié)果、清空數(shù)據(jù)庫(kù)的功能，必須有二次確認(rèn)、刪除范圍預(yù)覽、操作日志和回滾說(shuō)明。

/compact