review-workflow

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Review Workflow

评审工作流

Overview

概述

review-workflow provides complete quality assurance by orchestrating three complementary review skills into a comprehensive validation workflow.

Purpose: Complete quality assurance from quality gating through comprehensive review to functional testing

Component Skills:

skill-validator - Pass/fail quality gate (minimum standards)
review-multi - Comprehensive multi-dimensional review (1-5 scoring)
skill-tester - Functional testing in real scenarios

Workflow Pattern: Sequential (validator → review → testing)

Result: Complete quality assessment with deployment decision, quality scores, and functional validation

review-workflow 通过将三种互补的评审技能编排为一个全面的验证工作流，提供完整的质量保证。

用途：从质量门禁、全面评审到功能测试的完整质量保证

组成技能:

skill-validator - 合格/不合格质量门禁（最低标准检查）
review-multi - 多维度全面评审（1-5分评分制）
skill-tester - 真实场景下的功能测试

工作流模式：顺序执行（validator → 评审 → 测试）

结果：包含部署决策、质量评分与功能验证的完整质量评估报告

When to Use

适用场景

Pre-deployment quality assurance (complete validation before release)
Comprehensive quality checks (all aspects validated)
Certification process (validate skill meets all standards)
Major update validation (ensure quality maintained after changes)
Quality audit (periodic comprehensive checks)

部署前质量保证（发布前的完整验证）
全面质量检查（验证所有维度）
认证流程（验证Skill符合所有标准）
重大更新验证（确保变更后质量不受影响）
质量审计（定期全面检查）

Review Workflow

评审工作流

Step 1: Quality Gate Validation (skill-validator)

步骤1：质量门禁验证（skill-validator）

Purpose: Fast pass/fail check - ensures minimum standards met before deeper review

Component Skill: skill-validator

Process:

Run skill-validator on skill
Check all 4 validation operations:
- Structure validation
- Content validation
- Pattern validation
- Production readiness
Result: PASS or FAIL

Decision Point:

PASS → Proceed to Step 2 (comprehensive review)
FAIL → Stop, fix critical issues, re-run Step 1

Outputs:

Validation report (pass/fail)
Critical issues list (if failed)
Go/no-go decision

Time Estimate: 30-45 minutes

用途：快速合格/不合格检查 - 确保在深入评审前达到最低标准

组成技能：skill-validator

流程:

对Skill运行skill-validator
检查全部4项验证操作:
- 结构验证
- 内容验证
- 模式验证
- 生产就绪性检查
结果：合格（PASS）/不合格（FAIL）

决策节点:

合格（PASS） → 进入步骤2（全面评审）
不合格（FAIL） → 终止流程，修复关键问题后重新运行步骤1

输出:

验证报告（合格/不合格）
关键问题列表（若不合格）
是否继续的决策

时间预估：30-45分钟

Step 2: Comprehensive Review (review-multi)

步骤2：全面评审（review-multi）

Purpose: Multi-dimensional quality assessment with 1-5 scoring

Component Skill: review-multi

Process:

Run all 5 review operations:
- Operation 1: Structure Review (5-10 min, automated)
- Operation 2: Content Review (15-30 min, manual)
- Operation 3: Quality Review (20-40 min, mixed)
- Operation 4: Usability Review (30-60 min, manual testing)
- Operation 5: Integration Review (15-25 min, manual)
Calculate weighted overall score
Map to grade (A/B/C/D/F)
Assess production readiness
Generate improvement recommendations

Outputs:

Overall score (1.0-5.0)
Grade (A/B/C/D/F)
Per-dimension scores
Production readiness assessment
Prioritized improvement recommendations

Time Estimate: 1.5-2.5 hours

用途：多维度质量评估，采用1-5分评分制

组成技能：review-multi

流程:

运行全部5项评审操作:
- 操作1：结构评审（5-10分钟，自动化）
- 操作2：内容评审（15-30分钟，人工）
- 操作3：质量评审（20-40分钟，混合模式）
- 操作4：可用性评审（30-60分钟，人工测试）
- 操作5：集成评审（15-25分钟，人工）
计算加权综合得分
映射为等级（A/B/C/D/F）
评估生产就绪性
生成改进建议

