05 Skills

主路徑上的七個入口逐一說明；其餘 skill 只列總表。使用者層 skill 在 ~/.claude/skills/（由 ron-skills repo 同步），專案層在 repo 的 .claude/skills/。

主路徑

issue-create.mjs（開單；是腳本不是 skill，但是流程起點）

• 階段：需求 → 開單。
• 輸入：--title、--description-file、可選 --label。輸出：Issue 網址；預設 needs-triage。
• 背後：glab API；開成 ready-for-* 時先用 deliver-preflight.mjs 的規則檢查 SQL prerequisite： 與 ## 關聯，不合格 exit 3 不建立。
• 為什麼不用 glab issue create：格式檢查只在這個入口，auto mode 也只允許這個入口。

/issue-queue（分級與釐清；專案層 skill）

• 階段：開單 → 可開工。
• 做法：讀 GitLab 列出四區總覽（待補關聯、待釐清、可開工、阻塞中），逐張問釐清問題，最後設 label。
• 背後：issue-queue.mjs（解析 ## 關聯、找 Blocked by 循環）、issue-state.mjs --set。
• 注意：/triage、/grilling 不是 spay2 的入口；只讀 GitLab，不看本地分支。

/issue-run <n> [<m> …]（實作到候選 commit）

• 階段：認領 → 實作 → 驗證 → 候選。
• 六步：Gate（batch-dispatch.mjs --prepare）→ Graph（依 ## 關聯 排順序）→ Claim（issue-state.mjs --set … in-progress，建 worktree）→ Build（單張用 implement／tdd，多張用 implement-spec 派 subagent）→ Candidate（deliver-candidate.mjs）→ Report。
• 專案事實放在 repo 的 adapter docs/agents/issue-run.md；skill 本身不含 spay2 的路徑與指令。
• 驗證只跑本單 focused 測試；Docker 測試一律經 run-docker-tests.sh。

orca-cli（建 worktree）

• 階段：認領時。
• 用法：流程內不直接呼叫 orca，而是 scripts/orca-worktree-create.mjs（單次呼叫＋輪詢）與 worktree-audit.mjs --apply。
• 注意：which orca 不是可用性檢查（那是 GNOME 螢幕閱讀器）；看 ORCA_CLI_COMMAND 是否設定。

「結案 n」（close-issue.mjs，兩段式）

• 第一次：merge-into-integration.sh 合入整合分支 → check-before-push.sh → 停在 PUSH_REQUIRED。
• Operator ! git push。
• 第二次：check-issue-closable.mjs（確認已合入且已推送，用 ls-remote 即時查）→ 留言 → close → completed → 刪 worktree 與分支。
• SQL Issue 改用 close-sql-issue.mjs。

/retro（回顧）

• 階段：交付後。
• 做法：回顧這次 session 的失誤與摩擦，產出環境改善項目；修正放本地 retro 分支，不開 Issue；只改 scripts/、.claude/、docs/ 的分支可插隊合入。
• 原則：規則寫了仍會被忽略，就升級成腳本或 gate（見 06）。

pr（MR body）

• 階段：整合分支要進 develop 時。
• 做法：依 skill 範本寫 MR 描述；Issue 層級不用。

其餘 skill 總表