From b2066f5e6db5a1c07ce507a8b16d5b47f88a1d9b Mon Sep 17 00:00:00 2001 From: Jeffery Date: Tue, 16 Jun 2026 15:47:41 +0800 Subject: [PATCH] =?UTF-8?q?docs(README):=20=E5=90=8C=E6=AD=A5=20code-revie?= =?UTF-8?q?w-resolve=20=E7=9A=84=20commit=20=E7=AF=84=E5=9C=8D=E8=A6=8F?= =?UTF-8?q?=E5=89=87=E7=AF=84=E4=BE=8B?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 21e545e..125083d 100644 --- a/README.md +++ b/README.md @@ -187,7 +187,7 @@ rm -rf ~/.config/opencode/skills/code-review ### `code-review-resolve` -四階段:**(A 解決)** 讀工作目錄 `.gitea/ai-review/findings.json`(Gitea AI review 產出的問題清單),依嚴重等級 **🔴 嚴重 → 🟠 高 → 🟡 中 → 🔵 低** 由高到低**逐條修復**程式碼問題(無法安全自動修復者標「待人工處理」不硬改),全部處理完把 `findings.json` 清空為空陣列 `[]`。**(B 提交)** 分析工作區**所有**變更,依異動內容歸類為 `feat`/`fix`/`docs`/`style`/`refactor`/`perf`/`test`/`chore`/`revert`,**每個 type 各自一個 commit**,訊息為「`type(中文範圍): 一句總結`」(例 `feat(新增功能): 新增使用者登入流程`、`perf(優化效能): 改用批次查詢降低 DB 往返`)。**(C 推送)** push 當前分支:先用**認證管理器**、失敗改用 **token**、再失敗**詢問使用者**。**(D 開 PR)** 用 token 透過 **Gitea API** 對目標分支發 PR(**目標分支不明必須詢問、不可猜測**),PR 描述可選**完整版**(重新分析 `git diff` 總結)/**簡單版**(逐條列 commit 訊息)/**使用者輸入**;完成後因內文可能含 gitea token,**提醒並清除 AI 助理對話內文**。修改程式碼/commit/push/開 PR 前先輸出計畫並取得同意(`--yes` 可略過);token 一律由環境變數(如 `GITEA_TOKEN`)提供,全程不明文輸出。 +四階段:**(A 解決)** 讀工作目錄 `.gitea/ai-review/findings.json`(Gitea AI review 產出的問題清單),依嚴重等級 **🔴 嚴重 → 🟠 高 → 🟡 中 → 🔵 低** 由高到低**逐條修復**程式碼問題(無法安全自動修復者標「待人工處理」不硬改),全部處理完把 `findings.json` 清空為空陣列 `[]`。**(B 提交)** 分析工作區**所有**變更,依異動內容歸類為 `feat`/`fix`/`docs`/`style`/`refactor`/`perf`/`test`/`chore`/`revert`,**每個 type 各自一個 commit**,訊息為「`type(範圍): 一句總結`」格式,**括號內的範圍須對應實際異動的功能/模組**(例 `feat(使用者登入): 新增帳密登入流程`、`perf(物件查詢): 改用批次查詢降低 DB 往返`,而非 `feat(新增功能)` 這類重述 type 的詞)。**(C 推送)** push 當前分支:先用**認證管理器**、失敗改用 **token**、再失敗**詢問使用者**。**(D 開 PR)** 用 token 透過 **Gitea API** 對目標分支發 PR(**目標分支不明必須詢問、不可猜測**),PR 描述可選**完整版**(重新分析 `git diff` 總結)/**簡單版**(逐條列 commit 訊息)/**使用者輸入**;完成後因內文可能含 gitea token,**提醒並清除 AI 助理對話內文**。修改程式碼/commit/push/開 PR 前先輸出計畫並取得同意(`--yes` 可略過);token 一律由環境變數(如 `GITEA_TOKEN`)提供,全程不明文輸出。 參數:`[--findings ] [--target <目標分支>] [--pr-desc ] [--no-commit] [--no-pr] [--yes]`(findings 省略時預設 `.gitea/ai-review/findings.json`;`--target` 省略時於開 PR 階段必問;`--no-commit` 只修復不提交;`--no-pr` 推送但不開 PR;`--yes` 略過確認)。