 jiantw83
|
e8294f3891
|
feat(ask): 問詢目錄頁改條列式並修正 key-col 參數
What：
把問詢目錄頁 `QUESTION_CONTENTS` 的呈現格式從 markdown 表格改成條列式——每個存取庫一個 H2 區塊，H2 標題就是該存取庫問詢紀錄頁的頁名 `QUESTION_{HASH}`，欄位改成標題底下一層條列 `- {欄位名}：{值}`，順序維持存取庫名稱、問詢紀錄、最後更新，整頁不再留任何 markdown 表格。同一輪把 `wiki-contents.sh upsert QUESTION` 的呼叫參數從 `1 {owner}/{repo}` 改成 `2 QUESTION_{HASH}`。改動落在 `templates/question-contents.md` 的版面與參數語意、`skills/ask/SKILL.md` 與 `references/behaviors.md` 的步驟敘述與可驗證跡象，以及 `README.md` 的技能描述。
Why：
表格版面一列塞滿所有欄位，欄位一長就難讀，每一筆的鍵也埋在儲存格裡；改成一筆一個 H2 區塊之後，鍵就是標題文字，人與工具都直接看得出哪一筆對應哪一個內容頁。`key-col` 原本填 `1`，指到的是純文字的存取庫名稱欄：舊表格自動轉條列時，工具會拿那一欄的連結產生 H2 標題，填 `1` 只會做出 `## plugins/meta` 這種標題，比不到鍵 `QUESTION_{HASH}`，既有那一筆會被當成新的附加上去，同一個存取庫在頁面上出現兩個區塊，舊區塊從此再也更新不到。
How：
`templates/question-contents.md` 的範本主體從表頭加資料列換成 `## QUESTION_{HASH}` 加三條 bullet，引言補上版面段與參數語意段，寫明 `{key}` 是 H2 標題文字、第四個參數帶的是整個區塊的 markdown 而不是單列。`skills/ask/SKILL.md` 把目錄頁那幾條的 row 敘述全部改成 block，呼叫式改為 `upsert QUESTION 2 QUESTION_{HASH} {block-file} templates/question-contents.md`，並說明 `key-col` 為什麼固定是 `2`、填 `1` 會壞成什麼樣，另外在 `wiki-contents.sh` 退 1 的分支補上「頁面上還沒有自己那個區塊不算失敗，那是附加的情形」。`references/behaviors.md` 的關鍵步驟補上區塊檔的組法與參數語意，外部呼叫改成單一 H2 區塊的讀取、合併、寫回，可驗證跡象改成檢查該區塊三條 bullet 的齊全度、順序、全形冒號與整頁不留表格，並補上舊表格轉條列後 H1 與 `>` 引言原樣保留、原有資料一筆不少。`README.md` 的技能描述同步改成條列式的說法。實際的轉檔與 upsert 邏輯在另一個存取庫的 `gitea/tools/wiki-contents.sh`，本存取庫只調整敘述與範本。
Who：
屬於 wiki 目錄頁一律改條列式呈現的需求，`ask` 這一支負責 `QUESTION_CONTENTS` 的範本與敘述。`key-col` 修正是同一個需求能正確落地的必要條件，且與版面敘述改在同一段文字上，無法拆成獨立提交。
|
2026-09-02 17:24:49 +08:00 |
|
|
jiantw83
|
682cc9cf02
|
feat(wiki): 目錄頁改走專用存取庫，HASH 改為完整 40 碼
What：QUESTION_CONTENTS 改由 wiki-repo CONTENTS 解析並透過 wiki-contents.sh
upsert 寫入，QUESTION_{HASH} 仍走 wiki-repo QUESTION。頁名雜湊改為完整 40 碼
大寫，不截短、不加前綴。目錄頁指向紀錄頁的連結改用 wiki-url 的絕對網址。
Why：目錄頁的用途是索引，散在各型別的存取庫就得逐庫翻。集中之後兩頁不再同庫，
[[...]] 只在同一個 wiki 內解析，所以連結必須改絕對網址。
How：目錄頁寫入失敗不再吞掉答案——JSC_WIKI_REPO_CONTENTS 在設定規格表是
fix=ask，只能靠這支技能問到值，答案掉了就永遠問不到，變數也永遠設不起來。
wiki-url 的 4、5、7、8 各自分流，取不到網址就整列不寫。
Who：jsc-ask
|
2026-09-02 11:00:12 +08:00 |
|
|
jiantw83
|
15825a5283
|
docs(ask): 補上目錄頁寫入語意並更新技能說明
What
- 問詢目錄頁範本新增「寫入語意」說明。
- 問詢目錄頁範本的規範指標改指向 jsc-meta 的 references/guidelines.md。
- README 的 ask 技能說明補上工作階段內只讀一次的行為。
Why
- 目錄頁一列代表一個存取庫，由所有存取庫共用。範本只給表格不給寫法，寫入者容易整頁覆寫，抹掉別的存取庫的列。
- 指標指向的規範檔案已經搬到 jsc-meta，舊指標讓讀者找不到來源。
- README 是外部讀者認識這個技能的第一份文件。技能已經改成一個工作階段只讀一次，說明沒跟上就會誤導讀者。
How
- 在目錄頁範本的說明區塊新增一段寫入語意：先讀回整頁，有列就更新該列，沒有才在文末附加，最後整頁寫回；明文禁止整頁覆蓋，也不得改動別人的列。
- 範本的指標改寫成 jsc-meta 的 references/guidelines.md。
- README 的技能段落補一句：兩頁在同一個工作階段只讀一次，之後沿用手上那份，自己寫入後就更新它，問出來的 wiki 存取庫也留在工作階段內重複使用。
Who
- 問詢目錄頁範本，以及存取庫首頁的 ask 技能說明。
|
2026-08-31 11:05:09 +08:00 |
|
 jiantw83andClaude Opus 5
