jiantw83
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 落地的第一步，後續的閘門、心跳與排程都接在這個基礎上。
1.4 KiB
1.4 KiB
jsc-assist 技能行為清單
本頁記錄 jsc-assist 每支技能的行為基準，供技能驗證比對。技能異動時，在同一個 PR 內一起更新這一頁。
status
| 項目 | 內容 |
|---|---|
| 觸發時機 | 有人問助理現在還在不在跑，或問待辦簿裡剩下哪幾筆時用。啟動與停止助理不走這支。執行環境健檢不走這支，走 jsc-cli:doctor。技能使用次數不走這支，走 jsc-log:stats |
| 關鍵步驟 | 解出 $JSC_HOME（未設定就退回 ~/.jsc）並組出 assistant/ 目錄、讀 heartbeat 的 ts、pid、cli、session、以 ts 距現在是否不到 300 秒判成新鮮或過期、不看 pid 存活、列出 tasks/ 底下每一個檔案並解析 state、title、next_run、fail_count、把心跳區塊與逐筆待辦印成一張表、fail_count 大於 0 的列標上「已連續失敗 N 次」 |
| 外部呼叫 | 無。只讀 $JSC_HOME/assistant/heartbeat 與 $JSC_HOME/assistant/tasks/ 底下的檔案。不呼叫腳本、不呼叫其他技能、不碰 wiki、不啟動也不停止助理 |
| 完成條件 | 印出現況表，或印出「助理未運行」並說明是哪個路徑讀不到。心跳檔不存在、待辦簿目錄不存在、待辦簿零筆，三種都算正常結束，不得以非 0 結束 |
| 可驗證跡象 | 無寫入跡象，只有回報內容 |