用途:这是一个代码评审沟通技能,用于帮助开发者在撰写评审意见、接收反馈、处理评审分歧时进行清晰、建设性的沟通,同时不损害协作关系。
主要能力:提供 Conventional Comments 标注体系,格式为 [标签](修饰): 说明,标签包括 praise、nitpick、suggestion、issue、question、thought,修饰包括 (non-blocking)、(blocking)、(if-minor),以明确每条评论的意图与是否需要处理。还提供 Summary-Analysis-Suggestion 方法,适用于大型评审:先肯定优点,再指出需关注的问题,最后给出可操作建议。核心原则是区分代码与人,使用协作性的“我们”表述。技能还区分阻塞性问题(如安全漏洞、会导致生产问题的缺陷、公共 API 破坏性变更、关键路径缺少必要测试)与非阻塞性问题(如风格偏好、替代实现、次要优化、文档改进)。
使用方式:在写评审评论时,按标签格式组织语言;在创建大型评审时采用三步法;接收反馈时假定善意、将自我与代码分离、提出澄清问题、专业处理分歧,必要时转为线下讨论。相关命令为 /soft-skills:review-comment,可用于生成结构良好的评审评论。参考资料包括 references/conventional-comments.md 与 references/receiving-feedback.md。
适用场景:撰写 PR 评论、评审初级开发者首个 PR、接收尖锐反馈、区分阻塞与非阻塞问题、在不损害关系的前提下沟通代码质量。
限制:资料未提供具体平台依赖、安装命令、收费信息或效果保证;版本为 v1.0.0(2025-12-26)。