用途:该技能用于发布代码评审的最终摘要评论。当评审完成并需要输出总结时使用;若没有任何内容可评审且无内联评论,则改用它提供的 No Verdict 形式。摘要不支持以行内评论方式发布,禁止使用 gh pr comment 创建摘要评论。\n\n输出目标按顺序检测,取首个匹配项:提示的前置指令块中出现 local files 行,或调用方指定本地文件为目标时,写入工作目录的 review-summary.md;评审目标为本地变更且无调用方声明 GitHub 目标时,同样写入该文件;提示中提供粘性评论上下文(评论 ID 与 <!-- bitwarden-code-review --> 标记)的 Agent Mode 下,写入 /tmp/review-summary.md,并追加该标记,且不使用 MCP 工具或 gh 命令,由工作流后置步骤读取文件更新占位评论;GitHub Actions(tag 模式)下且存在 mcp__github_comment__update_claude_comment 而无粘性评论上下文时,用该 MCP 工具更新粘性评论;本地评审(既无 Agent 模式上下文也无 MCP 工具)写入工作目录的 review-summary.md。\n\n正常摘要格式:标题为 Bitwarden Claude Code Review,总体评估为 APPROVE 或 REQUEST CHANGES,随后最多四句中性描述说明评审内容;可选 Not covered 行仅在应有评审步骤未执行且无其他步骤覆盖时添加;代码评审细节置于 details 折叠块中,发现按严重度顺序分组:CRITICAL、IMPORTANT、DEBT、SUGGESTED、QUESTION,空类别省略;每条发现格式为表情符号加一行描述和文件位置。\n\nNo Verdict 形式:当评审未实际发生(无法生成 diff、diff 为空、无法识别 PR 等)时使用,独立形式而非模板内第三个值,不输出 APPROVE 或 REQUEST CHANGES。理由写在评估句位置,位于 details 之外;无 details 块也无覆盖说明;输出目标与所处模式的普通摘要一致,包括 Agent 模式的标记追加,避免下次运行找不到粘性评论而重复。\n\nPR 元数据评估:仅当标题、描述或测试计划确实不足时,作为发现放入 Code Review Details,且不超过 3 行评论。明确不足包括标题仅为 fix bug 等单词、描述为空或仅写 See Jira、UI 变更无截图、无测试计划且变更有可测性。不要评论轻微改进或尚可但有瑕疵的元数据,且绝不作为内联评论。\n\n依赖变更表:当 PR diff 包含依赖清单文件变更且存在有意义的版本变化时,在 details 块内、发现列表之后、可选 PR 元数据评估之前添加 Dependency Changes 子节,表格列为 Package、Change、Ecosystem;主版本号升级的 major 加粗,新增标注 New (版本),移除标注 Removed;仅锁文件变动而无清单变更时不渲染。
posting-review-summary
通用与其它
更新于 10-15 20:06