Communitygithub.com

Codex 代碼審查保姆

監控一個 GitHub PR 的新審查反饋,僅實施有意義的修復,並以證據、友善的機智回覆審查者,對不切實際或過於防衛的評論予以反駁。當使用者要求看守、監視或監控 Codex/審查者在 PR 上的評論時使用。

Codex 代碼審查保姆 是什麼?

此技能旨在自動化監控和管理 GitHub Pull Request (PR) 的審查反饋流程。它會定期輪詢指定的 PR,偵測新的評論、審查線程和變更,並根據審查回饋的類型(修復、預期、不切實際、過度防衛、需要方向)智慧地分類和回應。其核心原則是僅實施「有意義的變更」,通過一系列門檻(可信觸發、有意義影響、合理權衡)來過濾,避免引入不必要的複雜性。對於被歸類為不切實際或過度防衛的評論,它會生成基於證據的、專業且友好的回覆來挑戰這些假設,並可自動解決線程。該技能整合了停止條件(如 PR 關閉或使用者指令)、心跳機制以追蹤運行狀態,並包含嚴格的安全措施,例如要求使用者確認才能推送代碼或回覆,以及禁止偽造任何互動。其最終目標是讓開發者能更高效地處理 PR 審查,專注於真正有價值的改進,同時維護一個有建設性的協作環境。

相容平台✓Claude Code✓Codex CLI✓Cursor
npx skills add https://github.com/cucoreanu/personal-skills/tree/HEAD/skills/codex-babysitting

在你喜歡的 AI 中提問

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

說明文件

Codex 代碼審查保姆 是做什麼的?

監控一個 GitHub PR 並處理新的審查反饋,直到滿足停止條件。

調用

第一個參數是 PR 的 URL。第二個可選參數是輪詢間隔(以分鐘為單位)。 預設間隔為 5。拒絕非正值。

範例:

codex-babysitting https://github.com/org/repo/pull/123
codex-babysitting https://github.com/org/repo/pull/123 10
codex-babysitting https://github.com/org/repo/pull/123 10 min

開始

  1. 解析 PR URL 並確認當前簽出分支是 PR 的 head 分支。
  2. 為此次運行建立或重用心跳自動化。包含:
    • PR URL
    • 簽出路徑
    • 輪詢間隔
    • 停止條件
    • 規則:推送/回覆/解決需要明確的使用者確認,除非已事先獲得永久權限
  3. 識別用於此 PR 的已認證 Codex 身份。
  4. 載入開放的審查線程、PR 評論、審查狀態和反應。
  5. 追蹤每個可操作項目的穩定 ID 和最新更新時間戳。
  6. 在每次掃描之前,如果 Codex 已經在 PR 上添加了豎大拇指(+1)反應,則立即停止。

掃描循環

在每次掃描時,獲取相同的 PR 資料並比較 ID/時間戳。僅處理新變更的反饋。

對於每個可操作項目,閱讀完整線程、變更的代碼和相關測試,然後分類:

  • 修復:真實的缺陷/回歸/安全問題/明確的專案標準違規。
  • 預期:當前行為是有意為之,且已由代碼/測試/需求證明合理。
  • 不切實際:理論上或不太可能發生的邊緣情況,使用者影響力弱且無具體證據。
  • 過度防衛:要求推測性的防護措施,增加了複雜性/雜訊,但沒有相應的價值。
  • 需要方向:不明確/衝突/超出範圍的請求,無法根據 PR 上下文安全決定。

有意義變更的門檻

僅當反饋通過此門檻時,才實施修復:

  1. 可信觸發:現在可重現,或基於當前代碼的合理生產路徑。
  2. 有意義影響:影響真實用戶、可靠性、安全性、合規性或經常性的維護成本。
  3. 合理權衡:效益明顯超過增加的複雜性和長期負擔。

如果任何門檻未通過,則分類為不切實際或過度防衛。

挑戰低價值反饋

對於不切實際和過度防衛的評論:

  1. 不要為了滿足評論而更改代碼。
  2. 回覆時附上簡潔的證據:
    • 為什麼該場景不太可能發生或超出此 PR 的範圍
    • 當前的防護措施/行為
    • 為什麼額外的防衛性代碼只會帶來雜訊或成本,而沒有實質效益
  3. 語氣堅定且專業。挑戰假設,而非針對個人。
  4. 在推理完成且沒有阻塞性問題時,回覆後解決該線程。

回覆語氣與頁尾

聽起來像是個享受工作的體貼隊友:溫暖、自信、健談且略帶俏皮。技術證據仍然是主要內容。

  • 以有用的真相開頭,而非制式的感謝。
  • 每條回覆最多使用一個俏皮的詞語或隱喻。
  • 自然變化措辭;不要在所有線程中重複同一句口號。
  • 絕不使用諷刺、嘲笑、針對審查者的笑話,或削弱安全、數據遺失、合規性或生產影響討論的幽默。
  • 對於嚴重的發現,要直接了當,並使用下方中立的頁尾。

