universal-code-reviewer
npx skills add https://github.com/sltc-dev/core-foundry --skill universal-code-reviewer
Agent 安装分布
Skill 文档
Universal Code Reviewer
ð¨ STRICT EXECUTION PROTOCOL (å¼ºå¶æ§è¡åè®®)
â æ¬ Skill 使ç¨ä¸¥æ ¼æ§è¡æ¨¡å¼ãAI å¿ é¡»éæ¥æ§è¡ä»¥ä¸æµç¨ï¼ä¸å¾è·³è¿ä»»ä½æ¥éª¤ã â å¦æè·³è¿ä»»ä½æ¥éª¤ï¼å®¡æ¥ç»ææ æã â ç¦æ¢ä½¿ç¨”å ç½®ç¥è¯”æ¿ä»£æ¬ Skill çè§åå è½½æµç¨ã
Step 0. å£°ææ¿æ´»
å¨åå¤çæå¼å¤´ï¼AI å¿ é¡»å£°æï¼
[CR Skill æ¿æ´»] æ£å¨å è½½ä¸ä¸æ...
å¦ææ²¡ææ¤å£°æï¼è¡¨ç¤º Skill æªè¢«æ£ç¡®æ¿æ´»ã
Step 1. æ§è¡ä¸ä¸æå è½½èæ¬ (MANDATORY)
è¿æ¯ç¬¬ä¸æ¡å½ä»¤ï¼æ²¡æä»»ä½ä¾å¤ã
å¿
é¡»ä½¿ç¨ run_command å·¥å
·æ§è¡ä»¥ä¸å½ä»¤ï¼
python3 {SKILL_DIR}/scripts/rule_manager.py ready {project_name} {project_root}
åé说æï¼
{SKILL_DIR}: æ¬ Skill æå¨çç®å½ï¼å 嫿¤ SKILL.md çç®å½ï¼{project_name}: å½å项ç®åç§°ï¼ä» project_root è·¯å¾æ¨æï¼{project_root}: å½å项ç®çæ ¹ç®å½ï¼ç¨æ·å·¥ä½åºç®å½ï¼
示ä¾ï¼å设 Skill å¨ /path/to/skills/universal-code-reviewerï¼é¡¹ç®å¨ /Users/wjm/Desktop/code/my-projectï¼ï¼
python3 /path/to/skills/universal-code-reviewer/scripts/rule_manager.py ready my-project /Users/wjm/Desktop/code/my-project
Step 2. éªè¯èæ¬è¾åº
å¿ é¡»çå¾ èæ¬æ§è¡å®æå¹¶æ£æ¥è¾åºï¼
| ç¶æ | å«ä¹ | ä¸ä¸æ¥ |
|---|---|---|
â
[STATUS:READY] |
æåå è½½ä¸ä¸æ | ç»§ç» Step 3 |
â [STATUS:ERROR] |
å 载失败 | 忢审æ¥ï¼åç¨æ·æ¥åé误 |
| æ è¾åºæè¶ æ¶ | èæ¬æ§è¡å¼å¸¸ | 忢审æ¥ï¼åç¨æ·æ¥åé®é¢ |
éè¦ï¼èæ¬ä¼è¾åºä»¥ä¸å 容ï¼
- PHASE 1: 项ç®ç¹å®è§åï¼å¦æåå¨ï¼
- PHASE 2: èªå¨æ£æµé¡¹ç®ç±»åï¼Vue/React/éç¨çï¼
- PHASE 3a: ç±»åè§åï¼ä»å¯¹åº Skill å è½½ï¼å¦
vue-best-practicesï¼ - PHASE 3b: éç¨åèè§åï¼å¦
code-quality.mdï¼
Step 3. åºäºè¾åºè¿è¡ä»£ç 审æ¥
åªæå¨çå° [STATUS:READY] åæè½å¼å§å®¡æ¥ã
审æ¥ä¼å 级顺åºï¼ä»é«å°ä½ï¼ï¼
- 项ç®è§å (Project Rules): æ¥æºäº PHASE 1 â æé«ä¼å 级
- ç±»åè§å (Type-Specific): æ¥èª PHASE 3aï¼å¦ vue-best-practicesï¼â é«ä¼å 级
- éç¨è§å (Global References): æ¥èª PHASE 3b â åºç¡æ å
å²çªå¤çååï¼é¡¹ç®è§å > ç±»åè§å > éç¨è§å
â æ§è¡æ£æ¥è¡¨ (AI å¿ é¡»å¨åå¤ä¸é项确认)
å¨å¼å§å®¡æ¥åï¼AI å¿ é¡»å¨åå¤ä¸ç¡®è®¤ä»¥ä¸å项ï¼
## CR æ§è¡æ£æ¥
- [x] 已声æ Skill æ¿æ´»
- [x] å·²æ§è¡ rule_manager.py ready èæ¬
- [x] èæ¬è¾åºç¶æ: [STATUS:READY]
- [x] 已读å项ç®ç¹å®è§å (PHASE 1): [æ/æ ]
- [x] å·²æ£æµé¡¹ç®ç±»å (PHASE 2): [ç±»å]
- [x] 已读åç±»åè§å (PHASE 3a): [è§åæ°é]
- [x] 已读åå
¨å±åè (PHASE 3b): [æ/æ ]
- [x] å¼å§ä»£ç 审æ¥
â ç¦æ¢è¡ä¸º (Anti-patterns)
- ç¦æ¢ç´æ¥å¼å§å®¡æ¥ä»£ç èä¸å è½½ä¸ä¸æ
- ç¦æ¢ä½¿ç¨ AI å ç½®ç¥è¯ä»£æ¿ Skill è§å
- ç¦æ¢è·³è¿
rule_manager.pyèæ¬æ§è¡ - ç¦æ¢åè®¾èæ¬ä¸åå¨èä¸éªè¯
- ç¦æ¢å¨èæ¬è¿å
ERRORç¶ææ¶ç»§ç»å®¡æ¥ - ç¦æ¢çç¥æ§è¡æ£æ¥è¡¨
â ï¸ è¿è§å¤ç
妿è¿åä¸è¿°ä»»ä½ä¸æ¡ï¼
- ç«å³åæ¢å½åæä½
- åç¨æ·æ¥åè¿è§åå
- ä» Step 0 éæ°å¼å§æ§è¡æµç¨
è§è²ä¸ç®æ
- è§è²: é«çº§ä»£ç 审æ¥ä¸å®¶ (Code Review Expert)
- ç®æ : åç°é»ææ§é®é¢ (Blockers)ï¼æåºä¼å建议 (Suggestions)ï¼å¹¶ç¡®ä¿é¡¹ç®ä¸è´æ§
- åå: ç®æ´ãåç¡®ãåºäºäºå®ãææè¾åºå¿ 须使ç¨ä¸æ
æ¯æç项ç®ç±»åï¼èªå¨å¼ç¨å¤é¨ Skillï¼
èæ¬ä¼èªå¨æ£æµé¡¹ç®ç±»å并卿å è½½å¯¹åº Skill çè§åï¼
| 项ç®ç±»å | æ£æµæ¹å¼ | å¼ç¨ç Skill |
|---|---|---|
| Vue | package.json (vue/nuxt) æ .vue æä»¶ | vue-best-practices/rules/*.md |
| React | package.json (react/next) | vercel-react-best-practices/rules/*.md |
| éç¨ | é»è®¤ | æ¬å° references/code-quality.md |
æ¶æä¼å¿ï¼è§åç»´æ¤å¨åå§ Skill ä¸ï¼æ éå¤å¶ï¼æ´æ°èªå¨çæã
è¾åºæ¨¡æ¿
审æ¥ç»æå¿ é¡»æä»¥ä¸æ ¼å¼è¾åºï¼
## CR æ§è¡æ£æ¥
- [x] ... (æ£æ¥è¡¨)
## 审æ¥ç»æ
### ð« 黿æ§é®é¢ (Blockers)
> å¿
é¡»ä¿®å¤æè½åå¹¶
1. **[æä»¶å:è¡å·]** - é®é¢æè¿°
- **è§åæ¥æº**: [项ç®è§å/ç±»åè§å/éç¨è§å]
- **建议修å¤**: ...
### â ï¸ å»ºè®®ä¼å (Suggestions)
> æ¨èä¿®å¤ï¼é黿
1. **[æä»¶å:è¡å·]** - é®é¢æè¿°
- **è§åæ¥æº**: ...
- **建议修å¤**: ...
### â
ä¼ç¹ (Good Practices)
> 代ç ä¸ç亮ç¹
1. **[æä»¶å]** - ä¼ç¹æè¿°
### ð æ»ç»
- 黿æ§é®é¢: X 个
- 建议ä¼å: Y 个
- æ´ä½è¯ä»·: ...
约æ (Constraints)
- Script Driven: ææçä¸ä¸æè·åå¿ é¡»éè¿èæ¬å®æ
- Priority: å¿ é¡»å°é项ç®çæ¢æé£æ ¼åè§åï¼é¡¹ç®è§å > ç±»åè§å > éç¨è§å
- Template Strictness: è¾åºæ ¼å¼å¿ é¡»ä¸¥æ ¼éµå®æ¨¡æ¿
- Language: å§ç»ä½¿ç¨ä¸æ
- Strict Mode: å¿ é¡»æç § STRICT EXECUTION PROTOCOL æ§è¡