jiantw83 8050cf3a4e feat(behaviors): 新增 jsc-ask 技能行為清單
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 技能,以及技能驗證流程。
2026-08-31 13:36:10 +08:00
2026-08-21 04:42:37 +00:00

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
S
Description
No description provided
Readme
183 KiB
Languages
Markdown 100%