skill-reviewer

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

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

対象の SKILL.md ファイルを完全に読み込む
best-practices.md でチェックリストを確認

Fully load the target SKILL.md file
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