From 500890909a9da63327cc0edd86fdc79cc6b80283 Mon Sep 17 00:00:00 2001 From: Jeffery Date: Fri, 21 Aug 2026 09:36:29 +0000 Subject: [PATCH 1/3] =?UTF-8?q?feat(ask):=20=E5=95=8F=E8=A9=A2=E7=B4=80?= =?UTF-8?q?=E9=8C=84=E6=AF=8F=E7=AF=80=E9=96=8B=E9=A0=AD=E5=BF=85=E8=A8=98?= =?UTF-8?q?=E4=BD=BF=E7=94=A8=E8=80=85=E6=84=8F=E5=9C=96?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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 --- README.md | 2 +- skills/ask/SKILL.md | 2 +- templates/question-record.md | 2 ++ 3 files changed, 4 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 332c101..640931b 100644 --- a/README.md +++ b/README.md @@ -24,7 +24,7 @@ Marketplace 統一為 `jsc`（https://gitea.jsc.idv.tw/plugins/jsc.git），安 ### `ask` -決策樹問詢：一題一個決策點、選項標明影響範圍、問到沒有疑慮為止。問前查 `QUESTION_CONTENTS` 與 `QUESTION_{HASH}`，已有答案不再問；問後套範本寫回 wiki（沒有存取庫名稱就不紀錄）。 +決策樹問詢：一題一個決策點、選項標明影響範圍、問到沒有疑慮為止。問前查 `QUESTION_CONTENTS` 與 `QUESTION_{HASH}`，已有答案不再問；問後套範本寫回 wiki，每節開頭記錄使用者意圖（沒有存取庫名稱就不紀錄）。 diff --git a/skills/ask/SKILL.md b/skills/ask/SKILL.md index d9939de..47a8cd8 100644 --- a/skills/ask/SKILL.md +++ b/skills/ask/SKILL.md @@ -24,6 +24,6 @@ Every jsc skill that needs user input MUST follow the rules in this skill. ## After asking 1. Without a repository name, do not record; stop here. -2. After each Q&A round, apply `templates/question-record.md` to create or update `QUESTION_{HASH}` (append new entries; never overwrite old records). +2. After each Q&A round, apply `templates/question-record.md` to create or update `QUESTION_{HASH}` (append new entries; never overwrite old records). Each section MUST open with the user's original intent (why this questioning round happened), per the template. 3. Apply `templates/question-contents.md` to create or update `QUESTION_CONTENTS` (add the repository row if missing; otherwise refresh its last-updated time). 4. The wiki writes above MUST run as a sub agent; the main agent only confirms the write succeeded. diff --git a/templates/question-record.md b/templates/question-record.md index 496065c..0c96869 100644 --- a/templates/question-record.md +++ b/templates/question-record.md @@ -4,6 +4,8 @@ ## {yyyy-MM-dd HH:mm} {問詢主題} +- **意圖**: {使用者的原始需求與目的，一句話} + ### Q1: {問題} | 選項 | 影響範圍 | From 7d9b430c30bd143611a1c09303651c9d1fb10518 Mon Sep 17 00:00:00 2001 From: Jeffery Date: Fri, 21 Aug 2026 09:36:29 +0000 Subject: [PATCH 2/3] =?UTF-8?q?chore(manifest):=20=E7=89=88=E6=9C=AC?= =?UTF-8?q?=E5=8D=87=E8=87=B3=200.0.2?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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 --- .claude-plugin/plugin.json | 2 +- .codex-plugin/plugin.json | 2 +- plugin.json | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json index 167fb02..7fc0990 100644 --- a/.claude-plugin/plugin.json +++ b/.claude-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "jsc-ask", - "version": "0.0.1", + "version": "0.0.2", "description": "決策樹問詢與問詢紀錄（QUESTION_* wiki 頁）", "skills": "./skills", "author": { diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.json index efd8c72..5b21104 100644 --- a/.codex-plugin/plugin.json +++ b/.codex-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "jsc-ask", - "version": "0.0.1", + "version": "0.0.2", "description": "決策樹問詢與問詢紀錄（QUESTION_* wiki 頁）", "skills": "./skills" } diff --git a/plugin.json b/plugin.json index f552e0f..9d1579a 100644 --- a/plugin.json +++ b/plugin.json @@ -1,6 +1,6 @@ { "name": "jsc-ask", - "version": "0.0.1", + "version": "0.0.2", "description": "決策樹問詢與問詢紀錄（QUESTION_* wiki 頁）", "skills": "./skills/" } From f8981d08eaf2f0b75c0f84d58dd71c487caffd45 Mon Sep 17 00:00:00 2001 From: Jeffery Date: Fri, 21 Aug 2026 09:41:47 +0000 Subject: [PATCH 3/3] =?UTF-8?q?feat(ask):=20=E6=84=8F=E5=9C=96=E6=AC=84?= =?UTF-8?q?=E4=BE=9B=20AI=20=E5=88=A4=E6=96=B7=E4=BD=BF=E7=94=A8=E8=80=85?= =?UTF-8?q?=E9=81=B8=E6=93=87=E5=8B=95=E6=A9=9F=E4=B8=A6=E6=B1=BA=E5=AE=9A?= =?UTF-8?q?=E8=88=8A=E7=AD=94=E6=A1=88=E9=81=A9=E7=94=A8=E6=80=A7?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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 --- README.md | 2 +- skills/ask/SKILL.md | 4 ++-- templates/question-record.md | 2 +- 3 files changed, 4 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 640931b..593fefe 100644 --- a/README.md +++ b/README.md @@ -24,7 +24,7 @@ Marketplace 統一為 `jsc`（https://gitea.jsc.idv.tw/plugins/jsc.git），安 ### `ask` -決策樹問詢：一題一個決策點、選項標明影響範圍、問到沒有疑慮為止。問前查 `QUESTION_CONTENTS` 與 `QUESTION_{HASH}`，已有答案不再問；問後套範本寫回 wiki，每節開頭記錄使用者意圖（沒有存取庫名稱就不紀錄）。 +決策樹問詢：一題一個決策點、選項標明影響範圍、問到沒有疑慮為止。問前查 `QUESTION_CONTENTS` 與 `QUESTION_{HASH}`，已有答案不再問；AI 取用舊答案時依意圖判斷適用性，意圖不符就重新問。問後套範本寫回 wiki，每節開頭記錄使用者意圖（沒有存取庫名稱就不紀錄）。 diff --git a/skills/ask/SKILL.md b/skills/ask/SKILL.md index 47a8cd8..f2758da 100644 --- a/skills/ask/SKILL.md +++ b/skills/ask/SKILL.md @@ -11,7 +11,7 @@ Every jsc skill that needs user input MUST follow the rules in this skill. 1. Confirm the repository name `{owner}/{repo}` of the current work. Without one, skip steps 2 and 3: ask directly but do NOT record. 2. Compute `HASH`: `printf '%s' "{owner}/{repo}" | sha1sum | cut -c1-8 | tr a-f A-F`. -3. Read `QUESTION_CONTENTS` and `QUESTION_{HASH}` via `jsc-gitea:wiki`. Never re-ask a question already answered in the record; use the recorded answer directly. +3. Read `QUESTION_CONTENTS` and `QUESTION_{HASH}` via `jsc-gitea:wiki`. Never re-ask a question already answered in the record; use the recorded answer directly. When reusing an answer, read the section's intent to judge whether the answer fits the current situation and whether it extends to similar unrecorded decisions. If the intent differs from the current situation, ask again instead of forcing the old answer. ## Questioning rules @@ -24,6 +24,6 @@ Every jsc skill that needs user input MUST follow the rules in this skill. ## After asking 1. Without a repository name, do not record; stop here. -2. After each Q&A round, apply `templates/question-record.md` to create or update `QUESTION_{HASH}` (append new entries; never overwrite old records). Each section MUST open with the user's original intent (why this questioning round happened), per the template. +2. After each Q&A round, apply `templates/question-record.md` to create or update `QUESTION_{HASH}` (append new entries; never overwrite old records). Each section MUST open with the user's original intent (why this questioning round happened), per the template; it lets a later reader judge why the user chose as they did and whether the answer still applies. 3. Apply `templates/question-contents.md` to create or update `QUESTION_CONTENTS` (add the repository row if missing; otherwise refresh its last-updated time). 4. The wiki writes above MUST run as a sub agent; the main agent only confirms the write succeeded. diff --git a/templates/question-record.md b/templates/question-record.md index 0c96869..eb9550b 100644 --- a/templates/question-record.md +++ b/templates/question-record.md @@ -4,7 +4,7 @@ ## {yyyy-MM-dd HH:mm} {問詢主題} -- **意圖**: {使用者的原始需求與目的，一句話} +- **意圖**: {使用者的原始需求與目的，一句話，供 AI 判斷選擇動機與答案適用性} ### Q1: {問題}