输出:

综合得分（1.0-5.0）
等级（A/B/C/D/F）
各维度得分
生产就绪性评估
优先级排序的改进建议

时间预估：1.5-2.5小时

Step 3: Functional Testing (skill-tester)

步骤3：功能测试（skill-tester）

Purpose: Validate skill works correctly in real scenarios

Component Skill: skill-tester

Process:

Run testing operations:
- Scenario Testing (test in realistic use case)
- Example Validation (verify examples execute)
- Integration Testing (test with other skills if applicable)
- Usability Testing (assess ease of use)
Document test results
Identify any functional issues

Outputs:

Scenario test results (success/failure)
Example validation results (all pass/some fail)
Integration test results
Usability assessment
Functional issues list (if any)

Time Estimate: 45-90 minutes

用途：验证Skill在真实场景中的正常运行

组成技能：skill-tester

流程:

运行测试操作:
- 场景测试（在真实用例中测试）
- 示例验证（验证示例可正常执行）
- 集成测试（若适用，测试与其他Skill的集成）
- 可用性测试（评估易用性）
记录测试结果
识别任何功能性问题

输出:

场景测试结果（成功/失败）
示例验证结果（全部通过/部分失败）
集成测试结果
可用性评估
功能性问题列表（若有）

时间预估：45-90分钟

Post-Workflow: Deployment Decision

工作流后：部署决策

After completing all 3 steps:

完成全部3个步骤后:

Aggregate Results

汇总结果

Quality Gate (Step 1):

PASS/FAIL status
Critical issues (if any)

Comprehensive Review (Step 2):

Overall score: X.X/5.0
Grade: A/B/C/D/F
Production readiness assessment
Improvement recommendations

Functional Testing (Step 3):

Scenario tests: Pass/Fail
Examples: All working/Some broken
Integration: Working/Issues
Usability: Good/Needs improvement

质量门禁（步骤1）:

合格/不合格状态
关键问题（若有）

全面评审（步骤2）:

综合得分：X.X/5.0
等级：A/B/C/D/F
生产就绪性评估
改进建议

功能测试（步骤3）:

场景测试：通过/失败
示例：全部正常/部分异常
集成：正常/存在问题
可用性：良好/需要改进

Make Deployment Decision

做出部署决策

Deploy Immediately:

Quality Gate: PASS
Overall Score: ≥4.5 (Grade A)
Functional Tests: All passing
Action: Deploy to production

Deploy with Notes:

Quality Gate: PASS
Overall Score: 4.0-4.4 (Grade B+)
Functional Tests: Passing
Action: Deploy, note improvements for next iteration

Hold for Improvements:

Quality Gate: PASS
Overall Score: 3.5-3.9 (Grade B-)
OR Functional Tests: Some failures
Action: Fix identified issues, re-run workflow

Do Not Deploy:

Quality Gate: FAIL
OR Overall Score: <3.5 (Grade C-F)
OR Functional Tests: Major failures
Action: Significant rework required

立即部署:

质量门禁：合格
综合得分：≥4.5（等级A）
功能测试：全部通过
操作：部署至生产环境

附带说明部署:

质量门禁：合格
综合得分：4.0-4.4（等级B+）
功能测试：全部通过
操作：部署，记录需改进点用于下一迭代

暂停部署待改进:

质量门禁：合格
综合得分：3.5-3.9（等级B-）
或功能测试：部分失败
操作：修复已识别问题，重新运行工作流

禁止部署:

质量门禁：不合格
或综合得分：<3.5（等级C-F）
或功能测试：重大失败
操作：需要进行重大返工

Best Practices

最佳实践

1. Always Run Complete Workflow

1. 始终运行完整工作流

