スキルの作成と変更

skills/
├── sync/
│   └── SKILL.md              # 同期スキル
├── security-scan/
│   └── SKILL.md              # セキュリティ検査スキル
├── meeting-facilitation/
│   └── SKILL.md              # 会議進行スキル
├── research/
│   └── SKILL.md              # リサーチスキル
└── my-reviewer/              # ★ 私たちが作るスキル
    └── SKILL.md

---
name: my-reviewer
status: active
description: Reviews document quality and provides structured feedback. Checks readability, consistency, and completeness of markdown documents.
owner: pm
version: "1.0.0"
metadata:
  type: quality
  triggers:
    - "review document"
    - "check quality"
    - "quality review"
---

## Overview

このスキルはマークダウン文書の品質を総合的にレビューします。
可読性・一貫性・完成度の3つの観点から文書を評価し、
構造化されたフィードバックを提供します。

## When to Use

ユーザーが次のような依頼をするときに有効化されます:
- 「文書をレビューして」
- 「文書の品質を確認して」
- 「品質レビューをして」

また、他のエージェントが文書完成後に品質レビューを
必要とするとき、PMが自動的にディスパッチすることも
できます。

## Steps

1. **対象ファイルの確認** — レビューする文書ファイルのパスを確認します。
2. **文書の読み込み** — 対象ファイルを読み込み内容を分析します。
3. **可読性レビュー** — 文の長さ、段落構成、見出し階層を検査します。
4. **一貫性レビュー** — 用語の使用、書式スタイル、日付形式を検査します。
5. **完成度レビュー** — 欠落セクションや不完全な文を確認します。
6. **フィードバック作成** — レビュー結果を構造化された形式にまとめます。

## Expected Outputs

- レビューレポート（stdout またはファイル出力）
- 問題リスト（項目ごとの深刻度: 警告/修正推奨/エラー）
- 改善提案リスト

## Examples

**例1:** ユーザーが「この文書をレビューして」と依頼
→ 対象文書を読み込み、5項目を点検したうえで、
  構造化されたフィードバックを提供します。

**例2:** PMがハンドブック執筆完了後に自動ディスパッチ
→ 完成したHTMLファイルのマークダウンソースをレビューし、
  執筆ガイドラインの遵守状況を報告します。

| my-reviewer | `skills/my-reviewer/SKILL.md` | quality | Checks readability, consistency, completeness | active | 1.0.0 |

- **name:** my-reviewer
  **path:** skills/my-reviewer/SKILL.md
  **version:** 1.0.0
  **status:** active
  **owner:** pm
  **type:** quality

# スキル同期スクリプトの実行
bun scripts/sync-skills.ts

---
name: my-reviewer
status: active
description: >
  Reviews document quality and provides structured feedback.
  Checks readability, consistency, and completeness of
  markdown documents. Outputs a structured review report
  with severity levels and improvement suggestions.
owner: pm
version: "1.0.0"
metadata:
  type: quality
  triggers:
    - "review document"
    - "check quality"
    - "quality review"
    - "문서 검토"
    - "품질 확인"
---

## Overview

This skill performs a comprehensive quality review of
markdown documents. It evaluates documents from three
perspectives: readability, consistency, and completeness,
then provides structured feedback with actionable suggestions.

Scope: markdown (.md) files in the project workspace.

## When to Use

Activate this skill when:
- The user requests a document review
- A document has been newly created or significantly revised
- PM dispatches quality review as part of a pipeline gate
- The user asks to "check quality" or "review document"

## Steps

1. **Identify target file** — Confirm the file path of the
   document to review. If not specified, ask the user.
2. **Read the document** — Load the full content of the
   target file.
3. **Readability check** — Evaluate sentence length,
   paragraph structure, heading hierarchy, and overall
   flow. Flag sections that are hard to follow.
4. **Consistency check** — Verify terminology usage, format
   style, date format, heading capitalization, and list
   formatting across the entire document.
5. **Completeness check** — Identify missing sections,
   incomplete sentences, broken references, and unresolved
   TODO markers.
6. **Generate review report** — Compile findings into a
   structured report with severity levels:
   - INFO: minor suggestions
   - WARNING: recommended improvements
   - ERROR: issues that must be fixed

## Expected Outputs

- Structured review report (stdout)
- Issue count by severity (INFO / WARNING / ERROR)
- Prioritized improvement suggestions

## Examples

**Example 1:** User says "review document"
→ Read the specified file, run all 3 checks,
  output a structured review report.

**Example 2:** PM dispatches after handbook chapter
  completion
→ Review the chapter HTML source, check authoring
  guideline compliance, report findings.