plugins/ask
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
37 Commits 5 Branches 0 Tags
15825a5283eecb11a5c727e05302dbfa547bd336
Commit Graph
12 Commits
Author SHA1 Message Date
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
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 27bbae5ccb docs(README): 安裝入口改為 plugins/meta 並補上遷移說明 
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-24 18:00:35 +08: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
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
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 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
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 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 6d20892f88 docs(ask): 以統一格式改寫繁體中文 README 與 AGENTS 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 13:08:43 +08:00
jiantw83 6b40e713db Initial commit 2026-08-21 04:42:37 +00:00