Skip to content
Skills Library
Programming · Review & audit

code-review-assistant

/code-review-assistant

[UDS] 系統性程式碼審查的參考資料:八大審查類別,以及 BLOCKING/IMPORTANT/SUGGESTION 評論前綴。 Use when: 審查 pull request 或 diff、決定審查意見的措辭與優先序、與團隊議定審查範圍。 Not for: 執行有關卡的審查流程——該部分已移至採用層(XSPEC-095);提交前的關卡驗證——請用 /checkin。 Keywords: code review, pull request review, review checklist, BLOCKING, comment prefix, 程式碼審查, 審查類別, 評論前綴, 審查清單.

Licence
MIT
Last repository change
27.10.2026

Assessment and security

90/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content25 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
4
Scripts
0
HTML comments
1
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 27.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What to check before installing
  • SKILL.md zawiera komentarze HTML (1). Nie widać ich w podglądzie Markdown, a model je czyta.

What it does and when to use it

[UDS] 系統性程式碼審查的參考資料:八大審查類別,以及 BLOCKING/IMPORTANT/SUGGESTION 評論前綴。 Use when: 審查 pull request 或 diff、決定審查意見的措辭與優先序、與團隊議定審查範圍。 Not for: 執行有關卡的審查流程——該部分已移至採用層(XSPEC-095);提交前的關卡驗證——請用 /checkin。 Keywords: code review, pull request review, review checklist, BLOCKING, comment prefix, 程式碼審查, 審查類別, 評論前綴, 審查清單.

Arguments

/code-review-assistant [檔案路徑或分支名稱]
Original author description

[UDS] 系統性程式碼審查的參考資料:八大審查類別,以及 BLOCKING/IMPORTANT/SUGGESTION 評論前綴。 Use when: 審查 pull request 或 diff、決定審查意見的措辭與優先序、與團隊議定審查範圍。 Not for: 執行有關卡的審查流程——該部分已移至採用層(XSPEC-095);提交前的關卡驗證——請用 /checkin。 Keywords: code review, pull request review, review checklist, BLOCKING, comment prefix, 程式碼審查, 審查類別, 評論前綴, 審查清單.

How it works

  1. 工作流程
  2. 審查類別
  3. 評論前綴
  4. 使用方式
  5. 下一步引導
  6. 參考
  7. AI 代理行為
Original SKILL.md headings · 72 lines, 285 words
SKILL.md preview
---
name: code-review-assistant
source: ../../../../skills/code-review-assistant/SKILL.md
source_version: 1.0.0
translation_version: 1.1.0
last_synced: 2026-10-11
source_hash: e573a23283c0
status: current
scope: universal
description: |
  [UDS] 系統性程式碼審查的參考資料:八大審查類別,以及 BLOCKING/IMPORTANT/SUGGESTION 評論前綴。
  Use when: 審查 pull request 或 diff、決定審查意見的措辭與優先序、與團隊議定審查範圍。
  Not for: 執行有關卡的審查流程——該部分已移至採用層(XSPEC-095);提交前的關卡驗證——請用 /checkin。
  Keywords: code review, pull request review, review checklist, BLOCKING, comment prefix, 程式碼審查, 審查類別, 評論前綴, 審查清單.
allowed-tools: Read, Grep, Glob, Bash(git diff:*), Bash(git log:*), Bash(git show:*)
argument-hint: "[檔案路徑或分支名稱]"
---
<!-- 棄用通知(XSPEC-086 Phase 4,2026-04-28):
  程式碼審查流程協調(4 步驟序列、outcome gating)已移至 adoption layer
  (XSPEC-095,2026-04-28)。此 Skill 保留:8 大審查類別定義、
  BLOCKING/IMPORTANT/SUGGESTION/QUESTION/NOTE 前綴語意。
  需要強制執行時,請使用你的 adoption layer 工具鏈。
-->

# 程式碼審查助手

> **語言**: [English](../../../../skills/code-review-assistant/SKILL.md) | 繁體中文

> ⚠️ **狀態:參考用(非可執行流程)** — 程式碼審查流程協調(4 步驟序列、outcome gating)已於 2026-04-28 移至 **adoption layer(XSPEC-095)**。此處保留 8 大審查類別定義、BLOCKING/IMPORTANT/SUGGESTION/QUESTION/NOTE 前綴語意供參考;需要強制執行的流程請改用你的 adoption layer 工具鏈。

使用標準化的檢查清單和評論前綴,執行系統性的程式碼審查。

## 工作流程

> 📖 以下為流程的**參考結構**,非可執行步驟;自動化/強制執行請用 adoption layer 工具鏈(XSPEC-095)。

