القائمة
使用 Minion 框架进行智能代码审查
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
ECharts图表配置技能，包括柱状图、折线图、组合图等可视化组件
车险经营数据导入技能，支持CSV/JSON解析、验证、优先级管理
KPI指标计算技能，包括目标拆解、达成率、增长率、时间进度等核心业务计算
使用 Minion 框架进行智能业务分析
使用 Minion 框架进行智能数据验证
使用 Minion 框架生成智能测试用例
| name | code-review |
| description | 使用 Minion 框架进行智能代码审查 |
| license | MIT |
| version | 1.0.0 |
| category | minion-integration |
此技能提供基于 Minion 的代码审查能力，特别关注业务规则符合性、文档一致性、类型安全等。与项目文档系统深度集成，确保代码质量。
代码变更检测
↓
Claude Code 调用此 Skill
↓
提取代码和相关文档
↓
调用 Minion 进行审查
↓
生成审查报告
↓
显示问题和建议
// 1. 提取代码和文档
const codeChanges = await extractModifiedFiles('src/domain/');
const relatedDocs = await findRelatedDocs(codeChanges);
// 2. 调用 Minion 审查
import { callMinionAPI } from '@/lib/minion-client';
const review = await callMinionAPI({
endpoint: '/api/review',
method: 'POST',
body: {
files: codeChanges,
documents: relatedDocs,
checks: {
businessRules: true,
docConsistency: true,
docTags: true,
typeSafety: true
}
}
});
// 3. 处理审查结果
if (review.criticalIssues > 0) {
blockCommit(review.issues);
} else {
showReviewReport(review);
}
// 使用现有的文档索引
import { docsIndex, codeIndex } from '@/lib/indices';
// 检查文档-代码一致性
const consistencyCheck = await callMinionAPI({
endpoint: '/api/check-consistency',
method: 'POST',
body: {
codeFile: 'src/domain/time.ts',
documentedIn: codeIndex['src/domain/time.ts'].documentedIn
}
});
# .git/hooks/pre-commit
#!/bin/bash
echo "🔍 Running code review..."
# 标准检查
pnpm typecheck || exit 1
pnpm docs:check || exit 1
# Minion 深度审查（可选）
if [ -n "$ENABLE_MINION_REVIEW" ]; then
pnpm minion:review || exit 1
fi
echo "✅ Code review passed"
启用 Minion 审查：
export ENABLE_MINION_REVIEW=true
git commit -m "feat: add new feature"
检查内容：
示例：
// ✅ 正确：null 安全
export function calculateAchievementRate(
actual: number,
target: number
): number | null {
if (target === 0) return null; // 符合规范
return actual / target;
}
// ❌ 错误：返回 0
if (target === 0) return 0; // 不符合 null 安全规范
检查内容：
示例：
/**
* Calculate year-over-year growth rate
*
* @doc docs/business/指标定义规范.md:69 ← 必需
* @formula (current - baseline) / baseline ← 推荐
*
* @param current Current period value
* @param baseline Baseline period value
* @returns Growth rate (0-1) or null if baseline is 0
*/
export function calculateGrowthRate(...) { }
检查内容：
示例：
// ✅ 正确：完整类型定义
function calculateTimeProgress(
currentMonth: number,
mode: 'linear' | 'weighted' | '2025-actual'
): number | null {
// ...
}
// ❌ 错误：使用 any
function calculateTimeProgress(mode: any): any {
// ...
}
检查内容：
示例：
// ✅ 正确：Domain 层纯函数
// src/domain/achievement.ts
export function calculateAchievementRate(...) {
// 纯计算，无副作用
}
// ❌ 错误：Domain 层有副作用
export function calculateAchievementRate(...) {
fetch('/api/data'); // 不应该有网络请求
localStorage.setItem(...); // 不应该有 I/O
}
{
"files": [
{
"path": "src/domain/time.ts",
"content": "export function calculateTimeProgress() {...}"
}
],
"documents": [
{
"path": "docs/business/指标定义规范.md",
"content": "..."
}
],
"checks": {
"businessRules": true,
"docConsistency": true,
"docTags": true,
"typeSafety": true
}
}
{
"summary": {
"filesReviewed": 5,
"issuesFound": 12,
"criticalIssues": 2
},
"issues": [
{
"file": "src/domain/time.ts",
"line": 25,
"type": "missing-doc-tag",
"severity": "error",
"message": "Function calculateTimeProgress missing @doc tag",
"suggestion": "Add @doc docs/business/指标定义规范.md:26"
},
{
"file": "src/domain/achievement.ts",
"line": 42,
"type": "null-safety-violation",
"severity": "warning",
"message": "Returning 0 instead of null when target is 0",
"suggestion": "Return null to comply with null-safety specification"
}
],
"metrics": {
"docCoverage": 0.92,
"typeSafetyScore": 0.95,
"businessRuleCompliance": 0.88
}
}
// 开发阶段：使用快速检查
pnpm typecheck
// PR 阶段：使用完整审查
pnpm docs:check
ENABLE_MINION_REVIEW=true git commit
| 级别 | 类型 | 处理方式 |
|---|---|---|
| Critical | 类型错误、文档缺失 | 阻止提交 |
| Warning | 命名不规范、注释不完整 | 建议修复 |
| Info | 优化建议 | 可选修复 |
// 自动修复：格式问题
const fixed = await autoFixCode(issue);
await writeFile(issue.file, fixed);
// 半自动：标签添加
const suggestion = generateDocTag(functionInfo);
console.log('建议添加:', suggestion);
// 用户手动添加
// 手动修复：业务逻辑
console.log('请手动审查业务逻辑:', issue.message);
// 记录常见问题模式
const patterns = await analyzeReviewHistory();
console.log('常见问题:', patterns.top(5));
// 更新审查规则
await updateReviewRules(patterns);
// 改进文档质量
const lowDocFiles = review.metrics.lowDocCoverage;
await improveDocumentation(lowDocFiles);