jiantw83
f40b374342
What：修剪 SKILL.md 的 frontmatter description 至 5 句內並補上明確的排除 觸發語句；將 SKILL.md 與兩份範本中重述的 wiki hash 演算法說明，改為指向 canonical 的 `jsc-gitea/tools/hash-id` 工具；同步更新 README.md 的 Skills 目錄描述；三份 manifest 版本號自 0.0.2 升至 0.0.3。 Why：jsc-meta:skill-check 稽核發現 SKILL.md 的 description 超過 5 句且缺少 明確排除觸發語句，且 SKILL.md 與 question-contents.md、question-record.md 重複描述同一套 wiki hash 演算法，違反「委派 canonical 工具、不重複邏輯」 的準則。 How：改寫 skills/ask/SKILL.md 的 description 為精簡版並加入排除語句；三處 重述 hash 演算法的段落，統一改寫為呼叫 `jsc-gitea/tools/hash-id`（演算法 細節見 guidelines.md）；README.md 的 ask 技能描述同步調整；plugin.json、 .claude-plugin/plugin.json、.codex-plugin/plugin.json 版本號 0.0.2 → 0.0.3。 Who：ask 技能本身（skills/ask/SKILL.md 與其範本、manifest）。
42 lines
2.8 KiB
Markdown
42 lines
2.8 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}`，其中 `{HASH}` 執行 `jsc-gitea/tools/hash-id` 產生；已有答案不再問；AI 取用舊答案時依意圖判斷適用性，意圖不符就重新問。問後套範本寫回 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`
|