# jsc-ask — 決策樹問詢

jsc 技能組的問詢 domain：所有技能需要問使用者時的統一規則。以選項式決策樹詢問直到沒有疑慮，每個選項標明影響範圍；問前先查 wiki 問詢紀錄避免重複問，問後把答案寫回 `QUESTION_*` 頁。

## 安裝、更新、移除

Marketplace 統一為 `jsc`（https://gitea.jsc.idv.tw/plugins/meta.git），安裝 token 為 `jsc-ask@jsc`。每個指令一行：

| CLI | 安裝 | 更新 | 移除 |
| --- | --- | --- | --- |
| claude | `claude plugin marketplace add https://gitea.jsc.idv.tw/plugins/meta.git && claude plugin install jsc-ask@jsc` | `claude plugin marketplace update jsc && claude plugin update jsc-ask@jsc` | `claude plugin uninstall jsc-ask@jsc` |
| codex | `codex plugin marketplace add https://gitea.jsc.idv.tw/plugins/meta.git && codex plugin add jsc-ask@jsc` | `codex plugin marketplace upgrade jsc` | `codex plugin remove jsc-ask@jsc` |
| copilot | `copilot plugin marketplace add https://gitea.jsc.idv.tw/plugins/meta.git && copilot plugin install jsc-ask@jsc` | `copilot plugin marketplace update jsc && copilot plugin update jsc-ask@jsc` | `copilot plugin uninstall jsc-ask@jsc` |
| antigravity | `git clone https://gitea.jsc.idv.tw/plugins/ask.git ~/plugins/ask && agy plugin install ~/plugins/ask` | `git -C ~/plugins/ask pull && agy plugin uninstall jsc-ask && agy plugin install ~/plugins/ask` | `agy plugin uninstall jsc-ask` |
| kiro | `kiro-cli plugin marketplace add https://gitea.jsc.idv.tw/plugins/meta.git && kiro-cli plugin install jsc-ask@jsc` | `kiro-cli plugin marketplace update jsc && kiro-cli plugin update jsc-ask@jsc` | `kiro-cli plugin uninstall jsc-ask@jsc` |

> antigravity 不支援 gitea URL 安裝，改用本地 clone 路徑。批次操作五個 CLI：使用 `/jsc-cli:deploy`。

> 舊入口 `plugins/jsc` 已移除，marketplace 正本移到 `plugins/meta`。marketplace 名稱仍是 `jsc`（取自 marketplace.json 的 `name` 欄位，與存取庫名無關），安裝 token 不變；已從舊入口安裝過的人先執行 `claude plugin marketplace remove jsc`，再依上表重新 add。

## Skills 目錄

呼叫方式：Claude / Antigravity `/jsc-ask:{name}`；Codex `${name}`；Copilot / Kiro 描述需求自動觸發。

<!-- JSC-SKILLS:START -->

### `ask`

決策樹問詢：一題一個決策點、選項標明影響範圍、問到沒有疑慮為止。問前查 `QUESTION_CONTENTS` 與 `QUESTION_{HASH}`，其中 `{HASH}` 執行 `jsc-gitea/tools/hash-id` 產生，原樣採用它印出的完整 40 碼大寫十六進位，不截短、不加前綴；已有答案不再問；AI 取用舊答案時依意圖判斷適用性，意圖不符就重新問。兩頁分屬兩個存取庫：目錄頁 `QUESTION_CONTENTS` 走 `JSC_WIKI_REPO_CONTENTS`，紀錄頁 `QUESTION_{HASH}` 走 `JSC_WIKI_REPO_QUESTION`，兩者都退回 `JSC_WIKI_REPO`。兩頁在同一個工作階段只讀一次，之後沿用手上那份，自己寫入後就更新它；問出來的 wiki 存取庫也留在工作階段內重複使用。問後套範本寫回 wiki，紀錄頁每節開頭記錄使用者意圖，目錄頁是條列式：每個存取庫一個 H2 區塊，標題就是內容頁頁名 `QUESTION_{HASH}`，欄位一條一行，用 `jsc-gitea/tools/wiki-contents.sh upsert` 只改自己那個區塊、以絕對網址連到紀錄頁（沒有存取庫名稱就不記錄）。不適用於答案已有紀錄的情況。

<!-- JSC-SKILLS:END -->

## 範本

| 檔案 | 用途 |
| --- | --- |
| `templates/question-contents.md` | 問詢目錄 `QUESTION_CONTENTS` |
| `templates/question-record.md` | 問詢紀錄 `QUESTION_{HASH}` |

## 相關 domain

- [`jsc-gitea`](https://gitea.jsc.idv.tw/plugins/gitea)：wiki 讀寫（`jsc-gitea:wiki`）
- [`jsc-meta`](https://gitea.jsc.idv.tw/plugins/meta)：技能準則 `references/guidelines.md`