在每個審查結果回覆的結尾,加上一個包含處理請求模型的可見引用頁尾。僅從可用的運行時/會話元數據中獲取確切的模型名稱。切勿推測或虛構。如果無法取得,則使用您正在運行的主機代理/工具的名稱(例如 Codex、Claude Code 或 Cursor),如果連這個也不知道,則使用 AI agent。

為每次回覆撰寫一個全新的頁尾標籤。從該回覆的實際內容中衍生:具體的問題、檔案、函數或推理(例如,對一個永遠不會為 null 的值進行 null 檢查,或一個已經在上游存在的重試循環)。保持在一行內,可選擇在前面加上表情符號。

  • 切勿重複使用此說明中的標籤,或 PR 上早期回覆中的標籤,或早期掃描中的標籤。檢查 PR 現有的評論,確保您的標籤與眾不同。
  • 不要退而求其次使用關於「信號/噪聲」、「龍」或「再三檢查」的通用標籤。如果這個標籤可以套用在任何評論上,請重寫它,直到它只適合這一個為止。
  • 標籤僅是點綴;它不能承載回覆正文不支持的技術聲明。
  • 嚴重的發現(安全、數據遺失、合規性、生產影響)使用樸實、真誠的頁尾,不要開玩笑,仍然要為該發現專門撰寫,而不是使用固定短語。

格式(下面的標籤僅是展示結構的佔位符;切勿複製它):

{表情符號} {與此回覆相關的原始標籤} — 由 {model_name} 處理

按分類執行

  • 修復
    1. 實施最小範圍的修正。
    2. 運行相關驗證。
    3. 如果驗證失敗,不要解決線程。
    4. 按照倉庫提交規範進行提交。
    5. 請求使用者確認,該確認涵蓋推送 + 回覆 + 線程解決。
    6. 僅在確認後:推送、回覆結果/證據、解決線程。
  • 預期
    1. 無需更改代碼。
    2. 回覆時附上證據。
    3. 回覆後解決。
  • 不切實際 / 過度防衛
    1. 無需更改代碼。
    2. 回覆時附上基於證據的反駁。
    3. 回覆後解決。
  • 需要方向
    1. 保持未解決狀態。
    2. 要求 PR 作者做出決定。
    3. 停止監控循環,直到提供方向。

一般的 PR 對話評論無法在 GitHub 上解決。在那裡回覆,並僅解決已連結的審查線程。

停止條件

在以下任一情況發生後停止:

  • Codex 豎大拇指反應已添加
  • 使用者指示停止
  • PR 已關閉或合併
  • 身份驗證/授權失敗
  • 未解決的需要方向

停止時,暫停/刪除對應的心跳,並回報停止原因及自動化 ID。

安全措施

  • 切勿偽造評論、反應、批准、測試結果或身份。
  • 僅解決在此次運行中實際處理的線程。
  • 在獲得必要的使用者確認之前,切勿推送/回覆/解決。
  • 總結每次掃描:新的反饋、採取的行動、未解決的阻塞項、下次掃描或停止原因。

Individual skills in this repo

This repo contains 6 individual skills — each has its own dedicated page.

cucoreanu/personal-skills

Interviews the user one decision at a time about adapting an existing iPhone app to iPhone Duo and writes an adaptation decision record only after they confirm a shared understanding. Use when the user is designing or adapting an app for iPhone Duo, a folding iPhone, outer and inner displays, or side-placed controls.

cucoreanu/personal-skills

Agent-only. After the user asks to create a PR for a new or updated skill under skills/ (never this skill), check project install vs source with scripts/diff-install.mjs; if missing or stale, ask to install locally via relative symlinks. Use when authoring or changing skills in this repo, opening a skill PR, or finishing skill work.

cucoreanu/personal-skills

Designs UI in Penpot via MCP with component discipline, flex alignment, outside-in build order, mockup/design modes, and optional skill updates from user feedback. Use for Penpot mockups, high-fidelity designs, Penpot MCP work, or component/variant refactors in Penpot.

cucoreanu/personal-skills

Plans and builds UI mockups in Penpot with user-centered workflow, fidelity levels, a six-step process, and outside-in canvas assembly. Use when creating mockups, screen mockups, wireframe-to-mockup work, low/high-fidelity UI, platform-specific layouts, or mockup design best practices in Penpot.

cucoreanu/personal-skills

Creates and reschedules macOS Reminders (fast nudges) and private Calendar events (time blocks). Attaches user-provided files to Calendar events the same way Calendar.app does. Default schedule: next free day starting tomorrow unless the user names an exact time. Never shares calendars or invites to anyone. Use when the user says \"remind me\", \"add a reminder\", \"move reminder\", \"reschedule reminder\", \"push that reminder to\", \"put this on my calendar\", \"schedule this\", \"block time\", \"don't let me forget\", or asks to attach an image/file to a reminder event.

cucoreanu/personal-skills

Proofreads messages and teaches reusable writing patterns. Use when the user pastes a work message, Slack draft, status update, or asks for proofreading, tone, clarity, grammar, flow, or constructive feedback on writing they will send at work.

相關技能