Files
ask/README.md
jiantw83 15825a5283 docs(ask): 補上目錄頁寫入語意並更新技能說明
What
- 問詢目錄頁範本新增「寫入語意」說明。
- 問詢目錄頁範本的規範指標改指向 jsc-meta 的 references/guidelines.md。
- README 的 ask 技能說明補上工作階段內只讀一次的行為。

Why
- 目錄頁一列代表一個存取庫,由所有存取庫共用。範本只給表格不給寫法,寫入者容易整頁覆寫,抹掉別的存取庫的列。
- 指標指向的規範檔案已經搬到 jsc-meta,舊指標讓讀者找不到來源。
- README 是外部讀者認識這個技能的第一份文件。技能已經改成一個工作階段只讀一次,說明沒跟上就會誤導讀者。

How
- 在目錄頁範本的說明區塊新增一段寫入語意:先讀回整頁,有列就更新該列,沒有才在文末附加,最後整頁寫回;明文禁止整頁覆蓋,也不得改動別人的列。
- 範本的指標改寫成 jsc-meta 的 references/guidelines.md。
- README 的技能段落補一句:兩頁在同一個工作階段只讀一次,之後沿用手上那份,自己寫入後就更新它,問出來的 wiki 存取庫也留在工作階段內重複使用。

Who
- 問詢目錄頁範本,以及存取庫首頁的 ask 技能說明。
2026-08-31 11:05:09 +08:00

3.3 KiB
Raw Permalink Blame History

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 描述需求自動觸發。

ask

決策樹問詢:一題一個決策點、選項標明影響範圍、問到沒有疑慮為止。問前查 QUESTION_CONTENTS 與 QUESTION_{HASH},其中 {HASH} 執行 jsc-gitea/tools/hash-id 產生;已有答案不再問;AI 取用舊答案時依意圖判斷適用性,意圖不符就重新問。兩頁在同一個工作階段只讀一次,之後沿用手上那份,自己寫入後就更新它;問出來的 wiki 存取庫也留在工作階段內重複使用。問後套範本寫回 wiki,每節開頭記錄使用者意圖(沒有存取庫名稱就不記錄)。不適用於答案已有紀錄的情況。

範本

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

相關 domain

  • jsc-gitea:wiki 讀寫(jsc-gitea:wiki)
  • jsc-meta:技能準則 references/guidelines.md