Files
assist/AGENTS.md
T
jiantw83 311cdc611a feat(wiki): 巡檢目錄頁改成一台機器一個大標題區塊
巡檢目錄頁的版面從 markdown 表格換成「大標題加條列」:一台機器一個大標題
區塊,標題就是那一台機器監控頁的實際頁名,欄位改成標題底下的一層條列。
範本、技能敘述、行為清單與說明文件一併跟上,目錄頁上不再留任何表格。

表格的欄位組合是整頁共用的,表頭跟著建頁那一台機器走,之後每一台只改自己
那一列。欄位一增減,只有跑到新版的機器寫得出新的格數,同一張表就混著兩種
格數,多出來的那一格對不到任何欄名,而目錄頁又沒有整頁改寫的路可以走——
整頁覆蓋等於刪掉別台機器的紀錄。條列一筆一個區塊,欄位各自獨立,加一條只
動到自己那一個區塊。

比對鍵從裸雜湊那一格改成大標題本身,標題寫成監控頁的實際頁名。頁名只由
主機名與登入帳號決定,換主機位址、換專用存取庫或換一種頁名編碼都動不到
它;含網址的那一條連結照樣留著給人點,但不當鍵。呼叫改成拿頁名當鍵,欄號
那個參數只在舊表格頁轉檔時用得到。範本原本用二階標題寫的說明區段全部搬進
引言,否則轉檔後會被當成一筆真紀錄讀進去。

範圍是助理的巡檢目錄頁與 assistant 技能的敘述。
2026-09-02 17:21:12 +08:00

2.1 KiB
Raw Blame History

jsc-assist — 給 AI 助理的指引

本 repo 是 jsc 技能組的 assist domain(技能助理:事件收攏、健康巡檢與待辦簿),Claude Code / Codex / Copilot / Antigravity / Kiro 都能安裝使用。

規則

  1. 所有交談與輸出內容使用 STE100 繁體中文,帶擬人台灣感:短句、一句一指令、台灣用語、全形標點、去 AI 味、直接講重點。完整規則的唯一來源:plugins/meta 的 references/ste100.md。
  2. 技能位於 skills/{name}/SKILL.md;處理任務前先比對需求與各技能的 description,相符就載入並依其步驟執行。
  3. 技能準則的唯一來源:plugins/meta 存取庫的 references/guidelines.md。
  4. 所有 hook 只放在 jsc-hooks;gitea 操作一律經由 jsc-gitea 的 tools/gitea.sh;問使用者一律依 jsc-ask:ask 的決策樹規則。
  5. 主 agent 不需要處理細節的流程,一律建立 sub agent 處理。

助理的界線

助理在背景跑,問不到人,所以下面這幾件事一律不做:

  1. 不做任何要問使用者的決策。背景巡檢時靜默套預設值,等於把逐項共識整條做掉。
  2. 不參與閘門判定。閘門必須留在 hook:同步、不連網、毫秒級。助理只負責維持心跳。
  3. 不寫程式碼存取庫、不 commit、不 push、不開 PR、不合併。
  4. 監控頁只照固定三塊寫:最新一輪整塊換掉、摘要表保留近 24 輪、基本資料建頁之後不動;目錄頁一台機器一個 H2 區塊,只動自己那一個區塊,別台機器的區塊一個字都不碰。軌跡留在摘要表,一輪一列,看得出是從哪一輪開始壞的;完整內容只留最新一輪,因為頁面要能讀完才有人讀。
  5. 不刪除狀態檔、worktree 與 wiki 頁。破壞性操作留給人發動。
  6. 不自動執行自己提出的建議。建議與執行是兩件事,自動接下去等於整條流程沒人按過同意就跑完。

呼叫慣例

Claude Code / Antigravity:/jsc-assist:{name};Codex:$name;Copilot / Kiro / OpenCode:描述需求自動觸發。