Enterprise Code Review_开发编程 skill-PHP中文网

Enterprise Code Review

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

執行標準化程式碼審查流程，依序檢查程式碼品質、安全性、可維護性，並產出結構化的審查報告

代码审查流程（Code Review）

功能概述

代码审查流程（Code Review）是一项面向实际任务的技能，主要用于当使用者要求审查代码、Pull Request 或提交记录时，启动此审查流程；

核心要点

Step 1：获取代码；
使用 exec 工具或 git-read 工具获取待审查的代码内容；
若使用者提供的是 PR URL，需先获取 diff；

使用与执行

Step 2：依次执行四个审查维度；维度 A：代码质量；命名是否清晰（变量、函数、类名称）；函数是否符合单一职责原则等。该流程将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。

结果检查与注意事项

实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。

程式碼審查流程（Code Review）

觸發時機

當使用者要求審查程式碼、Pull Request 或提交記錄時，啟動此審查流程。

審查步驟

Step 1：取得程式碼

使用 exec 工具或 git-read 工具取得要審查的程式碼內容。若使用者提供的是 PR URL，需先取得 diff。

Step 2：依序執行四個審查維度

維度 A：程式碼品質

命名是否清晰（變數、函數、類別名稱）
函數是否符合單一職責原則（SRP）
是否有明顯的重複代碼（DRY 原則）
複雜度是否合理（循環複雜度 ≤ 10）

維度 B：安全性

輸入驗證是否完整
是否有 SQL Injection、XSS 等常見漏洞風險
敏感資訊（API Key、密碼）是否未被 hardcode

維度 C：可維護性

是否有足夠的註解（複雜邏輯必須有說明）
單元測試覆蓋率是否足夠（核心邏輯 ≥ 80%）
錯誤處理是否完整

維度 D：效能

是否有明顯的 N+1 查詢問題
是否有不必要的重複計算

Step 3：產出審查報告

使用以下格式輸出：

## 程式碼審查報告

**審查對象：** [檔案名稱或 PR 標題]
**審查日期：** [今天日期]
**整體評級：** [A/B/C/D]

### 問題清單
| 嚴重度 | 維度 | 位置 | 問題描述 | 建議修改 |
|--------|------|------|----------|----------|
| 🔴 高 | 安全 | line 42 | ... | ... |
| 🟡 中 | 品質 | line 67 | ... | ... |

### 優點記錄
- [列出 1～3 個值得肯定的設計決策]

### 總結建議
[2～3 句總結，說明最值得優先處理的問題]