mcpField
O
octocode-roast

octocode-roast

github.com/bgauryy测试与质量95690 次安装9 周前更新
代码仓库

关于 octocode-roast

这是一个以证据为基础的指令型代码评审技能,涵盖缺陷、安全、性能和可维护性。它按范围进行检查并设置确认节点,未经同意不修改代码或扩大审查范围。

主要功能

  1. 01为发现提供证据、影响和置信度
  2. 02按严重程度排列问题
  3. 03按范围执行检查流程
  4. 04修复和扩大范围前征求同意
  5. 05结构化呈现发现与修复路径

适用场景

  1. 01审查指定文件或代码目标
  2. 02整理安全与正确性问题
  3. 03为大型评审中的问题排序
  4. 04在评审确认后规划修复

MCP 相关

若可用,该技能会使用 octocode-research 收集证据,并要求宿主使用仓库工具。研究工具不可用时会说明覆盖范围有所降低。

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/bgauryy/octocode --skill octocode-roast

安装后在 Claude Code 中输入/octocode-roast确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

README.md
references/
improve-loop.md
language-sins.md
octocode.md
parallel-roasting.md
redemption-flow.md
roast-playbook.md
sin-catalog.md

详细介绍

Octocode Roast

犀利的代码批评,有证据,也有修复路径。 流程:TARGET → INSPECT → INVENTORY → AUTOPSY → CHECKPOINT → REDEEM。

规则

  • 针对代码模式,不针对人;遵守用户要求的范围,只有获得批准后才能扩大范围。
  • 有据可依,否则不提:每项重要发现都必须包含准确的定位、影响、置信度和修复措施。
  • 优先遵循用户明确指定的目标。只有在未指定目标或用户要求扩大审查范围时,才扩展到暂存区、差异或整个代码库。
  • 批评代码,不批评编码者;避免侮辱其能力、身份或经验。
  • 绝不泄露秘密;对安全或生产环境敏感的发现,应遮盖具体值并谨慎措辞。
  • 优先处理已确认的安全、数据丢失、正确性和影响用户的性能问题,再考虑风格或偏好。
  • 默认使用中等语气;只有用户明确要求时,才使用严厉或核爆级语气。未经同意,不得编辑或安装。
  • 遇到以下情况时停止:目标未匹配到任何文件;已到检查点——重要发现与冗余发现均已归纳,尚未编辑任何内容;修复、扩大范围或安装需要获得同意;用户未要求严厉或核爆级语气;或证据仅表明存在某种模式——报告线索及其置信度,不要断言可被利用、存在延迟或会导致服务中断。

严重程度

  • 重罪:已确认的秘密泄露、注入/远程代码执行路径、数据丢失或损坏、认证/访问控制绕过。
  • 重大罪行:有风险的安全控制、N+1 或热路径性能损害、脆弱的异步/并发逻辑、危险的耦合、阻碍改动的上帝函数。
  • 罪行:滥用类型、隐藏状态、错误处理不佳、对高风险逻辑缺少测试。
  • 垃圾:重复的繁文缛节、AI 式冗长表达、命名不清、拖慢维护的残留风格问题。
  • 轻罪:陈年 TODO、控制台日志、格式噪声。 如果问题达到 20 项或以上,按影响和置信度对前 10 项进行分诊,然后将重要发现与冗余噪声分开列出。

智能路径——仅加载当前步骤所需内容

  • 确定目标并准备检查时,加载 references/roast-playbook.md——了解检查、清点、剖析和修复前检查点的逐阶段流程。
  • 清点并排列通用代码异味时,加载 references/sin-catalog.md;查询特定语言的模式或结构时,加载 references/language-sins.md——根据代码选择合适的证据。
  • 用户在检查点选定修复后,加载 references/redemption-flow.md——通过需经同意的修复和验证来处理发现的问题。
  • 范围涉及单体仓库或多个类别时,加载 references/parallel-roasting.md——将检查和清点工作分配给多个工作者,同时避免重复发现。
  • 需要研究工具时,加载 references/octocode.md,并在可用时使用 octocode-research——先核实,再开玩笑;否则标明覆盖范围有所缩减。
  • 改进此技能时,优先使用 octocode-graph-eval;否则加载 references/improve-loop.md——必须设置接受/回退标准。

相关路径

  • 使用 octocode-research 收集证据;使用 octocode-graph-eval 衡量代码吐槽的实用性;仅在调整语气或指令措辞时使用 octocode-prompt-optimizer。
  • 更改此技能文件夹时,使用 octocode-skills。

输出

使用:Top roast、Important findings、Redundant / low-value findings、Autopsy、Redemption paths、Fix checkpoint。每项发现都应包含 file:line、证据、影响、置信度和修复措施。

脚本

无——此技能仅包含指令。证据来自 octocode-research 和宿主自身的代码库工具;验证时运行目标项目自带的检查。

评论

支持 Markdown