jiantw83
73cca6e6ea
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 行事的代理。
17 lines
1.2 KiB
Markdown
17 lines
1.2 KiB
Markdown
# jsc-gitea — 給 AI 助理的指引
|
||
|
||
本 repo 是 jsc 技能組的 `gitea` domain（Gitea API 工具、Wiki 讀寫與存取庫批次同步），可同時被 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. 盯 PR 等合併用 `tools/pr-watch.sh`，不要自己寫輪詢迴圈。它回 10 就代表有新留言，把留言接回決策樹處理完，再重新盯一次。
|
||
6. 主 agent 不需要處理細節的流程，一律建立 sub agent 處理。
|
||
|
||
## 呼叫慣例
|
||
|
||
Claude Code / Antigravity：`/jsc-gitea:{name}`；Codex：`$name`；Copilot / Kiro / OpenCode：描述需求自動觸發。
|