What:新增 `references/behaviors.md`。內含 ask 一節。該節是一張五列表,欄位為觸發時機、關鍵步驟、外部呼叫、完成條件、可驗證跡象。頁首說明這份清單的用途,並要求技能異動時在同一個 PR 內一起更新。 Why:技能驗證原本沒有共同的比對基準,驗證結果隨人而異。先盤點所有技能組,替每支技能寫下行為基準,驗證時直接比對這份清單。清單放在 jsc-ask 自己的 repo,不集中在 meta。技能改動與清單落在同一個 PR,內容才不會漂移,也不必跨 repo 開兩條 PR 互卡。 How:逐項讀過 ask 技能的現有流程,抽出五個面向填進表格。觸發時機同時寫下不叫用的情況。關鍵步驟依實際執行順序排列。外部呼叫列出腳本、技能、工具與範本。完成條件寫下成功標準與三種停止執行的情況。可驗證跡象寫成外部看得到的結果,例如 wiki 頁面多一節、內容頁時間戳更新,驗證時不必讀技能原始碼。表格格式由 `jsc-meta/tools/check-behaviors.sh` 在程式層檢查。 Who:jsc-ask 的 ask 技能,以及技能驗證流程。
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} |