关于 octocode-roast
这是一个以证据为基础的指令型代码评审技能,涵盖缺陷、安全、性能和可维护性。它按范围进行检查并设置确认节点,未经同意不修改代码或扩大审查范围。
主要功能
- 01为发现提供证据、影响和置信度
- 02按严重程度排列问题
- 03按范围执行检查流程
- 04修复和扩大范围前征求同意
- 05结构化呈现发现与修复路径
适用场景
- 01审查指定文件或代码目标
- 02整理安全与正确性问题
- 03为大型评审中的问题排序
- 04在评审确认后规划修复
MCP 相关
若可用,该技能会使用 octocode-research 收集证据,并要求宿主使用仓库工具。研究工具不可用时会说明覆盖范围有所降低。
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ bgauryy/ octocode --skill octocode-roast安装后在 Claude Code 中输入/octocode-roast确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
README.mdreferences/improve-loop.mdlanguage-sins.mdoctocode.mdparallel-roasting.mdredemption-flow.mdroast-playbook.mdsin-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