skill-reviewer

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Skill Reviewer

Skill Reviewer

公式ベストプラクティスに基づいてスキルをレビューし、具体的な改善提案を行う。
Review skills based on official best practices and provide specific improvement suggestions.

レビューワークフロー

Review Workflow

Step 1: 対象スキルの特定

Step 1: Identify the Target Skill

レビュー対象の SKILL.md ファイルを特定する:
  • ユーザーがパスを直接指定している場合はそれを使用
  • カレントディレクトリで SKILL.md を検索
  • 複数のスキルが存在する場合は AskUserQuestion で選択させる(最大4件。それ以上は「Other」で直接入力)
Identify the SKILL.md file to be reviewed:
  • Use the path directly specified by the user if provided
  • Search for SKILL.md in the current directory
  • If multiple skills exist, let the user select via AskUserQuestion (max 4 items. For more than that, use 'Other' for direct input)

Step 2: 読み込みと分析

Step 2: Loading and Analysis

  1. 対象の SKILL.md ファイルを完全に読み込む
  2. best-practices.md でチェックリストを確認
  1. Fully load the target SKILL.md file
  2. Check the checklist in best-practices.md

Step 3: ベストプラクティスとの照合

Step 3: Alignment with Best Practices

best-practices.md の各カテゴリに照らして評価する。
Evaluate against each category in best-practices.md.

Step 4: レビューレポート生成

Step 4: Generate Review Report

以下の形式で出力する:
markdown
undefined
Output in the following format:
markdown
undefined

スキルレビューレポート: {skill-name}

Skill Review Report: {skill-name}

サマリー

Summary

  • 総合評価: {PASS | NEEDS_IMPROVEMENT | CRITICAL_ISSUES}
  • Critical: {件数}
  • Warning: {件数}
  • Info: {件数}
  • Overall Rating: {PASS | NEEDS_IMPROVEMENT | CRITICAL_ISSUES}
  • Critical: {count}
  • Warning: {count}
  • Info: {count}

Critical(必須修正)

Critical (Must Fix)

{修正必須の問題をリスト}
{List of issues requiring mandatory fixes}

Warning(推奨修正)

Warning (Recommended Fixes)

{推奨される改善をリスト}
{List of recommended improvements}

Info(改善提案)

Info (Improvement Suggestions)

{オプションの強化をリスト}
{List of optional enhancements}

具体的な推奨事項

Specific Recommendations

{例を含む具体的なアクションアイテム}
undefined
{Specific action items including examples}
undefined

Step 5: インタラクティブな改善

Step 5: Interactive Improvement

レポート提示後、AskUserQuestion で修正意向を確認する:
javascript
AskUserQuestion({
  questions: [{
    question: "指摘された問題を修正しますか?",
    header: "修正方針",
    options: [
      { label: "順々に確認しながら修正", description: "1件ずつ提案・確認しながら進める(推奨)" },
      { label: "Critical のみ修正",      description: "必須修正のみ自動適用する" },
      { label: "すべて自動修正",         description: "全問題を確認なしで修正する" },
      { label: "修正しない",             description: "レポートのみ参照する" }
    ],
    multiSelect: false
  }]
})
修正時のルール:
  • Critical 問題を優先する
  • 段階的に修正を適用する
  • 各修正後に再検証:修正済みの SKILL.md を Read で読み直し、該当項目が best-practices.md のチェックを満たしているか確認する
After presenting the report, confirm the user's intention to make fixes via AskUserQuestion:
javascript
AskUserQuestion({
  questions: [{
    question: "Would you like to fix the identified issues?",
    header: "Correction Strategy",
    options: [
      { label: "Fix while confirming one by one", description: "Proceed with proposals and confirmations one item at a time (Recommended)" },
      { label: "Fix only Critical issues",      description: "Automatically apply only mandatory fixes" },
      { label: "Fix all automatically",         description: "Fix all issues without confirmation" },
      { label: "Do not fix",             description: "Only refer to the report" }
    ],
    multiSelect: false
  }]
})
Rules for correction:
  • Prioritize Critical issues
  • Apply fixes incrementally
  • Re-verify after each fix: Re-read the corrected SKILL.md with Read and check if the corresponding item meets the checklist in best-practices.md