skills/code-review-resolve/SKILL.md

@@ -38,7 +38,7 @@ argument-hint: "[--findings <findings.json 路徑>] [--target <目標分支>] [-
 
 - `--findings <路徑>`：findings 檔路徑。**省略時預設 `.gitea/ai-review/findings.json`**（相對於工作目錄根）。
 - `--target <目標分支>`：PR 的目標分支。**省略時必須詢問使用者，不可猜測**；若需要避免把同名來源分支誤推到目標分支，可能會在階段 D 先詢問並於階段 E 沿用。
-- `--pr-desc <full|simple|自訂文字>`：PR 描述形式。`full`＝完整版（重新分析 diff 總結）、`simple`＝簡單版（逐條列 commit 訊息）、或直接給自訂文字；省略時預設 `simple`，不要為描述形式中斷詢問。
+- `--pr-desc <full|simple|自訂文字>`：PR 描述形式。`full`＝完整版（重新分析 diff 總結）、`simple`＝簡單版（逐條列 commit 訊息）、或直接給自訂文字；省略時預設 `full`，不要為描述形式中斷詢問。
 - `--no-commit`：只做階段 A/B（git 同步 + 修復 + 更新 findings/exclusions），**不**執行階段 C/D/E（不提交、不推送、不開 PR）。
 - `--no-pr`：執行到階段 D（push）為止，**不**開 PR（階段 E 略過）。
 - `--yes`：明確要求全自動執行（修復、更新 findings/exclusions、commit、push、開 PR 一氣呵成）；即使未帶此參數，也依「自動執行原則」盡量不中斷，只有必要決策才詢問。
@@ -336,7 +336,7 @@ git rev-parse --abbrev-ref HEAD
 
 ### E4. 決定 PR 描述形式（完整版／簡單版／使用者輸入）
 
-依 `--pr-desc` 三選一；若未提供則預設使用 `simple`，不要為描述形式中斷詢問：
+依 `--pr-desc` 三選一；若未提供則預設使用 `full`，不要為描述形式中斷詢問：
 
 - **完整版（`full`）**：**重新分析並總結** `git diff <target>...<PR 來源分支>`（比對 source 自分岔點以來的變更），整理成結構化繁體中文說明 —— 變更摘要、影響範圍、重點檔案／模組、風險或注意事項。不是貼原始 diff，而是「人讀得懂的總結」。
 - **簡單版（`simple`）**：直接把本分支領先 target 的 commit 訊息**逐條列出**：
@@ -350,17 +350,20 @@ git rev-parse --abbrev-ref HEAD
 
 PR **標題**預設取一句總結（可用首個 feat/fix commit 或分支用途）；使用者另有指定則從之。
 
+產生 PR body 時必須使用實際換行與 Markdown 內容，不可把跳脫字串當作正文送出。若用 shell / `jq` 組 JSON，應以 UTF-8 暫存檔、heredoc、`printf` 或 `jq --rawfile` 帶入內容；避免讓 PR 顯示成 `## Commit\n\n- ...` 這類字面 `\n`。
+
 ### E5. 呼叫 Gitea API 建立 PR（使用 token）
 
 token 從環境變數讀取，呼叫 Gitea 建立 PR：
 
 ```bash
-# 不可 echo 含 token 的指令；body 以檔案或變數帶入，輸出時遮蔽 token
+# 不可 echo 含 token 的指令；body 以 UTF-8 JSON 檔帶入，輸出時遮蔽 token
+# PR 描述內的換行必須是實際換行，不可使用字面 \n
 curl -sS -X POST \
   -H "Authorization: token ${GITEA_TOKEN}" \
   -H "Content-Type: application/json" \
   "https://<host>/api/v1/repos/<owner>/<repo>/pulls" \
-  -d '{"head":"<PR 來源分支>","base":"<target>","title":"<標題>","body":"<描述>"}'
+  --data @body.json
 ```
 
 - **成功**：取回應中的 PR 連結／編號回報使用者。
@@ -396,5 +399,5 @@ curl -sS -X POST \
 | 助理 | 呼叫 |
 | --- | --- |
 | Claude Code / Antigravity | `/jsc:code-review-resolve`，或 `/jsc:code-review-resolve --target develop --pr-desc full --yes`、`/jsc:code-review-resolve --no-pr`、`/jsc:code-review-resolve --no-commit` |
-| Codex | `$code-review-resolve`，或 `$code-review-resolve --target develop --pr-desc simple --yes`，或用 `/skills` 選單 |
+| Codex | `$code-review-resolve`，或 `$code-review-resolve --target develop --pr-desc full --yes`，或用 `/skills` 選單 |
 | OpenCode | 描述需求（如「讀 .gitea/ai-review/findings.json 依嚴重度逐條處理，更新 findings/exclusions，把工作區變更依 conventional commit 分類提交，push 後對 develop 發 PR（完整版描述）」）自動觸發 |