Files
gitea/AGENTS.md
T
jiantw83 73cca6e6ea docs(gitea): README 與 AGENTS 補上盯 PR 與 PR 校準的用法
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 行事的代理。
2026-08-27 11:20:27 +08:00

1.2 KiB
Raw Blame History

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:描述需求自動觸發。