32 Commits
Author SHA1 Message Date
tt-a1iandtt-a1i 277f479301 feat: add Dart/Flutter review guide and npx skills docs (#31)
Give Flutter/Dart PRs a dedicated review guide, and document
`npx skills add` while keeping SKILL.md at the repo root so
clone-into-~/.claude/skills still works.

Co-authored-by: tt-a1i <tt-a1i@users.noreply.github.com>
2026-08-23 22:29:31 +08:00
tt-a1i 6a75102283 docs: polish Ruby guide session, Active Storage, and migration notes
Split Active Storage/SSRF into its own section, clarify session_store
belongs in an initializer, and note null: false backfill for existing
tables.
2026-07-16 14:12:54 +08:00
smf-h 4294566502 docs: expand Ruby quick review checklist 2026-07-16 13:53:56 +08:00
smf-h 21bf90d22c docs: address Ruby and Rails review feedback
Updated Ruby security guidelines for deserialization, error handling, and parameter handling. Improved clarity on using safe YAML loading, idempotency keys, and CSRF protection.
2026-07-16 13:51:26 +08:00
smf-h ee03536324 feat: add Ruby and Rails code review guide 2026-07-14 11:43:11 +08:00
f2fd4e57d9 feat: add Java 8 / Spring Boot 2 legacy review guide (#24)
* feat: add Java 8 / Spring Boot 2 legacy review guide

Support reviewing long-lived Java 8 and Boot 2 (javax.*) codebases without
forcing Java 17/21 patterns. Closes #23.

Co-authored-by: Cursor <cursoragent@cursor.com>

* docs: rewrite Java 8 legacy guide in English

Make the guide accessible to international contributors; keep examples
and review checklists in English like other language guides (e.g. php.md).

Co-authored-by: Cursor <cursoragent@cursor.com>

---------

Co-authored-by: tt-a1i <tt-a1i@users.noreply.github.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-09 14:50:14 +08:00
tt-a1iandtt-a1i 28e918267d docs: expand review guides and sync release metadata (#21)
Co-authored-by: tt-a1i <tt-a1i@users.noreply.github.com>
2026-06-28 17:16:10 +08:00
ljymillerand李嘉扬 1c8968729d feat: add Zig code review guide (#18)
* feat: add Zig code review guide

* fix: address Zig guide review feedback

* fix: address final Zig guide review notes

---------

Co-authored-by: 李嘉扬 <miller@lijiayangdeMacBook-Pro.local>
2026-06-25 14:27:01 +08:00
tt-a1i 17267ff26b fix: correct review-guide errors and sync skill metadata (#16)
Correctness fixes in the reference guides:
- django: len()/count() caching explanation was reversed; fix slicing/index
  cache example; replace nonexistent __acall__ async middleware with the
  documented markcoroutinefunction pattern; drop removed
  SECURE_BROWSER_XSS_FILTER; REFERRER_POLICY -> SECURE_REFERRER_POLICY
- security: path-traversal guard compared a relative path to an absolute one
  (rejected every valid file); compare absolute-vs-absolute
- nestjs: e2e ValidationPipe needs forbidNonWhitelisted/transform for the
  "extra field -> 400" test to pass
- rust: select! cancel-safety example used read on both sides; bad case now
  uses non-cancel-safe read_exact
- code-quality: "read less" example still read the whole file; use readline()
- svelte: drop nonexistent unstate() (use $state.snapshot); fix devalue/Date
  note; comma-operator each-key -> template literal
- c/cpp/qt: restore mangled markers that rendered as a literal ?
- csharp: drop fabricated perf numbers
- java: scope HashMap infinite-loop note to Java 7 and earlier
- kotlin: closeableScope -> built-in viewModelScope
- css: deprecated darken()/clip:rect() -> color.adjust/clip-path
- typescript: legacy .eslintrc -> flat config (typescript-eslint v8)

Tooling and metadata:
- pr-analyzer.py: filename regex corrupted lib//web//db/ paths; parse the diff
  header via backreference and add utf-8/error handling; add test
- SKILL.md: canonical name code-review-skill; document severity tiers; wire in
  pr-analyzer.py
- README/CONTRIBUTING: fix stale skill name and line counts; complete the guide
  tree; add a conventions section
2026-06-05 09:45:40 +08:00
Fernando BassandTu Shaokun ca6a249dbb Add Swift code review guide (#15)
* Add Swift code review guide

Add reference/swift.md covering modern Swift (5.9+/6): optionals and
safe unwrapping, value vs reference types, Swift Concurrency and data
race safety, SwiftUI property wrappers, and the API Design Guidelines.

Register the guide across the docs: language tables and file trees in
README.md (EN and zh), the SKILL.md description and guide table, the
common bugs checklist, and both landing pages. Bump the language count
from 19+ to 20+.

* fix: refine Swift guide examples

---------

Co-authored-by: Tu Shaokun <2801884530@qq.com>
2026-06-05 09:43:08 +08:00
tt-a1i 65079305d9 Add PHP review guide (#14)
* Add PHP review guide

* Translate PHP guide to English and correct line-count stats

Rewrite reference/php.md in English to match the FastAPI guide's
convention, since most users read English. Also fix the line-count
badge/blurb from 17,000+ to 16,000+ to match the actual total (~16.9k).
2026-05-30 16:12:25 +08:00
Tu Shaokun 39a9698c31 docs: bump language count to 18+ and add References to FastAPI TOC
Follow-up to #12: the badge was bumped to 18+ but the EN/ZH prose
still read 17+, and the FastAPI guide TOC was missing its References
entry.
2026-05-29 23:25:32 +08:00
Momoyeyu e4c56a0396 docs: clarify why tests anchor a coding agent's review 2026-05-29 18:10:40 +08:00
Momoyeyu 0f3f613232 feat: add FastAPI code review guide 2026-05-29 18:04:32 +08:00
xronocodeandClaude Opus 4.7 52d6a14cd3 fix: address review feedback on universal quality + perf guides
- code-quality-universal.md: drop broken TS lookup-table example whose
  one-key {key:true} object always evaluated to `true`; promote the
  bgMap variant to the single ✅ block
- code-quality-universal.md: rename `## Review Checklist` to
  `## 通用质量审查清单` (and TOC anchor) for consistency with peer
  reference files that close with a Chinese checklist heading
- performance-review-guide.md: move `## 低级别效率反模式` above
  `## 参考资源` so the references section remains the file's terminal
  section, matching every other reference file
- performance-review-guide.md: slim `## 低级别效率反模式` from heavy
  ❌/✅ examples to a checklist with two illustrative snippets, and
  cross-link the resource-management overlap into
  common-bugs-checklist.md#resource-management

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-09 11:31:08 +06:00
xronocode 836d467978 feat. (feat) Add universal quality anti-patterns guide + low-level efficiency patterns
New guide: reference/code-quality-universal.md (~320 lines)
- Code reuse audit: search existing utilities before accepting new code
- Parameter sprawl: options object / dataclass instead of 4+ params
- Leaky abstractions: hide ORM/HTTP/file format internals
- Stringly-typed code: use enum/constant/union type over raw strings
- Nested conditionals: flatten ternary chains and nested if/else
- Copy-paste variants: unify near-duplicate code with shared abstraction
- No-op updates: add change-detection guards to polling/intervals
- TOCTOU: replace check-then-act with try-act-catch
- Overly broad operations: push filtering to DB/storage layer
- Redundant state: derive values instead of storing duplicates

Updated SKILL.md Phase 3 with Reuse Check dimension + cross-cutting guide table.
Extended performance-review-guide.md with low-level efficiency patterns:
unnecessary work, missed concurrency, hot-path bloat, unbounded data structures.
Updated README.md bilingual tables, trees, and badges.
2026-05-09 10:50:28 +06:00
tt-a1i c5a33c5b61 Merge pull request #10 from xronocode/feat/add-6-new-guides
feat: Add 6 new framework/language review guides (+4,700 lines)
2026-05-09 11:53:44 +08:00
tt-a1i 113988d9e6 fix: move NestJS to Backend, dedupe Django row, close angular.md table cell 2026-05-09 11:53:21 +08:00
tt-a1i e569929301 docs: keep collation and timezone items in SQL checklist 2026-05-09 11:40:38 +08:00
xronocode 139e6b1106 feat. (feat) Add 6 new framework/language review guides: Angular 17+, Svelte 5, NestJS, Django/DRF, Kotlin/Android, C#/.NET 8
- Angular: Signals, Standalone components, RxJS, Zoneless, template optimization
- Svelte/SvelteKit: Runes, Load functions, Form Actions, Store migration, SSR/CSR
- NestJS: DI & layered architecture, Guards/Interceptors/Pipes, DTO validation, circular deps
- Django/DRF: Security audit, N+1 queries, Serializer anti-patterns, async views
- Kotlin/Android: Coroutines, Flow, Jetpack Compose, null safety, memory leaks
- C#/.NET 8: C# 12 features, async, EF Core, ASP.NET Core, LINQ

Update SKILL.md and README.md index tables, badges, and repo trees.
2026-05-08 17:15:31 +06:00
xronocode d367294bac fix: eliminate DRY violations in common-bugs-checklist, fix stale CONTRIBUTING.md, improve pr-analyzer.py
- Refactor common-bugs-checklist.md from 1227 lines to 217 lines:
  replace duplicated code examples with concise checklist items
  linking to the dedicated language-specific guides
- Fix CONTRIBUTING.md: stale directory name (ai-code-review-guide ->
  code-review-skill), missing files (go.md, qt.md, css-less-sass.md,
  architecture-review-guide.md, performance-review-guide.md)
- Fix pr-analyzer.py detect_language(): use os.path.splitext instead of
  fragile .endswith(), add missing extensions (.vue, .kt, .swift, .php,
  .cs, .svelte, .zig, .ex, .scala, .lua)
- Fix pr-analyzer.py generate_suggestions(): replace fragile string
  matching on risk messages with RISK_NO_TESTS constant
2026-05-08 16:09:36 +06:00
xstongxue 036d8abab6 feat: add QT guides and update indexes 2026-02-03 11:42:29 +08:00
龚梦帅 d3102ac0f1 feat: add QT guides and update indexes 2026-01-29 10:23:32 +08:00
seeksky c687f500b7 feat: add C and C++ code review guides 2026-01-11 17:54:54 +08:00
google-labs-jules[bot] e72fafef25 feat: Add Java 17+ and Spring Boot 3 code review guide
- Create `reference/java.md` with guidelines for modern Java (Records, Switch, Text Blocks), Spring Boot 3 (DI, Configuration), JPA (Performance, N+1), and Concurrency (Virtual Threads).
- Update `SKILL.md` to register the Java guide for on-demand loading.
- Update `README.md` to include Java in supported languages and key topics.
2025-12-04 14:50:08 +00:00
Tu Shaokun 7a66dab176 feat: 添加 Go 语言代码审查指南
新增 reference/go.md (~990 行),涵盖:
- 错误处理(errors.Is/As, 包装, 自定义错误)
- 并发(goroutine 泄漏, channel, sync.WaitGroup)
- Context 使用(传播, 取消, 超时)
- 接口设计(接受接口返回结构体, 小接口)
- 接收器类型选择(值/指针)
- 性能优化(预分配, sync.Pool, 逃逸分析)
- 测试(表驱动, 并行, Mock)
- 常见陷阱(nil slice, map 初始化, defer 循环)

更新 SKILL.md 和 README.md 添加 Go 语言支持
总行数:~8000 → ~9000 行
2025-11-30 18:15:36 +08:00
Tu Shaokun ee5826118a fix: 修复代码示例语法错误
- vue.md: 添加缺失的注释符号 //
- react.md: 添加缺失的 async 关键字
2025-11-30 11:20:26 +08:00
Tu Shaokun 91a79e39a9 feat: 添加性能审查指南
- Core Web Vitals (LCP, INP, CLS, FCP, TBT)
- JavaScript 性能(代码分割、Bundle 优化、虚拟列表)
- 内存管理(泄漏检测、清理模式)
- 数据库性能(N+1、索引、查询优化)
- API 性能(分页、缓存、限流)
- 算法复杂度(Big O、常见优化)
- 性能度量阈值和工具推荐
2025-11-29 21:58:45 +08:00
Tu Shaokun 1479bc3d87 feat: 添加 CSS/Less/Sass 审查指南
- CSS 变量 vs 硬编码规范
- !important 使用规范
- 性能优化(transition: all, box-shadow 动画, reflow)
- 响应式设计检查点(Mobile First, 断点)
- 浏览器兼容性(Autoprefixer, 回退策略)
- Less/Sass 嵌套深度和 Mixin 使用
2025-11-29 21:24:57 +08:00
Tu Shaokun 50496be98a feat: 添加架构设计审查指南
- 新增 architecture-review-guide.md
- 包含 SOLID 原则检查清单
- 包含架构反模式识别
- 包含耦合度与内聚性评估
- 包含分层架构审查
- 包含设计模式使用评估
- 包含可扩展性评估
- 更新 SKILL.md 添加新指南引用
2025-11-29 17:38:42 +08:00
Tu Shaokun 755bd71381 feat: 大幅扩充代码审查指南内容
主要更新:
- typescript.md: 新增泛型、条件类型、映射类型、strict 模式、ESLint 规则 (~540 行)
- python.md: 新增类型注解、async/await、pytest、性能优化 (~1070 行)
- vue.md: 新增 Vue 3.5 特性 (defineModel, useTemplateRef, useId) (~920 行)
- rust.md: 新增取消安全性、spawn vs await 决策指南 (~840 行)
- react.md: 新增 useSuspenseQuery 限制说明和场景指南 (~870 行)
- README.md: 更新行数统计 (总计 6000+ 行)

新增内容约 2861 行代码审查指南和示例
2025-11-29 14:04:46 +08:00
Tu Shaokun 8dc3304eca fix: 符合官方 Skill 规范
- description 改为第三人称
- 目录重命名 references → reference(官方规范)
- 文件引用改用 Markdown 链接格式
- 更新 README.md 路径
2025-11-29 13:48:01 +08:00