feat/ask-question-record-intent #3

2026-08-21T09:36:36Z

jiantw83 commented

2026-08-21 09:36:36 +00:00

PR 描述

摘要

需求描述：問詢紀錄每節開頭必須記錄使用者的原始意圖與目的。使用者發現 QUESTION_* wiki 紀錄只有選項、影響範圍與答案，之後翻閱看不出當初為什麼問，因此決議修改範本與技能，而不是只補單次紀錄。意圖欄的目的是讓 AI 讀紀錄時能判斷使用者如此選擇的動機，並據此決定舊答案適不適用。
計畫名稱：無
計畫頁：無
分析頁：無

變更內容

檔案	為什麼改
templates/question-record.md	在節標題下、Q1 之前加入 `- 意圖: {使用者的原始需求與目的，一句話，供 AI 判斷選擇動機與答案適用性}`，讓每輪問詢都先記下當初為什麼問
skills/ask/SKILL.md	After asking 第 2 步補上「Each section MUST open with the user's original intent…」強制寫入；Before asking 第 3 步補讀取端規則——取用舊答案前先讀該節意圖，判斷答案是否適用當下情境，意圖不符就重新詢問而非硬套
README.md	「Skills 目錄」的 ask 段落同步描述：意圖欄用途、AI 取用舊答案時依意圖判斷適用性
plugin.json	版本 0.0.1 → 0.0.2
.claude-plugin/plugin.json	版本 0.0.1 → 0.0.2，與主 manifest 同步
.codex-plugin/plugin.json	版本 0.0.1 → 0.0.2，與主 manifest 同步

設計重點

意圖欄位放在節層級：一輪問詢記一個意圖，不放在每題底下，避免重複。
範本是唯一格式來源：SKILL.md 只加強制句，不另外定義格式，避免兩處規格分歧。
讀寫兩端都要顧：意圖欄不只是留檔（寫入端），SKILL.md 的 Before asking 明定 AI 取用舊答案時要用意圖判斷情境是否相符（讀取端），情境不同就重問，不硬套舊答案。
舊紀錄不回填：既有 QUESTION_* 頁面維持原樣，新規則只適用之後的紀錄。

測試結果

無自動化測試；已逐項自查 guidelines.md 審核檢查清單並通過（SKILL.md 為英文、README 與範本為 STE100 繁體中文、UTF-8 編碼、三份 manifest 版本同步）。

前置 Push Request

無

# PR 描述 ## 摘要 - 需求描述：問詢紀錄每節開頭必須記錄使用者的原始意圖與目的。使用者發現 QUESTION_* wiki 紀錄只有選項、影響範圍與答案，之後翻閱看不出當初為什麼問，因此決議修改範本與技能，而不是只補單次紀錄。意圖欄的目的是讓 AI 讀紀錄時能判斷使用者如此選擇的動機，並據此決定舊答案適不適用。 - 計畫名稱：無 - 計畫頁：無 - 分析頁：無 ## 變更內容 | 檔案 | 為什麼改 | | --- | --- | | templates/question-record.md | 在節標題下、Q1 之前加入 `- **意圖**: {使用者的原始需求與目的，一句話，供 AI 判斷選擇動機與答案適用性}`，讓每輪問詢都先記下當初為什麼問 | | skills/ask/SKILL.md | After asking 第 2 步補上「Each section MUST open with the user's original intent…」強制寫入；Before asking 第 3 步補讀取端規則——取用舊答案前先讀該節意圖，判斷答案是否適用當下情境，意圖不符就重新詢問而非硬套 | | README.md | 「Skills 目錄」的 ask 段落同步描述：意圖欄用途、AI 取用舊答案時依意圖判斷適用性 | | plugin.json | 版本 0.0.1 → 0.0.2 | | .claude-plugin/plugin.json | 版本 0.0.1 → 0.0.2，與主 manifest 同步 | | .codex-plugin/plugin.json | 版本 0.0.1 → 0.0.2，與主 manifest 同步 | ## 設計重點 - 意圖欄位放在節層級：一輪問詢記一個意圖，不放在每題底下，避免重複。 - 範本是唯一格式來源：SKILL.md 只加強制句，不另外定義格式，避免兩處規格分歧。 - 讀寫兩端都要顧：意圖欄不只是留檔（寫入端），SKILL.md 的 Before asking 明定 AI 取用舊答案時要用意圖判斷情境是否相符（讀取端），情境不同就重問，不硬套舊答案。 - 舊紀錄不回填：既有 QUESTION_* 頁面維持原樣，新規則只適用之後的紀錄。 ## 測試結果 - 無自動化測試；已逐項自查 guidelines.md 審核檢查清單並通過（SKILL.md 為英文、README 與範本為 STE100 繁體中文、UTF-8 編碼、三份 manifest 版本同步）。 ## 前置 Push Request - 無

jiantw83 added 2 commits 2026-08-21 09:36:37 +00:00

feat(ask): 問詢紀錄每節開頭必記使用者意圖 500890909a

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>

chore(manifest): 版本升至 0.0.2 7d9b430c30

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>

jiantw83 added 1 commit 2026-08-21 09:41:49 +00:00

feat(ask): 意圖欄供 AI 判斷使用者選擇動機並決定舊答案適用性 f8981d08ea

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>

jiantw83 added 1 commit 2026-08-24 01:52:54 +00:00

merge: 合併 develop（統一 wiki hash 規則）到 feat/ask-question-record-intent ec44ec9201

同時保留兩邊變更：develop 的共用 wiki hash 規則說明，與本分支的意圖欄讀寫規則。
README.md 與 skills/ask/SKILL.md 的衝突段落合併成單一句子，不遺漏任一邊的規則。

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

admin merged commit 40f176921b into develop

2026-08-24 02:17:20 +00:00

admin deleted branch feat/ask-question-record-intent

2026-08-24 02:17:20 +00:00

jiantw83 referenced this pull request

2026-08-24 02:20:21 +00:00

chore(ask): 合併 develop 到 master #5

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: plugins/ask#3