plugins/ask
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
48 Commits 5 Branches 0 Tags
982cb789d47764baeb3a7ce9b7e16cb3e8b472db
Commit Graph
48 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
jiantw83 982cb789d4 chore(marketplace): 把 jsc-assist 登錄進統一 marketplace 
What：
- 兩份 marketplace 檔各加一個 jsc-assist 條目，來源網址指向 assist 存取庫。

Why：
- 準則要求每個 domain 存取庫都帶同一份 marketplace 檔，任何一個存取庫都能當註冊入口。副本之間只要有一份沒跟上，稽核就會報出不一致。

How：
- 條目由 meta 的 sync-marketplace.sh 產生，同時寫進正本與每個 domain 存取庫的副本，寫完逐檔比對位元組。這一支存取庫的兩份副本就是那一輪的產物。
- 條目依名稱排序，縮排與非 ASCII 描述的處理都交給同一支腳本，不手改 JSON。

Who：
助理 domain 落地的註冊步驟在這個存取庫的同步。
 2026-09-01 11:21:31 +08:00
admin 8c50921e91 Merge pull request '釋出 jsc-ask 0.0.9：新增技能行為清單' (#19) from develop into master 
Reviewed-on: #19
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>
 2026-08-31 08:17:56 +00:00
jiantw83 211c31aaf9 Merge pull request '收攏 ask 的技能行為清單，一次併回 develop' (#18) from feat/skill-behaviors-and-version-block/main into develop 2026-08-31 08:10:32 +00:00
jiantw83 b973b2803a Merge pull request '替 ask 這支技能建立行為清單，供技能驗證比對' (#17) from feat/skill-behaviors-and-version-block/behavior-list into feat/skill-behaviors-and-version-block/main 2026-08-31 08:09:18 +00:00
jiantw83 af2156ccfe chore(manifest): 同步三份 manifest 版本至 0.0.9 
What：把 `.claude-plugin/plugin.json`、`.codex-plugin/plugin.json`、`plugin.json` 的 `version` 由 `0.0.8` 改成 `0.0.9`。三份檔案只動這一個欄位。

Why：本次新增技能行為清單，套件內容已經改變。版本號要一起進版，安裝端才收得到更新。三份 manifest 分別供不同 CLI 讀取，版本必須同號，否則使用者在不同 CLI 會讀到不一致的版本。

How：逐份 manifest 只改 `version` 這一個鍵，其餘欄位維持原樣。三份改成同一個版本號 0.0.9。版本進位採修補號，因為本次只新增參考文件，沒有改動技能行為。

Who：jsc-ask 套件的版本標示，以及 jsc-cli:deploy 的安裝與更新流程。
 2026-08-31 13:36:11 +08:00
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
admin 1e0f46cbbc Merge pull request 'chore(release): 放行技能組稽核修正到預設分支' (#16) from develop into master 
Reviewed-on: #16
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>
 2026-08-31 03:54:15 +00:00
admin 4e205b48ce Merge pull request 'fix/skill-check-compliance-and-flow' (#15) from fix/skill-check-compliance-and-flow into develop 
Reviewed-on: #15
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>
 2026-08-31 03:16:08 +00:00
jiantw83 f5ddb808f1 chore(manifest): 宣告 jsc-meta 相依並推進外掛版本 
What
- 三份 manifest 的 jsc.requires 新增 jsc-meta 與它的最低版本要求。
- 三份 manifest 的外掛版本各推進一版。

Why
- 這個技能的規範文件指標已經改指 jsc-meta。沒有宣告相依，安裝端可能少裝或裝到太舊的 jsc-meta，指標就指向不存在的檔案。
- 三份 manifest 分別供不同的 CLI 讀取，內容必須一致，只改其中一份會讓各 CLI 看到不同的相依。
- 技能行為這次有實質變動，版本不推進，安裝端不會取得新版。

How
- 在 jsc.requires 既有的 jsc-gitea 之後補上 jsc-meta 一項，三份 manifest 寫法一致。
- 三份 manifest 的 version 欄位同步推進一版。

Who
- jsc-ask 外掛的三份安裝設定檔。
 2026-08-31 11:05:10 +08:00
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
jiantw83 232eb36158 fix(ask): 補上失敗退出碼分流並改正規範指標 
What
- 產生 HASH 的指令失敗時，依退出碼分流處理。
- 讀取問詢頁失敗時，依退出碼分流處理。
- 寫入目錄頁失敗時，依退出碼分流處理。
- 規範文件的指標改指向 jsc-meta 的 references/guidelines.md。
- 新增「Session cache」一節，兩頁在同一個工作階段只讀一次。
- wiki 存取庫在同一個工作階段只解析一次。
- 問後的三重完成條件收斂成一次確認。

Why
- 原本只寫「執行指令取得 HASH」。指令失敗時沒有指示，技能會自行硬算雜湊或猜測頁名，寫錯頁面。
- 「讀取失敗」與「頁面不存在」意義不同。不分流就把失敗當成沒有紀錄，重問使用者已經回答過的問題。
- 目錄頁由所有存取庫共用。讀不回舊內容還照樣整頁覆寫，會抹掉別的存取庫的列，而且沒有備份可救。
- 指標指向的規範檔案已經搬到 jsc-meta，舊指標讓讀者找不到來源。
- 兩頁在一個工作階段內只有本技能會寫。重複讀取只是多花往返時間。
- wiki 位置本身就是要問的問題，答案卻要寫進 wiki 才記得住。不把答案留在工作階段內，每次呼叫都得再問一次，永遠問不完。
- 完成條件重複確認同一件事，主代理得多讀兩次頁面才敢往下走。

How
- 取得 HASH 一步列明退出碼 0 與 1 的處理；其他非零退出碼一律停止執行，並回報退出碼與指令的錯誤輸出。
- 讀取一步把「頁面不存在」視為沒有紀錄，照常發問；其他失敗停止執行，並回報失敗頁名與退出碼。
- 寫入目錄頁一步依退出碼分流：正常就讀回整頁後更新單列，金鑰無效或無權限、以及其他 API 失敗都放棄寫入並回報。
- 新增「Session cache」一節，訂出首次讀取、後續沿用、寫入後更新副本、隨工作階段結束失效四個步驟。
- 解析 wiki 存取庫獨立成一步，答案留在工作階段內重複使用，收尾再建議使用者設定環境變數，永久結束追問。
- 兩份寫入交給同一個子代理，收斂成單一回報，主代理確認一次即可，不再回讀頁面驗證。
- 寫入失敗只重試該頁一次；再失敗就停止執行，回報未寫入的頁面與退出碼，答案仍交還呼叫端。
- 兩份範本的指標同步改指 jsc-meta。

Who
- 決策樹問詢技能 ask 的問前準備、問後紀錄流程，以及問詢紀錄頁範本。
 2026-08-31 11:05:09 +08:00
admin d9a498283f Merge pull request 'release: 發布 jsc-ask 相依版本宣告' (#14) from develop into master 
Reviewed-on: #14
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>
 2026-08-28 06:51:38 +00:00
admin b88d07037e Merge pull request 'feat/plugin-dependencies/main' (#13) from feat/plugin-dependencies/main into develop 
Reviewed-on: #13
 2026-08-28 04:04:47 +00:00
admin 13d1eafc16 Merge pull request 'feat/plugin-dependencies/declare-requires' (#12) from feat/plugin-dependencies/declare-requires into feat/plugin-dependencies/main 
Reviewed-on: #12
 2026-08-28 04:02:52 +00:00
jiantw83 9914b2194c feat(manifest): 宣告 gitea 相依版本 2026-08-28 11:59:16 +08:00
admin 12b90d0365 Merge pull request 'release: v0.0.6 develop 到 master' (#11) from develop into master 
Reviewed-on: #11
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>
 2026-08-27 02:07:02 +00:00
admin 36691990d4 Merge pull request 'fix/skillset-audit-compliance-and-guard-fixes' (#10) from fix/skillset-audit-compliance-and-guard-fixes into develop 
Reviewed-on: #10
 2026-08-25 07:14:36 +00:00
jiantw83andClaude Opus 5 b9929582d6 chore(ask): 三份 manifest 同步升版並同步 marketplace 正本 
What：三份 plugin manifest 版本同步 bump，兩份 marketplace 檔與 plugins/meta 正本對齊。

Why：準則要求技能異動必須同步升版；marketplace 副本必須與正本完全一致。

How：以 jsc-meta 的 tools/sync-skill-manifest.sh 升版，marketplace 檔由正本複製。

Who：jsc-meta:skill-check 例行稽核（2026-08-25）。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-25 14:58:54 +08:00
jiantw83andClaude Opus 5 aaac910060 docs(ask): 同步文件與參考資料 
What：更新 README、AGENTS.md、templates 與 references，讓文件敘述與實際行為一致。

Why：稽核發現多處文件與程式行為分歧，違反「每個意義只有單一真實來源」。

How：以實際程式行為為準改寫敘述，重複的規則收成單一來源並以一行指引指過去。

Who：jsc-meta:skill-check 例行稽核（2026-08-25）。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-25 14:58:54 +08:00
jiantw83andClaude Opus 5 8409da7bda fix(ask): 補齊稽核缺失並修掉護欄失效 
What：依 jsc-meta:skill-check 的稽核結果修正技能與工具——補上每個步驟的可檢核完成條件、
把留在內文的標準輸入輸出流程下放 tools/、修正查表與退碼路由造成的誤判。

Why：稽核發現這些缺失會讓技能在實際執行時走錯分支或靜默通過。
完成條件缺漏是最常被違反的一項；退碼誤判與查表錯誤則會讓良性狀況被當成失敗。

How：逐項對照 references/guidelines.md 的審核檢查清單修正，新增的工具都有
documented exit codes，並以真實執行驗證每條路徑。

Who：jsc-meta:skill-check 例行稽核（2026-08-25）。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-25 14:58:54 +08:00
admin 5a88aea86c Merge pull request '發佈 jsc-ask 0.0.4：marketplace 正本移至 plugins/meta' (#9) from develop into master 
Reviewed-on: #9
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>
 2026-08-24 10:17:33 +00:00
admin 6c57e5217a Merge pull request 'chore(marketplace 正本): 正本移至 plugins/meta（升版 0.0.4）' (#8) from chore/marketplace-canon-to-meta into develop 
Reviewed-on: #8
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>
 2026-08-24 10:05:13 +00:00
jiantw83andClaude Opus 5 65063898cc chore(plugin 版本): 三份 manifest 升版至 0.0.4 
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-24 18:00:35 +08:00
jiantw83andClaude Opus 5 27bbae5ccb docs(README): 安裝入口改為 plugins/meta 並補上遷移說明 
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-24 18:00:35 +08:00
admin 8ac3c8c3bb Merge pull request '發佈 jsc-ask 0.0.3：skill-check 合規修正與 marketplace 同步' (#7) from develop into master 
Reviewed-on: #7
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>
 2026-08-24 08:26:23 +00:00
admin 40da180151 Merge pull request 'fix/marketplace-sync-and-ask-skill-check-compliance' (#6) from fix/marketplace-sync-and-ask-skill-check-compliance into develop 
Reviewed-on: #6
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>
 2026-08-24 07:57:57 +00:00
jiantw83 f40b374342 fix(ask): 修正 skill-check 不合規項並升版至 0.0.3 
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）。
 2026-08-24 14:46:37 +08:00
jiantw83 ea1a2c805b fix(marketplace): 同步 marketplace.json 至 jsc canonical 版本 
What：同步 `.agents/plugins/marketplace.json` 與 `.claude-plugin/marketplace.json`
至 jsc canonical marketplace，補齊各外掛缺少的 description 與 owner 欄位，並統一
既有描述措辭。

Why：兩份 marketplace.json 落後於 canonical 版本，缺少說明文字與擁有者資訊，
不利於使用者辨識外掛用途，也會在 jsc-meta:skill-check 稽核時被判定不一致。

How：以 plugins/jsc 的 canonical marketplace.json 為準，補上 owner 欄位與各
外掛的 description 欄位，並將既有措辭（如 meta 外掛描述的頓號用法）對齊統一。

Who：repo 層級基礎設施修正，與 ask 技能本身邏輯無關。
 2026-08-24 14:46:22 +08:00
admin 99d9e59928 Merge pull request 'chore(ask): 合併 develop 到 master' (#5) from develop into master 
Reviewed-on: #5
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>
 2026-08-24 03:45:18 +00:00
admin 40f176921b Merge pull request 'feat/ask-question-record-intent' (#3) from feat/ask-question-record-intent into develop 
Reviewed-on: #3
 2026-08-24 02:17:19 +00:00
jiantw83andClaude Sonnet 5 ec44ec9201 merge: 合併 develop（統一 wiki hash 規則）到 feat/ask-question-record-intent 
同時保留兩邊變更：develop 的共用 wiki hash 規則說明，與本分支的意圖欄讀寫規則。
README.md 與 skills/ask/SKILL.md 的衝突段落合併成單一句子，不遺漏任一邊的規則。

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
 2026-08-24 01:52:50 +00:00
admin a2c1815a4a Merge pull request 'fix/wiki-normalize-question-pages' (#4) from develop into master 
Reviewed-on: #4
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>
 2026-08-21 16:56:36 +00:00
jiantw83 d922820451 fix(wiki): 統一 QUESTION wiki 命名與 hash 規則 2026-08-21 16:53:17 +00:00
jiantw83andClaude Fable 5 f8981d08ea feat(ask): 意圖欄供 AI 判斷使用者選擇動機並決定舊答案適用性 
What：
補上意圖欄的讀取端行為。SKILL.md「Before asking」第 3 步要求 AI 取用舊答案時同時讀該節意圖，判斷答案是否適用當下情境、可否延伸到類似決策；意圖不符就重新詢問。「After asking」第 2 步點明意圖是給後續讀者判斷選擇動機用。範本佔位說明與 README 的 ask 段落同步。

Why：
上一輪只加了寫入端的意圖欄。使用者補充：意圖欄的目的是讓 AI 讀紀錄時能判斷使用者如此選擇的動機。缺了讀取端規則，AI 仍可能把舊答案硬套到情境不同的新決策上。

How：
SKILL.md 第 3 步句尾補兩句英文讀取規則，第 2 步「After asking」補半句呼應；templates/question-record.md 意圖欄佔位說明點出「供 AI 判斷選擇動機與答案適用性」；README.md ask 段落加一句「AI 取用舊答案時依意圖判斷適用性，意圖不符就重新問」。版本不變（0.0.2 尚未發布，同一條 PR）。

Who：
使用者於 jsc-ask 技能維護時提出；影響所有透過 jsc-ask:ask 取用舊答案的 jsc 技能。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 09:41:47 +00:00
jiantw83andClaude Fable 5 7d9b430c30 chore(manifest): 版本升至 0.0.2 
What：
plugin.json、.claude-plugin/plugin.json、.codex-plugin/plugin.json 的 version 由 0.0.1 升到 0.0.2。

Why：
問詢紀錄新增意圖欄屬於功能變更。
三份 manifest 必須同步升版，各 CLI 才會抓到新版技能。

How：
三個檔案的 version 欄位一併改為 0.0.2，其餘欄位不動。

Who：
透過 jsc marketplace 安裝或更新 jsc-ask 的所有 CLI 使用者；版本號變更讓各 CLI 偵測到更新。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 09:36:29 +00:00
jiantw83andClaude Fable 5 500890909a feat(ask): 問詢紀錄每節開頭必記使用者意圖 
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>
 2026-08-21 09:36:29 +00:00
admin ec558c2e61 Merge pull request 'feat(ask): 匯入 jsc-ask 技能組並統一 marketplace 為 jsc' (#2) from develop into master 
Reviewed-on: #2
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>
 2026-08-21 06:40:43 +00:00
jiantw83andClaude Fable 5 3df42eafe5 chore(ask): 加入統一 jsc marketplace 副本（與正本一致，任一 repo 可作註冊入口） 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 14:37:44 +08:00
jiantw83andClaude Fable 5 2347ddc3ac style(ask): 中文並列改頓號 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 14:28:17 +08:00
jiantw83andClaude Fable 5 d2def4abb9 docs(ask): translate SKILL.md into English per guidelines 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 14:28:17 +08:00
jiantw83andClaude Fable 5 25f6fd3895 style(ask): 依 STE100 擬人台灣感規則改寫語感 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 14:16:43 +08:00
jiantw83andClaude Fable 5 5bb0b8eb20 docs(ask): AGENTS 語言規則改指向 jsc-meta 的 references/ste100.md 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 14:13:27 +08:00
jiantw83andClaude Fable 5 774373ddba docs(ask): README 安裝/更新/移除改為每指令一行（五個 CLI）並為相關 domain 加上 repo 連結 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 14:03:32 +08:00
jiantw83andClaude Fable 5 fe026d0d95 chore(ask): 版本號改為 0.0.1 並移除個別 marketplace（統一為 jsc） 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 14:03:32 +08:00
jiantw83andClaude Fable 5 6d20892f88 docs(ask): 以統一格式改寫繁體中文 README 與 AGENTS 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 13:08:43 +08:00
jiantw83andClaude Fable 5 bc0fcd767a feat(ask): 匯入 jsc-ask 技能組 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 13:08:43 +08:00
jiantw83andClaude Fable 5 dbbd226a43 chore(ask): 修正範本 manifest 與移除 hello 範例符合 ask 領域 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 13:08:17 +08:00
jiantw83 6b40e713db Initial commit 2026-08-21 04:42:37 +00:00