jiantw83
a8e387ad50
技能主文、行為清單、專案說明與界線文件一起改，對齊這一輪的排程修正與 監控頁改版。 工具路徑與監控頁寫法都換了，文件沒跟上就是照舊做法跑：用快取基底目錄 組出來的路徑會被權限靜靜擋掉，那一輪停在沒有人能回答的權限詢問；照舊 的附加語意寫頁，又會把剛換好的三塊寫回一輪一節。 技能主文的工具路徑一律改走 current 那一組不帶版本的路徑，新增 Tool paths 一節列出四支工具，並寫明權限閘門只放行那一組，放行技能不等於放 行技能裡的每一個呼叫。監控頁那幾步改寫成讀回舊頁、基本資料原樣留著、 最新一輪整塊換掉、本輪摘要列擺最上面並截到 24 列，舊格式的頁第一次重 組要在回報裡說明。frontmatter 的 description 重寫並補上單引號，句中有 冒號不加引號會讓解析走偏。界線四從「只附加」改成三塊寫入語意。專案說 明與行為清單同步條目的環境快照、allow 規則、暫存檔名與可驗證跡象。 功能範圍是助理技能的文件與行為合約，不動任何腳本行為。
27 lines
2.0 KiB
Markdown
27 lines
2.0 KiB
Markdown
# 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 輪、基本資料建頁之後不動；目錄頁只動自己那一列，別台機器的列一個字都不碰。軌跡留在摘要表，一輪一列，看得出是從哪一輪開始壞的；完整內容只留最新一輪，因為頁面要能讀完才有人讀。
|
||
5. 不刪除狀態檔、worktree 與 wiki 頁。破壞性操作留給人發動。
|
||
6. 不自動執行自己提出的建議。建議與執行是兩件事，自動接下去等於整條流程沒人按過同意就跑完。
|
||
|
||
## 呼叫慣例
|
||
|
||
Claude Code / Antigravity：`/jsc-assist:{name}`；Codex：`$name`；Copilot / Kiro / OpenCode：描述需求自動觸發。
|