jiantw83andClaude Fable 5
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>
2.1 KiB
2.1 KiB
name, description
| name | description |
|---|---|
| ask | Decision-tree questioning until no doubt remains. Check wiki QUESTION_CONTENTS and QUESTION_{HASH} first and never re-ask answered questions. Every option must state its impact scope. After each answer, save the record back to the wiki. Use whenever a jsc skill needs user input; skip recording when no {owner}/{repo} is known. |
ask — decision-tree questioning
Every jsc skill that needs user input MUST follow the rules in this skill.
Before asking
- Confirm the repository name
{owner}/{repo}of the current work. Without one, skip steps 2 and 3: ask directly but do NOT record. - Compute
HASH:printf '%s' "{owner}/{repo}" | sha1sum | cut -c1-8 | tr a-f A-F. - Read
QUESTION_CONTENTSandQUESTION_{HASH}viajsc-gitea:wiki. Never re-ask a question already answered in the record; use the recorded answer directly.
Questioning rules
- Present questions as decision-tree options (AskUserQuestion or an equivalent menu), one decision point at a time.
- One question carries one concept; no compound questions. Ask the most important decision first — you may only get one round of answers.
- Every option MUST state its impact scope (what happens if chosen; which files or flows it affects). Add one "why this matters" line to any question that is easy to misread.
- Let each answer decide the next question. Continue until no doubt remains; keep asking while anything is undecided.
- Ask only what the user alone can answer. Look up answers available in code, config files, or environment variables yourself.
After asking
- Without a repository name, do not record; stop here.
- After each Q&A round, apply
templates/question-record.mdto create or updateQUESTION_{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. - Apply
templates/question-contents.mdto create or updateQUESTION_CONTENTS(add the repository row if missing; otherwise refresh its last-updated time). - The wiki writes above MUST run as a sub agent; the main agent only confirms the write succeeded.