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>
This commit is contained in:
@@ -24,7 +24,7 @@ Marketplace 統一為 `jsc`(https://gitea.jsc.idv.tw/plugins/jsc.git),安
|
|||||||
|
|
||||||
### `ask`
|
### `ask`
|
||||||
|
|
||||||
決策樹問詢:一題一個決策點、選項標明影響範圍、問到沒有疑慮為止。問前查 `QUESTION_CONTENTS` 與 `QUESTION_{HASH}`,已有答案不再問;問後套範本寫回 wiki(沒有存取庫名稱就不紀錄)。
|
決策樹問詢:一題一個決策點、選項標明影響範圍、問到沒有疑慮為止。問前查 `QUESTION_CONTENTS` 與 `QUESTION_{HASH}`,已有答案不再問;問後套範本寫回 wiki,每節開頭記錄使用者意圖(沒有存取庫名稱就不紀錄)。
|
||||||
|
|
||||||
<!-- JSC-SKILLS:END -->
|
<!-- JSC-SKILLS:END -->
|
||||||
|
|
||||||
|
|||||||
+1
-1
@@ -24,6 +24,6 @@ Every jsc skill that needs user input MUST follow the rules in this skill.
|
|||||||
## After asking
|
## After asking
|
||||||
|
|
||||||
1. Without a repository name, do not record; stop here.
|
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).
|
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.
|
4. The wiki writes above MUST run as a sub agent; the main agent only confirms the write succeeded.
|
||||||
|
|||||||
@@ -4,6 +4,8 @@
|
|||||||
|
|
||||||
## {yyyy-MM-dd HH:mm} {問詢主題}
|
## {yyyy-MM-dd HH:mm} {問詢主題}
|
||||||
|
|
||||||
|
- **意圖**: {使用者的原始需求與目的,一句話}
|
||||||
|
|
||||||
### Q1: {問題}
|
### Q1: {問題}
|
||||||
|
|
||||||
| 選項 | 影響範圍 |
|
| 選項 | 影響範圍 |
|
||||||
|
|||||||
Reference in New Issue
Block a user