跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
设计与 UI

gh-pr-review

Automated Cherry Studio review for local branches, PRs, commits, files, architecture docs, and repository skills. Use for code or documentation reviews that need project-specific naming, main/renderer/shared placement and dependency rules, IpcApi and DataApi boundaries, lifecycle/service ownership, renderer hooks, React/UI conventions, and tests. Supports single-agent review with interactive fix selection or multi-agent reviewer-verifier review with risk-based auto-fix. To diagnose gaps in the skill after a review session, run `/gh-pr-review diag`.

CherryHQ · 已有 AI 审核记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add CherryHQ/cherry-studio --skill gh-pr-review

技能说明


name: gh-pr-review description: Automated Cherry Studio review for local branches, PRs, commits, files, architecture docs, and repository skills. Use for code or documentation reviews that need project-specific naming, main/renderer/shared placement and dependency rules, IpcApi and DataApi boundaries, lifecycle/service ownership, renderer hooks, React/UI conventions, and tests. Review depth adapts to diff size and runtime subagent capability (single-agent or multi-agent reviewer-verifier). Report-only by default; code fixes and GitHub submission each require explicit invocation-time authorization (fix / submit). Normal-review prompts and safe interruption behavior follow the interaction contract below. To diagnose gaps in the skill after a review session, run /gh-pr-review diag.

/gh-pr-review — Code Review

Automated code review for local branches, PRs, commits, and files. Detects the review target from arguments, then picks the review engine from diff size and runtime capability. Small diffs use single-agent review (references/local-review.md). Large diffs use the multi-agent reviewer–verifier flow (references/teams-review.md) only when independent subagents are available; otherwise they fall back to single-agent review with that limitation disclosed. PR targets add worktree setup and GitHub submission (references/pr-review.md) around the same engine-selection contract.

Cherry Studio-specific review rules live in references/cherry-review-guidance.md. Target review flows must load that file for code, mixed, architecture-doc, and project-skill reviews so reviewers can apply DataApi, service-boundary, renderer hook, React, UI, and type-contract checks without relying on memory. That reference also defines which internal docs, internal skills, external skills, and official websites to consult for each changed area; load only the relevant subset.

All user-facing text matches the user's language.

Interaction and interruption contract

Apart from the declared categories below, normal review is prompt-free: never ask for mode selection, fix confirmation, finding selection, or submission preview. A leaf flow may request input only when it explicitly declares one of these categories:

  • Product decision — in an interactive session, the Product Demand gate may ask the current user for a decision the review cannot derive. In an automated session, record the impact and open decision without deciding for the user.
  • Safety or environment blocker — continuing would require destructive action, new authority, or missing external configuration. Declared examples are a dirty/mismatched review worktree, a missing canonical remote, cleanup of unexplained changes, removal of a failed fix patch, and a pending review draft holding comments this run did not confirm. In an interactive session, preserve state and ask only for the decision needed to proceed.
  • Explicit maintenance mode — diag and separately requested checklist maintenance are interactive selection flows outside normal review. They may ask for the declared edit selection or persistent checkout/branch target.

An automated session never waits for user input. At a product decision it continues record-only as specified below. At a safety/environment blocker it preserves state, stops the affected flow safely, and reports the exact blocker and required decision. In an explicit maintenance mode it reports candidates or missing destination information, applies no selection-dependent edits, and stops safely. No leaf flow may introduce another prompt category.

Review Stages

Every review runs these stages in order. A later stage reviews only what survived the earlier ones, so a stage never re-litigates an earlier verdict.

This table is the single source of truth for stage scope and references; a leaf flow may not widen, narrow, or re-reference a stage.

#StageApplies toReference
1Product Demand (gate)any change whose semantics affect the productbelow
2Consumerany change that adds or expands shared surfacereferences/consumer-review.md
3Architecture-Firstcode, mixed, Cherry architecture docs, project skillsreferences/cherry-review-guidance.md
4Implementationcode, mixedreferences/code-checklist.md (A/B)
4Implementationdocsreferences/doc-checklist.md (A/B)
5Style / conventionscode, mixedreferences/code-checklist.md (C)
5Style / conventionsdocsreferences/doc-checklist.md (C)

Stage applicability follows the changed content, not the commit label: a documentation-only diff still runs stages 3–5 when it changes Cherry architecture docs or project skills, and a code diff that also edits docs runs both reference sets for stages 4–5.

Stage 1: Product Demand gate

First inspect the semantics actually expressed or constrained by the change, then decide whether it affects product semantics, user-visible behavior, or product direction. Change labels are not sufficient evidence: internal refactors and non-user-facing fixes often have no product impact, while docs, tests, or tooling can record, lock, or alter product behavior. Skip this stage entirely, in both interactive and automated runs, only after semantic review confirms that the change is implementation-only; say nothing about the skipped gate.

When there is product impact:

  • Interactive session (default): summarize the change's effect on product functionality and semantics, and ask the current user for the product decision. Do not infer automation from PR authorship, review ownership, or whether the user authored the decision. If the user judges the direction wrong, **stop the whole review immediatel
阅读完整来源 ↗