What:README 的指令清單補上 `pr-get`、`pr-edit` 與 `pr-watch.sh` 三項與各自的退出碼,環境變數表補 `JSC_HOME` 與 `JSC_PR_WATCH_INTERVAL`;AGENTS.md 新增一條規則,盯 PR 等合併一律用 `tools/pr-watch.sh`,不要自己寫輪詢迴圈。 Why:新指令沒寫進 README,呼叫端就只能翻腳本原始碼。`pr-watch.sh` 的退出碼 `10` 更要講清楚:它不是錯誤,是「有新留言,換你處理」的交棒訊號,看成錯誤就會把留言吞掉。 How:README 依既有版面把三項排進指令區塊,另補一段說明退出碼 `10` 的設計意圖。AGENTS.md 把新規則插進第 5 條,原第 5 條順延為第 6 條。 Who:讀 `jsc-gitea` 說明的人,以及依 AGENTS.md 行事的代理。
1.2 KiB
1.2 KiB
jsc-gitea — 給 AI 助理的指引
本 repo 是 jsc 技能組的 gitea domain(Gitea API 工具、Wiki 讀寫與存取庫批次同步),可同時被 Claude Code / Codex / Copilot / Antigravity / Kiro 使用。
規則
- 所有交談與輸出內容使用 STE100 繁體中文,帶擬人台灣感:短句、一句一指令、台灣用語、全形標點、去 AI 味、直接講重點。完整規則的唯一來源:
plugins/meta的references/ste100.md。 - 技能位於
skills/{name}/SKILL.md;處理任務前先比對需求與各技能的description,相符就載入並依其步驟執行。 - 技能準則的唯一來源:
plugins/meta存取庫的references/guidelines.md。 - 所有 hook 只放在
jsc-hooks;gitea 操作一律經由jsc-gitea的tools/gitea.sh;問使用者一律依jsc-ask:ask的決策樹規則。 - 盯 PR 等合併用
tools/pr-watch.sh,不要自己寫輪詢迴圈。它回 10 就代表有新留言,把留言接回決策樹處理完,再重新盯一次。 - 主 agent 不需要處理細節的流程,一律建立 sub agent 處理。
呼叫慣例
Claude Code / Antigravity:/jsc-gitea:{name};Codex:$name;Copilot / Kiro / OpenCode:描述需求自動觸發。