用途:扫描项目代码库,提取既有编码约定、lint 规则、常见模式与反模式,产出可执行的评审规则与清单,写入 docs/project-reference/code-review-rules.md。
主要能力:先判定项目范围与扫描模式(Init 占位或 Sync 已填充),再按范围并行启动子代理:后端规则(命名、基类、错误处理、依赖注入、日志、反模式)、前端规则(组件约定、状态管理、样式、订阅清理、可访问性、性能)、架构规则(层边界、跨服务通信、共享代码、测试约定、安全、配置)。每条规则需有项目内 DO 示例与 DON'T 反例,并标注 file:line;置信度 HIGH(3+ 一致示例)记为规则,MEDIUM(1-2)记为“观察到的模式(待验证)”,LOW 省略。
使用方式:在 Codex 中以 $skill-name 调用;执行前先读 docs/project-config.json、docs/project-reference/docs-index-reference.md 与 lessons.md,按任务类型只打开相关参考文档。流程为分类、扫描、增量写报告至 plans/reports/scan-code-review-rules-{YYMMDD}-{HHMM}-report.md、生成或更新文档、由全新子代理复核。更新采用外科式修改,保留未变章节与人工注释,顶部写 Last scanned 日期。
适用场景:代码评审、审计、规范沉淀、新人上手参考。
限制:规则必须源自实际代码,禁止通用最佳实践;反模式须为真实 file:line 违规;范围置信度低于 60% 需先询问用户;环境无法执行某步骤时应停止并询问;资料未提供具体安装命令、收费与平台支持信息。