shield_lock
金大哥
← 返回 Skill 列表
extension
分类: 开发与工程无需 API Key

ensuring-prompt-quality

根据最佳实践验证提示文件。在创建或编辑.agents/目录下的规则、技能、代理、命令后，用于质量审查。

person作者: jakexiaohubgithub
open_in_new仓库download下载资源包

Prompt Quality Skill

プロンプトファイルの品質を検証するスキルです。

記載ルール

作成・編集時は以下のルールを参照:

検証観点

| # | 観点 | 概要 | |---|------|------| | 1 | 明確性と具体性 | 曖昧な表現を避け、具体的な指示 | | 2 | 構造化と可読性 | 適切な見出し、500行以下 | | 3 | 具体例の提供 | Before/After 形式のコード例 | | 4 | スコープの適切性 | タスク非依存、リポジトリレベル | | 5 | Progressive Disclosure | 参照1階層、100行超は目次 | | 6 | 重複と矛盾の回避 | DRY原則 | | 7 | Workflow & Feedback Loops | チェックリスト、検証ループ | | 8 | 命名とパス適用 | gerund形式、paths/globs | | 9 | アクション指向 | 動詞から始まる指示 | | 10 | メタデータの完全性 | 第三人称、トリガー含む | | 11 | トーンと文体 | 命令形、一貫性 | | 12 | テンプレートと例 | 出力形式テンプレート | | 13 | アンチパターン検出 | Windows パス、時間依存 | | 14 | 簡潔性 | 既知情報の繰り返しなし |

詳細は参照ファイルを確認:

Workflow

品質検証時にこのチェックリストをコピー:

Quality Validation:
- [ ] Step 1: ファイルタイプを特定（skill/rule/agent/command）
- [ ] Step 2: 対応するルールを参照
- [ ] Step 3: メタデータを検証
- [ ] Step 4: コンテンツを検証（14観点）
- [ ] Step 5: ファイルサイズを確認
- [ ] Step 6: レポートを生成

Step 1: ファイルタイプを特定

# パスからタイプを判定
.agents/skills/    → Skill
.agents/rules/     → Rule
.agents/agents/    → Agent
.agents/commands/  → Command

Step 2: 対応するルールを参照

Read: .agents/rules/writing-{type}.md

Step 3: メタデータを検証

# 一人称・二人称チェック
grep -n "I can\|I will\|You can\|You should" [file]

# 第三人称 + トリガー確認
grep -n "description:" [file]

チェック項目:

  • [ ] name: 64文字以内、小文字・数字・ハイフン
  • [ ] description: 第三人称、トリガー含む、1024文字以内
  • [ ] paths/globs/allowed-tools: 適切に設定

Step 4: コンテンツを検証

# 曖昧表現
grep -i "できれば\|なるべく\|maybe\|perhaps" [file]

# Windows パス
grep -n "\\\\" [file]

# 時間依存情報
grep -ni "before.*20[0-9][0-9]\|after.*20[0-9][0-9]" [file]

# Workflow チェックリスト
grep -n "- \[ \]" [file]

Step 5: ファイルサイズを確認

wc -l [file]
# 500行以下推奨

Step 6: レポートを生成

report-template.md 形式で出力。

If validation fails, identify issues and recommend fixes.

クイック検証

単一ファイルの簡易チェック:

# 行数
wc -l [file]

# メタデータ
head -10 [file]

# アンチパターン
grep -n "I can\|You can\|\\\\" [file]

参照ファイル