跳到正文
cccskills
免费在 GitHub 公开

requesting-code-review

Organizes a code review by giving a reviewer subagent the requirements, a change summary, and the relevant Git commits. It helps check completed work and handle findings by severity before continuing or merging.

中文简介正在准备中。当前显示英语简介。

原文查看原文说明

完成任务、实现重要功能或合并前使用,用于验证工作成果是否符合要求

查看安装方法

适用场景

  • Review a completed development task
  • Check a major feature against its requirements
  • Request a code review before merging into main
  • Get another perspective on a difficult bug fix

包含的文件(2)

  • SKILL.md2.9 KB
  • code-reviewer.md6.1 KB

SKILL.md(原文)

安装前可以查看交给 AI 代理的指令内容。

请求代码审查

派遣代码审查子代理,在问题扩散之前发现它们。审查者获得的是精心组织的评估上下文——绝不是你的会话历史。

核心原则: 早审查,勤审查。

何时请求审查

必须审查:

  • 子代理驱动开发中每个任务完成后
  • 完成重要功能后
  • 合并到 main 之前

可选但有价值:

  • 卡住时(换个视角)
  • 重构之前(建立基线)
  • 修复复杂 bug 之后

如何请求

1. 获取 git SHA:

BASE_SHA=$(git rev-parse HEAD~1)  # 或:git merge-base origin/main HEAD
HEAD_SHA=$(git rev-parse HEAD)

2. 派遣代码审查子代理:

使用 Task 工具,指定 general-purpose 类型,填写 code-reviewer.md 中的模板

占位符说明:

  • {DESCRIPTION} - 你刚完成的内容简要说明
  • {PLAN_OR_REQUIREMENTS} - 预期功能
  • {BASE_SHA} - 起始提交
  • {HEAD_SHA} - 结束提交

3. 处理反馈:

  • Critical 问题立即修复
  • Important 问题在继续之前修复
  • Minor 问题记录下来稍后处理
  • 如果审查者有误,用技术理由反驳

示例

[刚完成任务 2:添加验证功能]

你:让我在继续之前请求代码审查。

BASE_SHA=$(git log --oneline | grep "Task 1" | head -1 | cut -d' ' -f1)
HEAD_SHA=$(git rev-parse HEAD)

[派遣代码审查子代理]
  DESCRIPTION: 添加了 verifyIndex() 和 repairIndex(),支持 4 种问题类型
  PLAN_OR_REQUIREMENTS: docs/superpowers/plans/deployment-plan.md 中的任务 2
  BASE_SHA: a7981ec
  HEAD_SHA: 3df7661

[子代理返回]:
  优点:架构清晰,测试真实
  问题:
    Important:缺少进度指示器
    Minor:报告间隔使用了魔法数字 (100)
  评估:可以继续

你:[修复进度指示器]
[继续任务 3]

常见的合理化借口

借口现实
"我自己看一下 diff 就行了,不用专门派审查者"你是协调者——在自己的会话里读 diff 会烧掉你继续推进工作所需的上下文窗口。派一个审查子智能体:diff 和评估过程都待在它的上下文里,只有结论回到你这里。
"审查者需要我的全部会话历史才能理解这次改动"给它精心组织的上下文,绝不给会话历史。这样审查者才会盯着工作成果,而不是你的思考过程。

红线

绝不要:

  • 因为"很简单"就跳过审查
  • 忽略 Critical 问题
  • 带着未修复的 Important 问题继续推进
  • 对合理的技术反馈进行争辩

如果审查者有误:

  • 用技术理由反驳
  • 展示证明其可行的代码/测试
  • 要求澄清

参见模板:requesting-code-review/code-reviewer.md

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

Turn development ideas into agreed designs through focused conversation. The skill clarifies goals, constraints, and success criteria, then chooses a process for feasibility research, small changes, or new systems before implementation begins.

中文简介正在准备中。当前显示英语简介。

  • Clarifying the purpose of a new feature
  • Agreeing on a design for an existing code change
  • Comparing approaches for a new system
jnMetaCode/superpowers-zh83512026年10月20日 更新

Write Chinese code review feedback that clearly distinguishes required fixes, suggestions, and optional advice. Use question and suggestion templates, organize review summaries, and follow guidance for mixed Chinese-English comments and commit messages.

中文简介正在准备中。当前显示英语简介。

  • Writing Chinese review comments with clear priorities
  • Rephrasing blunt feedback as questions or suggestions
  • Standardizing Chinese-English comments and commit messages
jnMetaCode/superpowers-zh83512026年10月20日 更新

Standardize Chinese Git commit messages and changelogs using Conventional Commits, a structured message format. The skill provides writing rules and configuration examples for message checks, interactive commit entry, and automatic changelog generation.

中文简介正在准备中。当前显示英语简介。

  • Standardizing Chinese commit messages across a team
  • Checking commit formats with commitlint and husky
  • Generating changelogs with Chinese section headings
jnMetaCode/superpowers-zh83512026年10月20日 更新

Write and revise Chinese technical documentation using consistent spacing, punctuation, terminology, and structure. Includes README.md and API documentation templates, bilingual formatting examples, and a checklist for reviewing documents before publication.

中文简介正在准备中。当前显示英语简介。

  • Standardizing spacing and punctuation in Chinese documents
  • Writing a Chinese README.md
  • Organizing API documentation in Chinese and English
jnMetaCode/superpowers-zh83512026年10月20日 更新

Set up Git workflows for Gitee, Coding.net, 极狐 GitLab, and CNB with platform-specific connection and authentication examples. Choose branching rules, standardize Chinese commit messages, and adapt automated testing and deployment configurations to your team's workflow.

中文简介正在准备中。当前显示英语简介。

  • Configure connections and authentication for Chinese Git platforms
  • Choose branching rules that fit the team
  • Standardize Chinese commit messages and review templates
jnMetaCode/superpowers-zh83512026年10月20日 更新

Review AI agent session logs to document repeated work, departures from plans, delays, and token usage. Produce an evidence-based report with file and line references, and prepare a bug report when appropriate.

中文简介正在准备中。当前显示英语简介。

  • Investigating delays or token usage in a session
  • Reviewing repeated work or departures from a plan
  • Checking whether a skill was activated
jnMetaCode/superpowers-zh83512026年10月20日 更新

查看 jnMetaCode 的全部技能

报告此技能的问题