新增 herdr-issue skill，並將 plugin 模板改名為 herdr-issue
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
Jeffery
co-authored by
Claude Sonnet 5.5
Claude Sonnet 5.5
parent
ee8294922b
commit
90c446687a
@@ -1,38 +0,0 @@
|
||||
---
|
||||
name: hello
|
||||
description: 範例 skill，用來驗證 jsc plugin 是否安裝成功，也是新增 skill 的範本。當使用者輸入 hello、想測試 plugin、或想看 skill 模板長什麼樣子時觸發；回覆一句問候並簡述此 plugin 的用途。
|
||||
---
|
||||
|
||||
# hello（範例 skill）
|
||||
|
||||
這是 `jsc-template` plugin 的範例 skill。它有兩個用途：
|
||||
|
||||
1. **驗證安裝** — 跨各家 AI 助理確認 skill 已被正確載入。
|
||||
2. **作為範本** — 複製這個資料夾即可新增一個新的 skill。
|
||||
|
||||
## 呼叫方式
|
||||
|
||||
| 助理 | 呼叫方式 |
|
||||
| --- | --- |
|
||||
| Claude Code | `/jsc-template:hello` |
|
||||
| Antigravity | `/jsc-template:hello`，或描述需求自動觸發 |
|
||||
| Codex | 在提示詞輸入 `$hello`，或用 `/skills` 選單 |
|
||||
| OpenCode | 直接描述需求，模型會透過 skill 工具自動呼叫 |
|
||||
| GitHub Copilot CLI | 直接描述需求，Copilot 會讀取已安裝 plugin 的 skills |
|
||||
|
||||
## 行為
|
||||
|
||||
當這個 skill 被觸發時：
|
||||
|
||||
1. 回覆「Hello from **jsc** 👋」。
|
||||
2. 用一句話說明 `jsc-template` 是一個跨 AI 助理的共用 skill 集合。
|
||||
3. 提示使用者可以在 README 的「Skills 目錄」查看所有可用的 skills。
|
||||
|
||||
## 如何以此為範本新增 skill
|
||||
|
||||
1. 複製 `skills/hello/` 為 `skills/<your-skill-name>/`。
|
||||
2. 修改 `SKILL.md` 的 frontmatter：
|
||||
- `name`：小寫、數字、連字號（`-`），最長 64 字元。**這個名稱會成為 Claude Code / Antigravity 的 `/jsc-template:<name>` 指令**。
|
||||
- `description`：第三人稱，寫清楚「什麼時候該用、什麼時候不該用」與觸發關鍵字 — 各家助理靠這段文字決定是否自動載入。
|
||||
3. 在內文寫下 skill 的具體步驟。
|
||||
4. 手動把新 skill 補進 README 的「Skills 目錄」區塊。
|
||||
@@ -0,0 +1,54 @@
|
||||
---
|
||||
name: herdr-issue
|
||||
description: "Run Gitea issues through Herdr: one Claude agent per issue in its own worktree and tab, watch the issue to closure, then offer the next unblocked issues. Use only when the user runs /herdr-issue or explicitly asks to drive a Gitea issue or repo link with Herdr."
|
||||
---
|
||||
|
||||
# herdr-issue
|
||||
|
||||
把 Gitea 議題交給 Herdr 裡的 Claude agent 實作。所有確定性的工作都在 `scripts/` 裡，你只在「要做決定」的時刻出手。腳本都要在該 repo 的 clone 裡執行；`S` 代表 `~/.claude/skills/herdr-issue/scripts`。
|
||||
|
||||
## 語言規則
|
||||
|
||||
本技能的所有回覆、提問、通知與輸出訊息一律使用繁體中文（程式碼、指令、識別字除外）。
|
||||
|
||||
## 前置檢查
|
||||
|
||||
1. `test "${HERDR_ENV:-}" = 1`，不成立就說明不在 Herdr 裡並停止。
|
||||
2. 解析輸入：
|
||||
- 議題連結 `https://gitea.jsc.idv.tw/<owner>/<repo>/issues/<N>` → 流程 A。
|
||||
- `#N` → 用目前 clone 的 origin 推出 owner/repo，流程 A。
|
||||
- repo 連結 `https://gitea.jsc.idv.tw/<owner>/<repo>` → 流程 B。
|
||||
3. 目前目錄必須是該 repo 的 clone（腳本會比對 origin）。不是就告訴使用者要在哪個目錄執行並停止。
|
||||
4. 提醒一句：這個 session 要保持開著，監看與下一步推薦都靠它。
|
||||
|
||||
## 流程 A：啟動一個議題
|
||||
|
||||
1. `S/start.sh <owner/repo> <N>`。它會建 worktree `../<repo>-issue-N`（分支已存在就接續）、開 tab `#N`、啟動 `issue-N` agent、送提示詞（`scripts/prompt.txt`）、掛 `in-progress` 標籤。最後一行是 JSON。失敗訊息在 stderr，照實轉述。
|
||||
2. 在**背景**執行 `S/watch-issue.sh <owner/repo> <N>`（Bash 的 `run_in_background`）。它會阻塞到議題關閉，期間 agent blocked 或消失會彈 Herdr 通知；關閉後自己關 tab、清 worktree 與分支、拿掉標籤、往上檢查規格與總覽能不能關。結束時你會被叫醒。
|
||||
3. 做一次「推薦下一步」。
|
||||
|
||||
## 流程 B：從 repo 挑議題
|
||||
|
||||
1. `S/ready.sh <owner/repo>`。
|
||||
2. 用多選問題列出「可執行」的議題，每項標題帶規格標籤；同一規格的議題在描述裡註明「同規格，PR 可能互相衝突」。「掛 in-progress 但沒有 agent」的議題另列一題，說明重跑會接續先前分支。
|
||||
3. 勾選的每一個議題各走流程 A 的第 1、2 步，全部啟動後做一次「推薦下一步」。
|
||||
|
||||
## 推薦下一步
|
||||
|
||||
`S/ready.sh <owner/repo>` 再跑一次（剛啟動的議題已經在執行中，會被排除），結果用多選問題呈現，格式同流程 B。沒勾就什麼都不做。
|
||||
|
||||
## 被 watch-issue.sh 叫醒時
|
||||
|
||||
把它印出的清理摘要（PR 狀態、分支去留、規格與總覽是否關閉）用兩三句轉述，然後「推薦下一步」。
|
||||
|
||||
## 腳本一覽
|
||||
|
||||
| 腳本 | 給誰 | 做什麼 |
|
||||
| --- | --- | --- |
|
||||
| `ready.sh` | 你 | 列出可執行、執行中、被阻擋的議題 |
|
||||
| `start.sh` | 你 | 建 worktree、開 tab、啟動 agent、送提示詞、掛標籤 |
|
||||
| `watch-issue.sh` | 你（背景） | 等議題關閉，清理，往上關規格與總覽 |
|
||||
| `tick.sh` | 子 agent | 勾議題內文第 k 個核取方塊 |
|
||||
| `pr-wait.sh` | 子 agent（背景） | 等 PR 衝突、關閉或合併 |
|
||||
|
||||
環境變數：`HERDR_ISSUE_INTERVAL`（pr-wait 輪詢秒數，預設 300）、`HERDR_ISSUE_WATCH_INTERVAL`（watch-issue 輪詢秒數，預設 5）、`HERDR_ISSUE_BLOCKED_AFTER`（blocked 多久才通知，預設 60 秒）、`HERDR_ISSUE_MODEL`（預設 `claude-opus-5-5`）。
|
||||
Executable
+81
@@ -0,0 +1,81 @@
|
||||
#!/usr/bin/env bash
|
||||
# herdr-issue 共用函式。每個腳本都 source 這個檔。
|
||||
set -euo pipefail
|
||||
|
||||
LABEL="in-progress"
|
||||
LABEL_COLOR="0e8a16"
|
||||
LABEL_DESC="Herdr 的 agent 正在實作"
|
||||
INTERVAL="${HERDR_ISSUE_INTERVAL:-300}"
|
||||
MODEL="${HERDR_ISSUE_MODEL:-claude-opus-5-5}"
|
||||
SCRIPTS="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
||||
|
||||
die() { echo "herdr-issue: $*" >&2; exit 1; }
|
||||
|
||||
# 從 stdin 讀 JSON，執行 python 片段，d 是解析後的物件。
|
||||
jq_py() { python3 -c "import sys,json
|
||||
def find(o,k):
|
||||
if isinstance(o,dict):
|
||||
if k in o: return o[k]
|
||||
for v in o.values():
|
||||
r=find(v,k)
|
||||
if r is not None: return r
|
||||
elif isinstance(o,list):
|
||||
for v in o:
|
||||
r=find(v,k)
|
||||
if r is not None: return r
|
||||
return None
|
||||
d=json.load(sys.stdin)
|
||||
$1"; }
|
||||
|
||||
# 議題的完整 JSON（state、labels、body、title、closedAt）。
|
||||
issue_json() { tea issues "$2" --repo "$1" --output json; }
|
||||
|
||||
issue_state() { issue_json "$1" "$2" | jq_py 'print(d["state"])'; }
|
||||
|
||||
issue_labels() { issue_json "$1" "$2" | jq_py 'print("\n".join(l["name"] for l in d.get("labels") or []))'; }
|
||||
|
||||
# 某個標籤底下還有幾個 open 議題。
|
||||
open_count_with_label() {
|
||||
tea issues list --repo "$1" --state open --labels "$2" --limit 500 --output json --fields index \
|
||||
| jq_py 'print(len(d))'
|
||||
}
|
||||
|
||||
ensure_label() {
|
||||
if ! tea labels list --repo "$1" --output json | jq_py "sys.exit(0 if any(l['name']=='$LABEL' for l in d) else 1)"; then
|
||||
tea labels create --repo "$1" --name "$LABEL" --color "$LABEL_COLOR" --description "$LABEL_DESC" >/dev/null
|
||||
fi
|
||||
}
|
||||
|
||||
# agent 狀態：idle|working|blocked|done|unknown|missing
|
||||
agent_status() {
|
||||
herdr agent get "issue-$1" 2>/dev/null | jq_py 'print(find(d,"agent_status") or "unknown")' 2>/dev/null || echo missing
|
||||
}
|
||||
|
||||
# 標籤為 #N 的 tab ID，沒有就空字串。
|
||||
tab_for_issue() {
|
||||
herdr tab list --workspace "${HERDR_WORKSPACE_ID:?}" \
|
||||
| jq_py "print(next((t['tab_id'] for t in find(d,'tabs') or [] if t.get('label')=='#$1'),''))"
|
||||
}
|
||||
|
||||
# worktree 路徑：clone 同層的 <repo>-issue-N
|
||||
worktree_path() { echo "$(dirname "$2")/$(basename "$2")-issue-$1"; }
|
||||
|
||||
notify() { herdr notification show "$1" --body "$2" --sound "${3:-request}" >/dev/null 2>&1 || true; }
|
||||
|
||||
# 目前目錄必須是 owner/repo 的 clone；印出 clone 根目錄。
|
||||
clone_root_for() {
|
||||
local root url
|
||||
root="$(git rev-parse --show-toplevel 2>/dev/null)" || die "目前目錄不是 git repo，請在 $1 的 clone 裡執行"
|
||||
url="$(git -C "$root" remote get-url origin 2>/dev/null || true)"
|
||||
case "$url" in
|
||||
*"$1"|*"$1.git"|*"$1/") echo "$root" ;;
|
||||
*) die "目前 clone 的 origin 是 $url，不是 $1" ;;
|
||||
esac
|
||||
}
|
||||
|
||||
# head 分支為 issue-N 的最新 PR：印出「index state」或空字串。
|
||||
pr_for_issue() {
|
||||
tea pulls list --repo "$1" --state all --limit 500 --output json --fields index,state,mergeable,head \
|
||||
| jq_py "m=[p for p in d if p.get('head')=='issue-$2']
|
||||
print(' '.join([m[0]['index'],m[0]['state'],str(m[0].get('mergeable'))]) if m else '')"
|
||||
}
|
||||
Executable
+25
@@ -0,0 +1,25 @@
|
||||
#!/usr/bin/env bash
|
||||
# 用法：pr-wait.sh <owner/repo> <N>
|
||||
# 阻塞到 head 為 issue-N 的 PR 有衝突、被關閉或合併，或議題被關閉。
|
||||
# 最後一行印出原因：conflict | closed | merged | issue-closed
|
||||
source "$(dirname "$0")/lib.sh"
|
||||
REPO="${1:?}"; N="${2:?用法：pr-wait.sh <owner/repo> <N>}"
|
||||
while :; do
|
||||
read -r PR STATE MERGEABLE <<<"$(pr_for_issue "$REPO" "$N")" || true
|
||||
if [ -z "${PR:-}" ]; then
|
||||
echo "還沒有 head 為 issue-$N 的 PR，$INTERVAL 秒後再查"
|
||||
else
|
||||
case "$STATE" in
|
||||
merged) echo "PR #$PR 已合併"; echo merged; exit 0 ;;
|
||||
closed) echo "PR #$PR 被關閉（未合併）"; echo closed; exit 0 ;;
|
||||
open)
|
||||
if [ "$MERGEABLE" = "false" ]; then
|
||||
sleep 60
|
||||
read -r _ _ AGAIN <<<"$(pr_for_issue "$REPO" "$N")"
|
||||
if [ "$AGAIN" = "false" ]; then echo "PR #$PR 與 main 有衝突"; echo conflict; exit 0; fi
|
||||
fi ;;
|
||||
esac
|
||||
fi
|
||||
if [ "$(issue_state "$REPO" "$N")" = "closed" ]; then echo "議題 #$N 已關閉"; echo issue-closed; exit 0; fi
|
||||
sleep "$INTERVAL"
|
||||
done
|
||||
@@ -0,0 +1,17 @@
|
||||
/mattpocock-skills:implement {LINK}
|
||||
|
||||
你在分支 issue-{N} 的 worktree 裡，從 origin/main 建立，請在這裡實作，不要另外建 worktree。
|
||||
{RESUME}
|
||||
規則：
|
||||
0. 所有回覆、commit 訊息、PR 標題與描述、議題留言一律使用繁體中文（程式碼與指令除外）。
|
||||
1. 議題的代辦項目是內文 Acceptance criteria 的核取方塊。每完成一項就執行
|
||||
{S}/tick.sh {REPO} {N} <第幾項>（從第一個核取方塊數起，已勾的也算）
|
||||
它會重新讀取最新內文再改，不要自己用 tea issues edit 重寫整段。
|
||||
2. 全部完成後推送分支並建立 PR 回 main：
|
||||
tea pulls create --repo {REPO} --base main --head issue-{N} --title "<標題>" --description "<摘要>
|
||||
|
||||
Closes #{N}"
|
||||
3. 然後在背景執行 {S}/pr-wait.sh {REPO} {N}，它會在 PR 有衝突、被關閉或合併時結束並印出原因：
|
||||
- conflict：git fetch origin && git merge origin/main，用 /mattpocock-skills:resolving-merge-conflicts 解決，跑測試，推送，再執行一次 pr-wait.sh。
|
||||
- closed：tea issues close --repo {REPO} {N}，結束。
|
||||
- merged 或 issue-closed：結束。
|
||||
Executable
+64
@@ -0,0 +1,64 @@
|
||||
#!/usr/bin/env python3
|
||||
"""列出可執行的議題。輸入：open.json agents.json tabs.json"""
|
||||
import json, re, sys
|
||||
|
||||
open_issues = json.load(open(sys.argv[1]))
|
||||
agents = json.load(open(sys.argv[2]))
|
||||
tabs = json.load(open(sys.argv[3]))
|
||||
|
||||
def find(o, k):
|
||||
if isinstance(o, dict):
|
||||
if k in o: return o[k]
|
||||
for v in o.values():
|
||||
r = find(v, k)
|
||||
if r is not None: return r
|
||||
elif isinstance(o, list):
|
||||
for v in o:
|
||||
r = find(v, k)
|
||||
if r is not None: return r
|
||||
|
||||
def labels(i): return [l.strip() for l in (i.get("labels") or "").split() if l.strip()] if isinstance(i.get("labels"), str) else [l["name"] for l in i.get("labels") or []]
|
||||
|
||||
open_idx = {i["index"] for i in open_issues}
|
||||
by_idx = {i["index"]: i for i in open_issues}
|
||||
|
||||
# Herdr 裡活著的 agent：名稱 issue-N，或掛在標籤 #N 的 tab 上
|
||||
running = set()
|
||||
for a in find(agents, "agents") or []:
|
||||
m = re.fullmatch(r"issue-(\d+)", str(a.get("name") or ""))
|
||||
if m: running.add(m.group(1))
|
||||
agent_tabs = {a.get("tab_id") for a in find(agents, "agents") or []}
|
||||
for t in find(tabs, "tabs") or []:
|
||||
m = re.fullmatch(r"#(\d+)", str(t.get("label") or ""))
|
||||
if m and t.get("tab_id") in agent_tabs: running.add(m.group(1))
|
||||
|
||||
def blockers(i):
|
||||
m = re.search(r"Blocked by:\s*([^\n]*)", i.get("body") or "")
|
||||
return re.findall(r"#(\d+)", m.group(1)) if m else []
|
||||
|
||||
def spec(i):
|
||||
return next((l for l in labels(i) if l.startswith("規格/#") or l.startswith("總覽/#")), "")
|
||||
|
||||
runnable, blocked, stale = [], [], []
|
||||
for i in sorted(open_issues, key=lambda x: int(x["index"])):
|
||||
ls = labels(i)
|
||||
if "ready-for-agent" not in ls: continue
|
||||
if "類型/規格" in ls or "類型/總覽" in ls: continue
|
||||
n = i["index"]
|
||||
if n in running: continue
|
||||
if "in-progress" in ls:
|
||||
stale.append(n); continue
|
||||
open_blockers = [b for b in blockers(i) if b in open_idx]
|
||||
if open_blockers:
|
||||
blocked.append((n, open_blockers)); continue
|
||||
runnable.append((n, spec(i), i["title"]))
|
||||
|
||||
print(f"可執行（{len(runnable)}）：編號\t規格\t標題")
|
||||
for n, s, t in runnable:
|
||||
print(f"#{n}\t{s}\t{t}")
|
||||
print()
|
||||
print("Herdr 執行中：" + (" ".join(f"#{n}" for n in sorted(running, key=int)) or "無"))
|
||||
if stale:
|
||||
print("掛 in-progress 但沒有 agent（需處理，重跑 start 會接續）：" + " ".join(f"#{n}" for n in stale))
|
||||
if blocked:
|
||||
print("被阻擋：" + " ".join(f"#{n}←{','.join('#'+b for b in bs)}" for n, bs in blocked))
|
||||
Executable
+10
@@ -0,0 +1,10 @@
|
||||
#!/usr/bin/env bash
|
||||
# 用法：ready.sh <owner/repo>
|
||||
# 列出可執行的議題（open、ready-for-agent、blocker 全關、Herdr 沒在跑、沒掛 in-progress）。
|
||||
source "$(dirname "$0")/lib.sh"
|
||||
REPO="${1:?用法：ready.sh <owner/repo>}"
|
||||
T="$(mktemp -d)"; trap 'rm -rf "$T"' EXIT
|
||||
tea issues list --repo "$REPO" --state open --limit 500 --output json --fields index,title,labels,body > "$T/open.json"
|
||||
herdr agent list > "$T/agents.json"
|
||||
herdr tab list --workspace "${HERDR_WORKSPACE_ID:?}" > "$T/tabs.json"
|
||||
python3 "$SCRIPTS/ready.py" "$T/open.json" "$T/agents.json" "$T/tabs.json"
|
||||
Executable
+49
@@ -0,0 +1,49 @@
|
||||
#!/usr/bin/env bash
|
||||
# 用法：start.sh <owner/repo> <N>
|
||||
# 在目前 clone 旁建 worktree、開 Herdr tab、啟動 claude、送提示詞、掛 in-progress 標籤。
|
||||
# 最後一行印出 JSON：{"tab":..,"pane":..,"path":..,"resumed":..}
|
||||
source "$(dirname "$0")/lib.sh"
|
||||
REPO="${1:?}"; N="${2:?用法：start.sh <owner/repo> <N>}"
|
||||
LINK="https://gitea.jsc.idv.tw/$REPO/issues/$N"
|
||||
test "${HERDR_ENV:-}" = 1 || die "不在 Herdr 裡（HERDR_ENV≠1）"
|
||||
CLONE="$(clone_root_for "$REPO")"
|
||||
BRANCH="issue-$N"
|
||||
WT="$(worktree_path "$N" "$CLONE")"
|
||||
|
||||
if [ "$(agent_status "$N")" != missing ]; then
|
||||
die "issue-$N 的 agent 還活著（tab $(tab_for_issue "$N")），不重複啟動"
|
||||
fi
|
||||
[ "$(issue_state "$REPO" "$N")" = open ] || die "#$N 不是 open"
|
||||
|
||||
git -C "$CLONE" fetch --quiet origin
|
||||
RESUMED=false
|
||||
if git -C "$CLONE" show-ref --verify --quiet "refs/heads/$BRANCH"; then
|
||||
RESUMED=true
|
||||
if ! git -C "$CLONE" worktree list --porcelain | grep -qx "worktree $WT"; then
|
||||
git -C "$CLONE" worktree add --quiet "$WT" "$BRANCH"
|
||||
fi
|
||||
else
|
||||
git -C "$CLONE" worktree add --quiet -b "$BRANCH" "$WT" origin/main
|
||||
fi
|
||||
|
||||
TAB_JSON="$(herdr tab create --workspace "${HERDR_WORKSPACE_ID:?}" --cwd "$WT" --label "#$N" --no-focus)"
|
||||
TAB="$(jq_py 'print(find(d,"tab")["tab_id"])' <<<"$TAB_JSON")"
|
||||
PANE="$(jq_py 'print(find(d,"root_pane")["pane_id"])' <<<"$TAB_JSON")"
|
||||
|
||||
for _ in 1 2 3 4 5 6; do
|
||||
if herdr agent start "issue-$N" --kind claude --pane "$PANE" --timeout 90000 -- --model "$MODEL" >/dev/null 2>"$WT/.herdr-start.err"; then
|
||||
rm -f "$WT/.herdr-start.err"; break
|
||||
fi
|
||||
sleep 2
|
||||
done
|
||||
[ -f "$WT/.herdr-start.err" ] && { cat "$WT/.herdr-start.err" >&2; herdr tab close "$TAB" >/dev/null; die "agent 啟動失敗"; }
|
||||
|
||||
if $RESUMED; then RESUME_LINE="分支已有先前進度，先看 git log 和議題核取方塊再接續。"; else RESUME_LINE=""; fi
|
||||
PROMPT="$(sed -e "s|{LINK}|$LINK|g" -e "s|{REPO}|$REPO|g" -e "s|{N}|$N|g" -e "s|{S}|$SCRIPTS|g" -e "s|{RESUME}|$RESUME_LINE|" "$SCRIPTS/prompt.txt")"
|
||||
herdr agent prompt "issue-$N" "$PROMPT" >/dev/null
|
||||
|
||||
ensure_label "$REPO"
|
||||
tea issues edit "$N" --repo "$REPO" --remove-labels "$LABEL" >/dev/null 2>&1 || true
|
||||
tea issues edit "$N" --repo "$REPO" --add-labels "$LABEL" >/dev/null
|
||||
|
||||
printf '{"tab":"%s","pane":"%s","path":"%s","resumed":%s}\n' "$TAB" "$PANE" "$WT" "$RESUMED"
|
||||
Executable
+18
@@ -0,0 +1,18 @@
|
||||
#!/usr/bin/env bash
|
||||
# 用法：tick.sh <owner/repo> <N> <第幾項>
|
||||
# 把議題內文第 k 個核取方塊（已勾的也算在內）改成「[x]」。每次都重新讀取最新內文再改。
|
||||
source "$(dirname "$0")/lib.sh"
|
||||
REPO="${1:?}"; N="${2:?}"; K="${3:?用法：tick.sh <owner/repo> <N> <第幾項>}"
|
||||
NEW="$(issue_json "$REPO" "$N" | python3 -c "
|
||||
import sys,json,re
|
||||
body=json.load(sys.stdin)['body']
|
||||
k=int(sys.argv[1]); i=[0]
|
||||
def rep(m):
|
||||
i[0]+=1
|
||||
return '[x]' if i[0]==k else m.group(0)
|
||||
out=re.sub(r'\[[ xX]\]', rep, body)
|
||||
if i[0]<k: sys.exit('只有 %d 個核取方塊，沒有第 %d 個' % (i[0],k))
|
||||
sys.stdout.write(out)
|
||||
" "$K")"
|
||||
tea issues edit "$N" --repo "$REPO" --description "$NEW" >/dev/null
|
||||
echo "#$N 第 $K 項已勾選，剩 $(grep -o '\[ \]' <<<"$NEW" | wc -l) 項"
|
||||
Executable
+70
@@ -0,0 +1,70 @@
|
||||
#!/usr/bin/env bash
|
||||
# 用法：watch-issue.sh <owner/repo> <N>（在 clone 裡以背景執行）
|
||||
# 每 HERDR_ISSUE_WATCH_INTERVAL 秒（預設 5）查議題；agent blocked 超過 HERDR_ISSUE_BLOCKED_AFTER 秒（預設 60，只通知一次）或消失就彈 Herdr 通知；議題關閉時清理並往上檢查規格、總覽。
|
||||
source "$(dirname "$0")/lib.sh"
|
||||
REPO="${1:?}"; N="${2:?用法：watch-issue.sh <owner/repo> <N>}"
|
||||
CLONE="$(clone_root_for "$REPO")"
|
||||
BRANCH="issue-$N"
|
||||
WT="$(worktree_path "$N" "$CLONE")"
|
||||
LAST=""
|
||||
WATCH_INTERVAL="${HERDR_ISSUE_WATCH_INTERVAL:-5}" # 輪詢秒數（不耗額度，只查 Gitea 與 Herdr）
|
||||
BLOCKED_AFTER="${HERDR_ISSUE_BLOCKED_AFTER:-60}" # blocked 連續超過幾秒才通知
|
||||
BLOCKED_SINCE=0
|
||||
NOTIFIED=false
|
||||
|
||||
# 若 <label> 底下沒有 open 議題，留言並關閉議題 X；印出 closed|open|skip
|
||||
close_if_done() { # $1=X $2=label
|
||||
[ "$(issue_state "$REPO" "$1")" = open ] || { echo skip; return; }
|
||||
if [ "$(open_count_with_label "$REPO" "$2")" = 0 ]; then
|
||||
tea comment "$1" --repo "$REPO" "底下的議題全部關閉，由 herdr-issue 自動關閉。" >/dev/null
|
||||
tea issues close "$1" --repo "$REPO" >/dev/null
|
||||
echo closed
|
||||
else
|
||||
echo open
|
||||
fi
|
||||
}
|
||||
|
||||
while [ "$(issue_state "$REPO" "$N")" != closed ]; do # 查詢失敗會回空字串，要繼續等，不能當成已關閉
|
||||
S="$(agent_status "$N")"
|
||||
NOW="$(date +%s)"
|
||||
if [ "$S" = blocked ]; then
|
||||
[ "$LAST" = blocked ] || { BLOCKED_SINCE=$NOW; NOTIFIED=false; }
|
||||
if ! $NOTIFIED && [ $((NOW - BLOCKED_SINCE)) -ge "$BLOCKED_AFTER" ]; then
|
||||
notify "#$N 等你回答" "issue-$N 已 blocked 超過 $BLOCKED_AFTER 秒"
|
||||
NOTIFIED=true
|
||||
fi
|
||||
elif [ "$S" = missing ] && [ "$LAST" != missing ] && [ -n "$LAST" ]; then
|
||||
notify "#$N 的 agent 不見了" "issue-$N 的 agent 已結束，議題仍 open"
|
||||
fi
|
||||
LAST="$S"
|
||||
sleep "$WATCH_INTERVAL"
|
||||
done
|
||||
|
||||
echo "#$N 已關閉，開始清理"
|
||||
LABELS="$(issue_labels "$REPO" "$N")"
|
||||
TAB="$(tab_for_issue "$N")"
|
||||
[ -n "$TAB" ] && herdr tab close "$TAB" >/dev/null && echo "關閉 tab $TAB"
|
||||
tea issues edit "$N" --repo "$REPO" --remove-labels "$LABEL" >/dev/null 2>&1 || true
|
||||
|
||||
git -C "$CLONE" fetch --quiet origin || true
|
||||
read -r PR STATE _ <<<"$(pr_for_issue "$REPO" "$N")" || true
|
||||
DELETE_BRANCH=false
|
||||
case "${STATE:-none}" in
|
||||
merged) DELETE_BRANCH=true; echo "PR #$PR 已合併" ;;
|
||||
closed|open) echo "PR #$PR 狀態 $STATE，保留分支" ;;
|
||||
*) if [ "$(git -C "$CLONE" rev-list --count "origin/main..$BRANCH" 2>/dev/null || echo 0)" = 0 ]; then DELETE_BRANCH=true; echo "沒有 PR 也沒有 commit"; else echo "沒有 PR 但分支有 commit，保留"; fi ;;
|
||||
esac
|
||||
if git -C "$CLONE" worktree list --porcelain | grep -qx "worktree $WT"; then
|
||||
git -C "$CLONE" worktree remove --force "$WT" && echo "移除 worktree $WT"
|
||||
fi
|
||||
$DELETE_BRANCH && git -C "$CLONE" branch -D "$BRANCH" >/dev/null 2>&1 && echo "刪除分支 $BRANCH"
|
||||
|
||||
SPEC="$(grep -o '規格/#[0-9]*' <<<"$LABELS" | head -1 | tr -d '規格/#')"
|
||||
if [ -n "$SPEC" ]; then
|
||||
R="$(close_if_done "$SPEC" "規格/#$SPEC")"; echo "規格 #$SPEC：$R"
|
||||
if [ "$R" = closed ]; then
|
||||
OV="$(issue_labels "$REPO" "$SPEC" | grep -o '總覽/#[0-9]*' | head -1 | tr -d '總覽/#')"
|
||||
[ -n "$OV" ] && echo "總覽 #$OV：$(close_if_done "$OV" "總覽/#$OV")"
|
||||
fi
|
||||
fi
|
||||
echo "#$N 清理完成"
|
||||
Reference in New Issue
Block a user