From 500890909a9da63327cc0edd86fdc79cc6b80283 Mon Sep 17 00:00:00 2001 From: Jeffery Date: Fri, 21 Aug 2026 09:36:29 +0000 Subject: [PATCH] =?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: {問題} | 選項 | 影響範圍 |