|
aaac910060
|
docs(ask): 同步文件與參考資料
What：更新 README、AGENTS.md、templates 與 references，讓文件敘述與實際行為一致。
Why：稽核發現多處文件與程式行為分歧，違反「每個意義只有單一真實來源」。
How：以實際程式行為為準改寫敘述，重複的規則收成單一來源並以一行指引指過去。
Who：jsc-meta:skill-check 例行稽核（2026-08-25）。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
|
2026-08-25 14:58:54 +08:00 |
|
|
jiantw83andClaude Opus 5
|
27bbae5ccb
|
docs(README): 安裝入口改為 plugins/meta 並補上遷移說明
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
|
2026-08-24 18:00:35 +08:00 |
|
|
jiantw83
|
f40b374342
|
fix(ask): 修正 skill-check 不合規項並升版至 0.0.3
What：修剪 SKILL.md 的 frontmatter description 至 5 句內並補上明確的排除
觸發語句；將 SKILL.md 與兩份範本中重述的 wiki hash 演算法說明，改為指向
canonical 的 `jsc-gitea/tools/hash-id` 工具；同步更新 README.md 的 Skills
目錄描述；三份 manifest 版本號自 0.0.2 升至 0.0.3。
Why：jsc-meta:skill-check 稽核發現 SKILL.md 的 description 超過 5 句且缺少
明確排除觸發語句，且 SKILL.md 與 question-contents.md、question-record.md
重複描述同一套 wiki hash 演算法，違反「委派 canonical 工具、不重複邏輯」
的準則。
How：改寫 skills/ask/SKILL.md 的 description 為精簡版並加入排除語句；三處
重述 hash 演算法的段落，統一改寫為呼叫 `jsc-gitea/tools/hash-id`（演算法
細節見 guidelines.md）；README.md 的 ask 技能描述同步調整；plugin.json、
.claude-plugin/plugin.json、.codex-plugin/plugin.json 版本號 0.0.2 → 0.0.3。
Who：ask 技能本身（skills/ask/SKILL.md 與其範本、manifest）。
|
2026-08-24 14:46:37 +08:00 |
|
|
jiantw83andClaude Sonnet 5
|
ec44ec9201
|
merge: 合併 develop（統一 wiki hash 規則）到 feat/ask-question-record-intent
同時保留兩邊變更：develop 的共用 wiki hash 規則說明，與本分支的意圖欄讀寫規則。
README.md 與 skills/ask/SKILL.md 的衝突段落合併成單一句子，不遺漏任一邊的規則。
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
|
2026-08-24 01:52:50 +00:00 |
|
|
jiantw83
|
d922820451
|
fix(wiki): 統一 QUESTION wiki 命名與 hash 規則
|
2026-08-21 16:53:17 +00:00 |
|
|
jiantw83andClaude Fable 5
|
f8981d08ea
|
feat(ask): 意圖欄供 AI 判斷使用者選擇動機並決定舊答案適用性
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>
|
2026-08-21 09:41:47 +00:00 |
|
|
jiantw83andClaude Fable 5
|
500890909a
|
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>
|
2026-08-21 09:36:29 +00:00 |
|
|
jiantw83andClaude Fable 5
|
2347ddc3ac
|
style(ask): 中文並列改頓號
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
|
2026-08-21 14:28:17 +08:00 |
|
|
jiantw83andClaude Fable 5
|
774373ddba
|
docs(ask): README 安裝/更新/移除改為每指令一行（五個 CLI）並為相關 domain 加上 repo 連結
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
|
2026-08-21 14:03:32 +08:00 |
|
|
jiantw83andClaude Fable 5
|
6d20892f88
|
docs(ask): 以統一格式改寫繁體中文 README 與 AGENTS
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
|
2026-08-21 13:08:43 +08:00 |
|
|
jiantw83
|
6b40e713db
|
Initial commit
|
2026-08-21 04:42:37 +00:00 |
|