Communitygithub.com

cucoreanu/personal-skills

监视一个 GitHub PR 上的新评审反馈,仅实现有意义的修复,并用证据、友好的机智回答审阅者,对不切实际或过度防御的评论进行反驳。在用户要求“照看”、“监视”或“监控” Codex/审阅者对 PR 的评论时使用。

personal-skills 是什么?

这是一个名为“Codex Babysitting”的 AI 智能体技能,专门用于持续监控一个 GitHub Pull Request (PR) 上的新评审反馈。其主要价值在于自动化处理代码审查流程,节省开发者手动轮询和分类评论的时间。它通过分析每条反馈,将其分类为“修复”、“预期”、“不切实际”、“过度防御”或“需要指导”,并仅在有明确证据表明修复会带来有意义影响时才执行代码更改。技能支持通过 CLI 调用,并需要一个 PR URL 和可选的轮询间隔参数。它适用于任何支持自定义技能执行的 AI 开发工具,如 Codex、Claude Code 或 Cursor,通过细致的分类逻辑和基于证据的回复,帮助开发者高效地处理 PR 审查,避免陷入无价值的讨论或过度工程。

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

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Codex 照看 PR

监视一个 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 的头分支。
  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 的值进行空值检查,或一个已在上游存在的重试循环)。保持一行简短,可选前导表情符号。

  • 切勿重复使用来自这些说明、PR 上的先前回复或先前扫描的标语。检查 PR 现有的评论,确保你的标语与众不同。
  • 切勿退回到关于“信号/噪声”、“龙”或“检查了两遍”的通用标语。如果标语适用于任何评论,请重写它,直到它只适用于这一条。
  • 标语仅用于点缀;它不能包含回复正文不支持的技術主张。
  • 严重发现(安全性、数据丢失、合规性、生产影响)使用朴素、真诚的页脚,不要开玩笑,依然要针对该发现而非使用陈词滥调。

格式(下面的标语仅为展示结构的占位符;切勿复制它):

{表情符号} {与此回复相关的原始标语} — 由 {模型名称} 处理

按类别的操作

  • 修复
    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.

相关技能