Claude Code特集:mdファイルの書き方とサンプル集

your-project/
├── CLAUDE.md                  # プロジェクトの説明書(チームで共有)
├── CLAUDE.local.md            # 自分だけのメモ(.gitignore に入れる)
├── .mcp.json                  # MCPサーバーの設定(チームで共有)
└── .claude/
    ├── settings.json          # 権限・Hooks などの設定(チームで共有)
    ├── settings.local.json    # 自分だけの設定
    ├── rules/                 # 分野別のルール(CLAUDE.md の分割)
    │   └── templates.md
    ├── skills/                # スキル(手順書)。/スキル名 で呼べる
    │   └── update-pricing/
    │       └── SKILL.md
    ├── agents/                # サブエージェント
    │   └── code-reviewer.md
    └── hooks/                 # Hooks から呼ぶスクリプト
        └── protect-files.sh

~/.claude/                     # 自分のPC全体(すべてのプロジェクト)に効く
├── CLAUDE.md
├── settings.json
├── skills/
└── agents/

# Keep Up With AI

AI企業の公式発表をRSSで集め、Claude APIで日本語3行に要約し、静的サイトとして公開する。

## よく使うコマンド
- 手元で確認: `python run.py --feed tests/sample_feed.xml --dry-run --data /tmp/test.json --serve`
- ページだけ作り直す: `python run.py --build-only --serve`(http://localhost:8000/)
- `public/` は生成物。直接編集しない(テンプレートは `templates/`、CSSは `static/style.css`)

## 構成
- 収集 `aicatchup/collect.py` → 要約 `aicatchup/summarize.py` → HTML生成 `aicatchup/build.py`
- 記事データは `data/articles.json`(GitHub Actions が自動でコミットする。手で編集しない)
- 設定は `config.yaml`、広告は `affiliates.yaml`、料金比較は `pricing.yaml`

## ルール
- 画面に出す文言・コメントは日本語で書く
- URLは拡張子なし(`/about`)。リンクは `{{ root_path }}` から始める
- 広告枠には必ず「PR」を表示する(ステマ規制対応)。外さない
- 元記事の本文は取得・保存しない。RSSの抜粋とメタ情報だけを使う

## 詳しい資料
- 公開手順と運用: @README.md

---
paths:
  - "templates/**/*.html"
  - "static/**/*.css"
---

# テンプレートとCSSのルール

- 色は `static/style.css` の `:root` にある変数(`--ink`, `--accent` など)だけを使う
- ダークモードでも読めるか、`prefers-color-scheme: dark` の値も確認する
- スマホ幅(400px)で横スクロールが出ないようにする。表は `.table-scroll` で囲む
- 新しいページは `build.py` の `page()` で出力する(sitemap に自動で載る)

---
description: コミットしていない変更を要約し、危なそうな点を指摘する。「何を変えた?」「コミットメッセージを考えて」「差分を見て」と頼まれたときに使う。
allowed-tools: Bash(git diff *) Bash(git status *)
---

## 現在の変更

!`git diff HEAD`

## 手順

1. 上の差分を箇条書き2〜3行で要約する
2. エラー処理の漏れ、値の直書き、更新が必要なテストなど、気になる点を挙げる
3. 差分が空なら「コミットしていない変更はありません」とだけ答える

---
description: pricing.yaml の料金を各社の公式ページで確認して更新する。料金比較ページの更新を頼まれたときに使う。
argument-hint: "[サービス名(省略すると全サービス)]"
disable-model-invocation: true
allowed-tools: Read Edit WebFetch
---

# 料金表の更新

対象: $ARGUMENTS(空なら pricing.yaml の全サービス)

1. `pricing.yaml` を読み、対象サービスの `sources` のURLを開く
2. 月額プランとAPI料金(100万トークンあたりの入力・出力)を公式ページの値と照らし合わせる
3. 違う値だけを書き換える。公式ページで確認できた項目は `verified: true` にする
4. 公式ページが開けない・値が見つからない項目は書き換えず、`verified: false` のままにする
5. `checked` を今日の日付にする
6. 最後に、変えた項目を「サービス / 項目 / 旧 → 新」の表で報告する

比較記事やまとめサイトの値で書き換えないこと。

---
name: code-reviewer
description: コードの変更をレビューする専門家。コードを書いたり直したりした直後に、積極的に(use proactively)使う。
tools: Read, Grep, Glob, Bash
model: sonnet
---

あなたはこのプロジェクトのシニアエンジニアとしてコードレビューを行う。

呼ばれたら:
1. `git diff` で変更点を確認する
2. 変更されたファイルを中心に読む
3. すぐにレビューを始める

確認すること:
- 動作の誤り(境界値、空のデータ、例外処理)
- 秘密情報(APIキーなど)の直書き
- 既存の書き方や命名とのずれ
- テストや README の更新漏れ

報告の形:
- 「必ず直す」「直した方がよい」「検討」の3段階に分ける
- 各項目に `ファイル名:行番号` と、具体的な直し方を書く
- 問題がなければ「指摘なし」とだけ書く。ファイルは編集しない

---
name: test-runner
description: テストを実行して失敗だけを報告する。テストの実行や、失敗の原因調査を頼まれたときに使う。
tools: Bash, Read, Grep
model: haiku
---

テストを実行し、結果を短く報告する。

1. テストを実行する(コマンドは CLAUDE.md の「よく使うコマンド」に従う)
2. すべて通ったら「全件成功(件数)」とだけ報告する
3. 失敗があれば、失敗ごとに次の3行だけを返す
   - テスト名
   - エラーメッセージの要点(1行)
   - 原因と思われる箇所(`ファイル名:行番号`)

ログ全文は返さない。コードは修正しない。

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/protect-files.sh"
          }
        ]
      }
    ],
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write"
          }
        ]
      }
    ]
  }
}

#!/bin/bash
# 編集されたくないファイルへの Edit / Write を止める

INPUT=$(cat)
FILE_PATH=$(echo "$INPUT" | jq -r '.tool_input.file_path // empty')

# Windows の区切り文字 \ を / にそろえる
FILE_PATH="${FILE_PATH//\//}"

PROTECTED_PATTERNS=(".env" "package-lock.json" ".git/" "data/articles.json")

for pattern in "${PROTECTED_PATTERNS[@]}"; do
  if [[ "$FILE_PATH" == *"$pattern"* ]]; then
    echo "Blocked: $FILE_PATH は保護されています('$pattern')" >&2
    exit 2   # 2 で終わると操作を止め、この理由が Claude に伝わる
  fi
done

exit 0

# リモート(HTTP)のサーバーを追加する
claude mcp add --transport http notion https://mcp.notion.com/mcp

# 手元で動かす(stdio)サーバーを追加する。-- の後ろがサーバーの起動コマンド
claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable \
  -- npx -y airtable-mcp-server

# チームで共有する(.mcp.json に書き込まれる)
claude mcp add --transport http notion --scope project https://mcp.notion.com/mcp

# 確認・削除
claude mcp list
claude mcp get notion
claude mcp remove notion

{
  "mcpServers": {
    "notion": {
      "type": "http",
      "url": "https://mcp.notion.com/mcp"
    },
    "api-server": {
      "type": "http",
      "url": "${API_BASE_URL:-https://api.example.com}/mcp",
      "headers": {
        "Authorization": "Bearer ${MY_API_KEY}"
      }
    },
    "airtable": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "airtable-mcp-server"],
      "env": {
        "AIRTABLE_API_KEY": "${AIRTABLE_API_KEY}"
      }
    }
  }
}