用途
local-code-review 是一项用于在本地项目中执行严格、高信号代码审查的技能。它适用于任何本地工作区,包括由 GitHub、Bitbucket、GitLab 托管的项目,以及尚未纳入版本控制的本地目录。使用者可以在提交或合并前把它作为结构化质量关卡,也可以对整个代码库或指定模块进行系统审计。
主要能力
技能提供两种审查模式:
- 模式 A(Diff/变更审查):审查未提交工作、暂存 diff、特性分支或指定提交范围。它会检查 git status 中的修改、暂存和未跟踪文件,解析 diff 目标,并读取被修改文件的完整当前内容及直接调用方,避免只依据 diff 片段下结论。
- 模式 B(全代码库/模块审计):不依赖 Git diff,按逻辑架构顺序逐层审查清单与入口、核心领域逻辑、外部边界与集成、共享工具、测试套件与夹具、文档与可视化图表,并进行跨文件系统性分析。
审查围绕五个质量维度展开:正确性与验证(边界情况、错误路径、竞态、资源泄漏、测试是否验证真实行为)、可读性与简洁性(命名、控制流、抽象是否值得其复杂度)、架构与系统设计(模块边界、依赖方向、概念数量、是否把复杂性转移而非消除)、安全与数据加固(外部输入校验、路径穿越、密钥、参数化查询)、性能与效率(复杂度、N+1 查询、异步阻塞、超时与重试)。此外还覆盖测试覆盖、文档与配置一致性,以及 Markdown 引用的图片和架构图等可视化资产的核对。
使用方式
按技能给出的清单逐步执行:选择审查模式并收集目标文件;加载项目指南与架构上下文(如 AGENTS.md、README.md、ARCHITECTURE.md、包清单,以及可选的仓库级审查补充说明);评估测试、文档一致性与视觉资产;执行五轴评估并检查结构性问题;回到磁盘上的实际文件内容核实所有发现;最后输出按严重程度排序的审查结果,并可提议应用修复。
技能强调反幻觉护栏:不得仅凭片段或 diff 报告重复函数、缺失导入等问题;只报告可验证的缺陷、安全风险、架构异味、测试缺口或具体改进;不做未经全面核实的全局断言;建议的 shell 命令中不使用命令替换。输出使用 GitHub 风格 Markdown,并以相对文件链接标注位置。
适用场景
适用于本地代码审查、diff 审查、分支审查、提交前或推送前检查;也适用于对整个仓库、包或目录的审计,或对某个模块的专项审查。对不使用 GitHub Actions 的项目(如 Bitbucket 或本地仓库)同样适用。技能中还给出了变更规模与拆分建议:约 100 行改动较理想,约 300 行可接受,1000 行以上建议拆分;单文件接近 1000 行时是拆分的强信号。
限制
该技能是审查流程与判断标准的提示文档,不包含自动化静态分析或测试运行器;是否实际运行测试取决于环境和用户要求。具体安装命令、运行入口、支持的产品版本以及收费信息暂未提供。审查评论默认使用英式英语,除非项目规则另有规定。