釋出 jsc-assist 0.0.2：助理 domain 落地與 status 技能 #2

2026-09-01T04:41:13Z

jiantw83 commented

2026-09-01 04:41:13 +00:00

摘要

需求描述：把 jsc-assist domain 的落地成果從功能主幹放行到 develop。內容是樣板改成獨立 domain、第一支唯讀技能 status、監控頁兩份範本，以及自己的 marketplace 副本。
計畫名稱：無
計畫頁：無
分析頁：無

變更內容

檔案	為什麼改
三份 manifest	名稱由 `jsc-template` 改成 `jsc-assist`，版本從新 domain 起始值起算，加上 `jsc.requires`
兩份 marketplace	加入 `jsc-assist` 條目
`README.md`、`AGENTS.md`	依 meta domain 的格式重寫，AGENTS 多一節「助理的界線」
`skills/hello/SKILL.md`	刪除樣板的安裝驗證技能
`skills/status/SKILL.md`	新增。助理現況查詢，全程唯讀
`references/behaviors.md`	新增。技能行為清單
`templates/monitor-contents.md`、`templates/monitor-page.md`	新增。監控頁的目錄頁與內容頁範本，兩者寫入語意相反

設計重點

這一級才會讓改動真的生效。 marketplace 與 version-guard.sh 都讀存放庫的預設分支，停在功能主幹的內容任何 CLI 都看不到。develop 之後還要再進 master 才算走完階梯。
status 全程唯讀，心跳判準只看時間戳、不看 pid 存活，心跳檔不存在時印「助理未運行」而不是報錯。
兩份範本的寫入語意相反：目錄頁只更新自己那一列、禁止整頁覆蓋；內容頁一律附加一節、不覆寫。

測試結果

子功能分支上已跑過並全綠：check-behaviors.sh、lint-frontmatter.sh、ste100-lint.sh 都 exit 0；sync-skill-manifest.sh exit 0；sync-marketplace.sh exit 0，22 份 marketplace 檔位元組一致；comment-scope.sh sweep exit 0。
lint-scripts.sh exit 3：這個 domain 確實沒有 tools/ 也沒有 hooks/，是「無腳本可掃」，不是掃不到的假通過。
各 CLI 的最小提示驗證尚未執行。 jsc-assist 還沒發佈到任何 CLI，裝不上就叫不動。這一支與後續的 develop 併入 master 合併之後，要跑 /jsc-cli:deploy 更新，再在新的工作階段叫 /jsc-assist:status 驗證。

前置 Push Request

無

## 摘要 - 需求描述：把 `jsc-assist` domain 的落地成果從功能主幹放行到 `develop`。內容是樣板改成獨立 domain、第一支唯讀技能 `status`、監控頁兩份範本，以及自己的 marketplace 副本。 - 計畫名稱：無 - 計畫頁：無 - 分析頁：無 ## 變更內容 | 檔案 | 為什麼改 | | --- | --- | | 三份 manifest | 名稱由 `jsc-template` 改成 `jsc-assist`，版本從新 domain 起始值起算，加上 `jsc.requires` | | 兩份 marketplace | 加入 `jsc-assist` 條目 | | `README.md`、`AGENTS.md` | 依 meta domain 的格式重寫，AGENTS 多一節「助理的界線」 | | `skills/hello/SKILL.md` | 刪除樣板的安裝驗證技能 | | `skills/status/SKILL.md` | 新增。助理現況查詢，全程唯讀 | | `references/behaviors.md` | 新增。技能行為清單 | | `templates/monitor-contents.md`、`templates/monitor-page.md` | 新增。監控頁的目錄頁與內容頁範本，兩者寫入語意相反 | ## 設計重點 - **這一級才會讓改動真的生效。** marketplace 與 `version-guard.sh` 都讀存放庫的預設分支，停在功能主幹的內容任何 CLI 都看不到。`develop` 之後還要再進 `master` 才算走完階梯。 - `status` 全程唯讀，心跳判準只看時間戳、不看 pid 存活，心跳檔不存在時印「助理未運行」而不是報錯。 - 兩份範本的寫入語意相反：目錄頁只更新自己那一列、禁止整頁覆蓋；內容頁一律附加一節、不覆寫。 ## 測試結果 - 子功能分支上已跑過並全綠：`check-behaviors.sh`、`lint-frontmatter.sh`、`ste100-lint.sh` 都 exit 0；`sync-skill-manifest.sh` exit 0；`sync-marketplace.sh` exit 0，22 份 marketplace 檔位元組一致；`comment-scope.sh sweep` exit 0。 - `lint-scripts.sh` exit 3：這個 domain 確實沒有 `tools/` 也沒有 `hooks/`，是「無腳本可掃」，不是掃不到的假通過。 - **各 CLI 的最小提示驗證尚未執行。** `jsc-assist` 還沒發佈到任何 CLI，裝不上就叫不動。這一支與後續的 `develop` 併入 `master` 合併之後，要跑 `/jsc-cli:deploy` 更新，再**在新的工作階段**叫 `/jsc-assist:status` 驗證。 ## 前置 Push Request - 無

