What:
templates/question-record.md 在每節標題下新增「意圖」欄。
skills/ask/SKILL.md 的 After asking 第 2 步補上 MUST 句,要求每節以使用者原始意圖開頭。
README.md 的 Skills 目錄同步更新 ask 技能描述。
Why:
使用者回顧 QUESTION_* wiki 頁時,只看得到選項與答案。
紀錄缺少提問動機,事後看不出當初為什麼問。
補上意圖欄,讓每輪問詢的來龍去脈一目了然。
How:
範本在「## {時間} {問詢主題}」下加一行「- **意圖**: {使用者的原始需求與目的,一句話}」。
SKILL.md 以 MUST 強制套用範本時填寫意圖。
README 描述加註「每節開頭記錄使用者意圖」。
Who:
所有透過 jsc-ask:ask 問詢並寫紀錄的 jsc 技能(skill-new、skill-update、sdlc 各階段等);wiki 讀者從此看得到每輪問詢的動機。
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
42 lines
2.6 KiB
Markdown
42 lines
2.6 KiB
Markdown
# jsc-ask — 決策樹問詢
|
||
|
||
jsc 技能組的問詢 domain:所有技能需要問使用者時的統一規則。以選項式決策樹詢問直到沒有疑慮,每個選項標明影響範圍;問前先查 wiki 問詢紀錄避免重複問,問後把答案寫回 `QUESTION_*` 頁。
|
||
|
||
## 安裝、更新、移除
|
||
|
||
Marketplace 統一為 `jsc`(https://gitea.jsc.idv.tw/plugins/jsc.git),安裝 token 為 `jsc-ask@jsc`。每個指令一行:
|
||
|
||
| CLI | 安裝 | 更新 | 移除 |
|
||
| --- | --- | --- | --- |
|
||
| claude | `claude plugin marketplace add https://gitea.jsc.idv.tw/plugins/jsc.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/jsc.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/jsc.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/jsc.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`。
|
||
|
||
## Skills 目錄
|
||
|
||
呼叫方式:Claude / Antigravity `/jsc-ask:{name}`;Codex `${name}`;Copilot / Kiro 描述需求自動觸發。
|
||
|
||
<!-- JSC-SKILLS:START -->
|
||
|
||
### `ask`
|
||
|
||
決策樹問詢:一題一個決策點、選項標明影響範圍、問到沒有疑慮為止。問前查 `QUESTION_CONTENTS` 與 `QUESTION_{HASH}`,已有答案不再問;問後套範本寫回 wiki,每節開頭記錄使用者意圖(沒有存取庫名稱就不紀錄)。
|
||
|
||
<!-- 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`
|