Practice: Run all 3 steps before deployment (don't skip)

Rationale: Each step catches different issues - comprehensive coverage

实践：部署前运行全部3个步骤（请勿跳过）

理由：每个步骤发现不同类型的问题 - 实现全面覆盖

2. Fix Critical Issues Immediately

2. 立即修复关键问题

Practice: If Step 1 fails, fix issues before proceeding

Rationale: Wastes time to do comprehensive review on skill failing basic validation

实践：若步骤1失败，修复问题后再继续

理由：对未通过基础验证的Skill进行全面评审是浪费时间

3. Document All Findings

3. 记录所有发现

Practice: Record results from each step for complete record

Rationale: Enables tracking improvements over time, learning from patterns

实践：记录每个步骤的结果以形成完整记录

理由：便于跟踪长期改进情况，从问题模式中学习

4. Apply Improvements Iteratively

4. 迭代应用改进

Practice: Use Step 2 recommendations to plan next version

Rationale: Continuous improvement - each iteration gets better

实践：利用步骤2的建议规划下一版本

理由：持续改进 - 每次迭代都能提升质量

5. Re-Run After Major Changes

5. 重大变更后重新运行

Practice: Re-run workflow after applying significant improvements

Rationale: Validates improvements effective, no regressions introduced

实践：应用重大改进后重新运行工作流

理由：验证改进有效，且未引入回归问题

Quick Reference

快速参考

The 3-Step Review Workflow

三步评审工作流

Step	Skill	Purpose	Time	Output
1	skill-validator	Quality gate (pass/fail)	30-45m	PASS/FAIL, deploy decision
2	review-multi	Comprehensive review (1-5)	1.5-2.5h	Score, grade, recommendations
3	skill-tester	Functional testing	45-90m	Test results, functional validation

Total Time: 3-4 hours for complete QA

步骤	技能	目的	耗时	输出
1	skill-validator	质量门禁（合格/不合格）	30-45分钟	合格/不合格状态、部署决策
2	review-multi	全面评审（1-5分）	1.5-2.5小时	得分、等级、改进建议
3	skill-tester	功能测试	45-90分钟	测试结果、功能验证

总耗时：完整QA需3-4小时

Workflow Pattern

工作流模式

skill-validator (Quality Gate)
    ↓
  PASS? ──No──> Fix issues, retry
    ↓ Yes
review-multi (Comprehensive Review)
    ↓
Overall Score + Grade + Recommendations
    ↓
skill-tester (Functional Testing)
    ↓
Test Results + Usability Assessment
    ↓
Deployment Decision (Deploy/Hold/Rework)

skill-validator (Quality Gate)
    ↓
  PASS? ──No──> Fix issues, retry
    ↓ Yes
review-multi (Comprehensive Review)
    ↓
Overall Score + Grade + Recommendations
    ↓
skill-tester (Functional Testing)
    ↓
Test Results + Usability Assessment
    ↓
Deployment Decision (Deploy/Hold/Rework)

Deployment Decision Matrix

部署决策矩阵

Validator	Review Score	Tests	Decision
PASS	≥4.5 (A)	All Pass	✅ Deploy Now
PASS	4.0-4.4 (B+)	All Pass	✅ Deploy + Note Improvements
PASS	3.5-3.9 (B-)	Pass/Some Fail	⚠️ Hold - Fix Issues
PASS	<3.5 (C-F)	Any	❌ Rework Required
FAIL	Any	Any	❌ Fix Critical, Retry

验证器状态	评审得分	测试结果	决策
PASS	≥4.5（A）	全部通过	✅ 立即部署
PASS	4.0-4.4（B+）	全部通过	✅ 部署并记录改进点
PASS	3.5-3.9（B-）	通过/部分失败	⚠️ 暂停 - 修复问题
PASS	<3.5（C-F）	任意	❌ 需要返工
FAIL	任意	任意	❌ 修复关键问题后重试

Integration with Development

与开发流程的集成

Build skill (development-workflow) →
Review workflow (this skill) →
Apply improvements (skill-updater) →
Re-validate (review-workflow) →
Deploy

review-workflow provides complete quality assurance through orchestrated validation, review, and testing.

Build skill (development-workflow) →
Review workflow (this skill) →
Apply improvements (skill-updater) →
Re-validate (review-workflow) →
Deploy

review-workflow 通过编排验证、评审与测试流程，提供完整的质量保证。