jiantw83 added 4 commits 2026-09-01 04:41:13 +00:00

feat(assist): 樣板改成 jsc-assist domain，加上 status 技能 6e18a373f3

What：
- 三份 manifest 的 name 由 jsc-template 改成 jsc-assist，version 設為 0.0.1，description 改寫成助理的定位，並加上 jsc.requires 宣告對 jsc-cli、jsc-gitea、jsc-hooks、jsc-log 的最低版本。
- README.md 與 AGENTS.md 依 meta domain 的格式重寫，AGENTS.md 多一節「助理的界線」。
- 刪掉樣板的 hello 技能，新增 status 技能與 references/behaviors.md 行為清單。

Why：
- 這個存取庫原本整份是 template 的樣板，四份 manifest 都還叫 jsc-template。名字沒改，marketplace 認不出它是獨立的 domain，各 CLI 也裝不上。
- 助理的閘門、心跳與巡檢要有落點，前提是存取庫先認得出自己。
- 樣板的 hello 技能只是安裝驗證用，留著會讓助理的技能清單從第一天就帶著一支沒有用途的技能。換成唯讀的 status，行為檢查與 frontmatter 檢查也才有掃描對象。

How：
- status 全程唯讀：讀心跳檔判斷助理在不在跑，判準只看時間戳距現在是否不到 300 秒，不看 pid 存活——五支 CLI 與容器裡的行程互相看不到彼此的 pid。
- 心跳檔不存在時印「助理未運行」，這是正常結果，不以非 0 結束。
- 這支不新增 tools/ 腳本。讀兩個路徑印一張表還不到抽腳本的門檻，助理主體落地時再一併評估。
- 三份 manifest 的 version 由 sync-skill-manifest.sh 同步，README 的技能目錄區塊一起更新。

Who：
助理 domain 落地的第一步，後續的閘門、心跳與排程都接在這個基礎上。

chore(marketplace): 把 jsc-assist 登錄進統一 marketplace 814f28a6b8

What：
- 兩份 marketplace 檔各加一個 jsc-assist 條目，來源網址指向 assist 存取庫。

Why：
- 準則要求每個 domain 存取庫都帶同一份 marketplace 檔，任何一個存取庫都能當註冊入口。少了這個條目，各 CLI 的安裝指令找不到 jsc-assist，sync-domains 也不會把它同步下來。

How：
- 條目由 meta 的 sync-marketplace.sh 產生，同時寫進正本與每個 domain 存取庫的副本，寫完逐檔比對位元組。這一支存取庫的兩份副本就是那一輪的產物。
- 條目依名稱排序，縮排與非 ASCII 描述的處理都交給同一支腳本，不手改 JSON。

Who：
助理 domain 落地的註冊步驟，其餘 domain 存取庫的同一份副本另外送出。

feat(templates): 新增監控頁的目錄頁與內容頁範本 e7e9b8ce18

What：
- 新增 templates/monitor-contents.md 與 templates/monitor-page.md。
- README 的「參考與工具」表補上這兩份範本，說明欄寫出兩者相反的寫入語意。
- 三份 manifest 的版本一起提升。

Why：
- 監控頁是助理巡檢結果的落點。沒有範本，每次巡檢寫出來的格式都不一樣，累積久了看不出趨勢，也對不起來。
- 兩份範本的寫入語意剛好相反，必須各自寫明白。目錄頁是共用的，一列代表一台機器，整頁覆蓋會刪掉別台機器的紀錄；內容頁只屬於一台機器，記的是歷次巡檢的軌跡，所以附加不覆寫。

How：
- 目錄頁範本帶欄位說明與寫入規則：比對主機與帳號兩欄，只更新自己那一列，讀不到舊內容就中止，不硬寫。
- 內容頁範本一次巡檢附加一節，節標題帶時間戳，涵蓋心跳與閘門、使用統計、hook 錯誤、版本落差、階段鎖與工作包鎖、待辦簿到期與逾期六類結果。
- 連續失敗的項目一定要標「已連續失敗 N 次」。待辦簿的項目失敗不會自動暫停，會每輪重試，不標出來就是一個壞掉的項目一直重試而沒人知道。
- 內容以圖表優先，流程用 mermaid、結果用表格，純文字每節最多三句。

Who：
技能助理落地帶出來的頁型別需求，四個存放庫同一批改。

Merge pull request 'feat/assistant-domain-bootstrap/init-and-status-skill' (#1 ) from feat/assistant-domain-bootstrap/init-and-status-skill into feat/assistant-domain-bootstrap/main f09830a636

Reviewed-on: #1

admin merged commit 4b0e4d796c into develop

2026-09-01 04:42:51 +00:00

admin deleted branch feat/assistant-domain-bootstrap/main

2026-09-01 04:42:51 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: plugins/assist#2