1. **識別變更** - 透過 `git diff` 或 `git show` 取得待審查檔案的差異
2. **套用檢查清單** - 系統性地檢查每個審查類別
3. **產生報告** - 使用標準評論前綴輸出發現
4. **總結** - 提供整體評估和建議的後續行動

## 審查類別

1. **功能性** - 功能是否正確? | Does it work correctly?
2. **設計** - 架構是否合適? | Is the architecture appropriate?
3. **品質** - 程式碼是否乾淨可維護? | Is the code clean and maintainable?
4. **可讀性** - 是否容易理解? | Is it easy to understand?
5. **測試** - 測試覆蓋是否足夠? | Is there adequate test coverage?
6. **安全性** - 是否有安全漏洞? | Are there any vulnerabilities?
7. **效能** - 是否有效率? | Is it efficient?
8. **錯誤處理** - 錯誤處理是否妥當? | Are errors handled properly?

## 評論前綴

| 前綴 | 意義 | 動作 | Action |
|------|------|------|--------|
| **BLOCKING** | 必須在合併前修復 | 必須修復 | Required |
| **IMPORTANT** | 應該修復 | 建議修復 | Recommended |
| **SUGGESTION** | 錦上添花 | 可選改善 | Optional |
| **QUESTION** | 需要說明 | 需要討論 | Discuss |
| **NOTE** | 資訊性 | 僅供參考 | FYI |

## 使用方式

- `/code-review` - 審查目前分支的所有變更
- `/code-review src/auth.js` - 審查特定檔案
- `/code-review feature/login` - 審查特定分支

## 下一步引導

`/code-review` 完成後,AI 助手應建議:

> **程式碼審查完成。建議下一步:**
> - 有 ❗ BLOCKING 項目 → 修復後重新執行 `/code-review`
> - 全部通過 → 執行 `/checkin` 品質關卡 ⭐ **推薦**
> - 僅有 💡 SUGGESTION → 執行 `/commit` 提交變更
> - 審查中發現規範不實用或缺失 → 執行 `/audit --report` 回報

## 參考

- [Pre-Commit Checklist(提交前檢查清單)](./checkin-checklist.md) — 提交之前當作最後一道檢查時讀它。
- 詳細指南:[guide.md](./guide.md)
- 核心規範:[code-review-checklist.md](../../../../core/code-review-checklist.md)


## AI 代理行為

> 完整的 AI 行為定義請參閱對應的命令文件:[`/code-review`](../../../../skills/commands/code-review.md#ai-agent-behavior--ai-代理行為)
Files in this package (4)
  • SKILL.md 4 KB
  • checkin-checklist.md 5 KB
  • guide.md 6 KB
  • review-checklist.md 5 KB

Versions

RepositoryScoreLicence
This page · AsiaOstrich/universal-dev-standards90MIT
timwukp/agent-skills-best-practice100MIT
ArabelaTso/Skills-4-SE95Apache-2.0
MuhammadUsmanGM/Skills_Assignment90MIT

Identical content appears in 1 other GitHub folders. We show one copy with the highest score.

Database snapshot: 13.11.2026 · package version e5aed241f069 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 85code-review
    [UDS] 系統性程式碼審查的參考資料:八大審查類別,以及 BLOCKING/IMPORTANT/SUGGESTION 評論前綴。 Use when: 審查 pull request 或 diff、決定審查意見的措辭與優先序、與團隊議定審查範圍。 Not for: 執行有關卡的審查流程——該部分已移至採用層(XSPEC-095);提交前的關卡驗證——請用 /checkin。 Keywords: code review, pull request review, review checklist, BLOCKING, comment prefix,…
  • 95code-review
    [UDS] Reference for systematic code review: eight review categories and BLOCKING/IMPORTANT/SUGGESTION comment prefixes. Use when: reviewing a pull request or diff, deciding how to phrase and prioritise review comments, agreeing review scope with a team. Not for: executing a…
  • 100code-review
    Use when creating or submitting a pull request, reviewing a diff or PR from another developer, addressing PR feedback, or running a post-implementation review cycle on local changes. Uses standard git and GitHub CLI (`gh`) commands and classifies findings by severity (CRITICAL/IMPORTANT/SUGGESTION).
  • 100review-pr
    Review a pull request for code quality and security issues. Use when the user wants to review a PR, check PR code changes, or audit a pull request. Triggers on: "review PR", "review pull request", "check this PR", "the `review-pr` skill".
  • 100code-review-patterns
    Code review checklist, what to look for, how to give feedback, PR review flow. Use when reviewing a pull request, or when preparing code for review.
  • 90code-review
    Reviews a pull request against this repository's blocking criteria and reports only findings that name a failure mode. Use when reviewing a change, a pull request or a diff.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.