Community研究與資料分析github.com

sgomez/developer-skills

為 Claude Code 提供無人值守的 PR 交付流程

developer-skills 是什麼?

這個技能允許 Claude Code 自動處理 Pull Request 的審查回饋。它會讀取 PR 上的所有評論、實作必要的修正、推送變更,並回覆相關的討論串,完全不需要人工介入。這個技能特別適合與 `/developer` 管道搭配使用,以實現全自動的開發工作流程。它支援 GitHub CLI,並能處理單一 PR 或多個 PR 編號。其核心流程包括:識別並檢出 PR 分支、收集所有未解決的回饋、最小化地實作修正、執行專案檢查(如型別檢查與測試)、提交並推送單一 commit,最後在每個處理過的討論串中回覆說明。若遇到不明確的評論,它會做出最合理的詮釋並在回覆中說明;若評論錯誤,則會解釋理由而不實作。這顯著提升了開發者處理程式碼審查的效率。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add sgomez/developer-skills

Installed? Explore more 研究與資料分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

修正 PR

讀取審查評論,實作修正,推送變更,回覆討論串。

喚起

/fix-pr         # 修正目前的 PR
/fix-pr 42      # 修正 PR #42

流程

1. 識別並檢出 PR

gh pr view <PR> --json number,title,headRefName,state

若 PR 已關閉或合併,則拒絕執行。

如果目前分支並非 PR 分支(/developer 管線會在全新的工作樹中執行此流程),請先檢出該分支:

gh pr checkout <PR>

絕不執行 git checkout main —— 在連結的工作樹中這樣做會失敗,因為 main 已在主要工作樹中被檢出。

2. 讀取所有回饋

# 頂層評論
gh pr view <PR> --comments

# 審查討論串(行內)
gh api repos/{owner}/{repo}/pulls/<PR>/comments \
  --jq '[.[] | {id, path, line, body, in_reply_to_id}]'

# 審查摘要
gh api repos/{owner}/{repo}/pulls/<PR>/reviews \
  --jq '[.[] | select(.body != "") | {id, state, body}]'

收集:未解決的行內討論串、審查摘要評論、PR 頂層評論。

若無任何可處理的回饋,則拒絕執行。

3. 實作修正

  • 解決每一條未解決的評論
  • 保持變更最小化 —— 只處理回饋要求的內容
  • 不要重構不相關的程式碼
  • 套用所有修正後:執行專案的檢查(參見 AGENTS.md / CLAUDE.md 取得確切指令),通常是:
pnpm typecheck
pnpm test

在提交前修復失敗。

4. 提交並推送

git add <你修改的檔案>   # 按路徑暫存 —— 絕不執行 `git add -p`(互動式)或 `git add -A`
git commit -m "fix(pr): address review comments on #<PR>"
git push origin <分支>

5. 回覆討論串

針對每個已處理的討論串進行回覆:

gh api repos/{owner}/{repo}/pulls/<PR>/comments/<COMMENT_ID>/replies \
  --method POST \
  --field body="Fixed in <commit-sha>: <變更的一行說明>。"

6. 報告

列出每個已處理的評論以及對應的修改。標記任何跳過的評論及其原因。

規則

  • 所有修正放在一個 commit 中(不是每條評論一個)
  • 回覆每一個你處理過的討論串
  • 如果評論不明確:做出最合理的詮釋,實作它,並在討論串回覆中說明你的詮釋(無人值守 —— 沒有人可以詢問)。如果評論有誤,則在回覆中說明理由,而非實作它
  • 如果修正會導致測試失敗:回報情況,不要推送會破壞的程式碼
  • 不要手動解析討論串 —— GitHub 會在推送時自動解析

相關技能