 jiantw83
|
b7b1d8bb01
|
docs(skills): 四支階段技能的目錄頁讀取與寫入敘述同步條列版面
What
- `skills/plan`、`skills/analyze`、`skills/implement`、`skills/maintain`：目錄頁的讀取敘述改成從 H2 區塊取值，寫入敘述從「單列 upsert」改成單一 H2 區塊 upsert，鍵補上內容頁頁名這個引數，並註明第四個引數是區塊檔。
- `skills/maintain`：讀寫的鍵改成該存取庫的 `{owner}/{repo}`，因為這個型別沒有內容頁。
- `references/behaviors.md`：四支技能的關鍵步驟、外部呼叫與可驗證跡象同步，跡象從「留下那一列」改成留下那一個 H2 區塊。
- `references/consensus.md`：查已答問題那一條補上問答目錄頁也是條列式版面、要從區塊取值而不是表格列。
- `references/stage-report.md`：目錄頁也算寫入那一段補上「改動一個區塊也算寫過那一頁」，並統一用 `CONTENTS` 這個型別餵進去。
- `README.md`：四支技能的流程敘述與 wiki 規則段同步，並補上五個目錄頁的版面規則、鍵的落點與各頁鍵欄的正確序號。
Why
- 範本已經改成條列版面，技能內文還寫著「那一列」，執行時就會照舊敘述組出表格列，跟工具的單一區塊 upsert 對不上。
- 讀取端的敘述沒跟著改，技能會拿表格的解析方式去讀一頁條列，既有紀錄一筆都認不出來。
- 呼叫少帶鍵這個引數，工具無從判斷要換掉哪一個區塊，同一筆會被當成新的附加上去。
- 行為清單是稽核與驗證的比對基準，敘述沒跟上，稽核會拿舊描述判合規。
How
- 四支技能的呼叫一律寫成 `wiki-contents.sh upsert {TYPE} {鍵欄} "{鍵}" {區塊檔} [{範本}]`，各頁的鍵欄序號照線上那一頁實際的欄位排法寫定。
- 完成條件與可驗證跡象改用區塊的說法，連結範例改成 `- {欄位名}：[{頁名}]({連結})` 的形態。
- 只改敘述與說明，不動任何腳本；轉檔與 upsert 的實作在別的存取庫。
Who
- 本存取庫四支階段技能，以及讀這幾份說明檔決定共識判定與階段回報寫法的流程。
- 稽核與驗證流程改拿新的行為清單比對。
|
2026-09-02 17:21:10 +08:00 |
|
|
jiantw83
|
f38d1f3087
|
feat(狀態回報): 收尾寫一筆 skill-end 事件
現行紀錄只記「被叫用」，沒有成敗也沒有結束碼。跑完整輪的技能與開場就
中止的技能，在紀錄裡長得一模一樣。
start 由技能用量 hook 順手發，不必改技能文件。end 只能由技能自己在收尾
步驟寫——hook 接在技能工具呼叫上，而實際工作發生在之後的模型輪次，它在
原理上看不到成敗。有 start 沒有配對的 end，就是那一輪中止了。
status 五選一，每支技能各自寫明什麼情況選哪一個。找不到回報腳本就安靜
跳過，回報失敗一律不改變技能自己的結論。
|
2026-09-02 16:01:18 +08:00 |
|
|
jiantw83
|
f4e489ceb4
|
feat(link): 連結一律寫成 [文字](絕對網址)，寫入前先驗證連得到
取消 [[頁名]] 與 [[顯示文字|頁名]] 兩種同 wiki 寫法，不再分「同存取庫」與
「跨存取庫」兩條規則。那種寫法只在自己那個 wiki 內解析，寫錯不報錯，畫面上
看起來像普通文字或死連結，巡不到也修不了。
連結寫進頁面前先過 jsc-gitea 的 link-check.sh，結束碼 0 才寫。驗證一律走 API，
不看網頁狀態碼：私有存取庫的網頁網址對未登入請求一律回 404，拿狀態碼判會把
好連結判成壞的。認證失敗回 7，與死連結的 1 分開，免得金鑰一過期就把還在的頁
整批判死。
|
2026-09-02 14:27:18 +08:00 |
|
|
jiantw83
|
77e7504982
|
docs(sdlc): 參考文件與 README 同步階梯、工作包隔離與日誌粒度
What：`references/branch.md` 新增「分支階梯與 base 推導」一節（只寫拿到 `jsc-git/tools/base-branch.sh --derive` 回應之後要做什麼）與「工作包隔離」一節（歸屬依據、狀態檔欄位、誰寫誰讀、查無歸屬放行、逃生門），閘門分工那一表補上 `claim`、`lock`、`owns`。`references/stage-report.md` 改寫暫存那一節，講明本節只適用於「還沒完成任何任務就停下」的階段。README 的工具表、`implement` 與 `maintain` 兩段說明、參考文件表與相依技能清單同步更新。
Why：階梯表與歸屬狀態檔的正本各有其處——階梯在 `jsc-meta` 的 `references/guidelines.md`，狀態檔格式在 `jsc-hooks`。抄第二份就會有兩份互相打架的規則，但完全不提又會讓實作階段不知道拿到 `7` 或「已建立功能主幹」時該做什麼。
How：兩節都只寫本階段要做的事，並把唯一來源用連結指出去。`branch.md` 的階梯那一節寫成一張「腳本回應 → 這個階段要做的事」對照表，`7` 明寫成「中止並問使用者，不退回 `develop`」。`stage-report.md` 補一句「暫存不等於已寫入」，因為日誌改成一個任務一筆之後，做完事情的階段本來就有日誌可連。
Who：讀 `jsc-sdlc` 參考文件與 README 的人，以及跑實作與維護兩階段的工作階段。
|
2026-08-27 11:20:30 +08:00 |
|
 jiantw83andClaude Opus 5
|
4a4feaf6ef
|
feat(sdlc): 四階段收尾一律回報
What：新增 tools/stage-report.sh 與 references/stage-report.md，四支階段技能各加一步收尾回報：模型能力標籤判定、工作日誌連結、所有寫入的 wiki 連結；實作階段再加工作目錄與來源、工作、目標三條分支。
Why：階段跑完該交代什麼是固定的，寫在內文靠模型自己記，少一項看不出來。沒寫工作日誌更是如此——內容只留在對話裡，換一個工作階段就沒了。
How：彙整搬到程式層。頁名換絕對網址、commit 數與推送狀態由 git 現查、來源分支在不在遠端也由腳本判定；模型閘門那一列只轉述 sdlc-gate.sh report，不自評。沒有工作日誌就警告使用者檢查，並把內容交給 jsc-log 的暫存區，下次寫日誌一併寫入。結束碼 1 是警告不是阻擋，提前停下來也要回報。
Who：跑 SDLC 四階段的人，以及接手看紀錄的人。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
|
2026-08-26 09:19:43 +08:00 |
|