update-reference

update-reference

skills/claude-code-reference/reference/*.md against the official documentation, and if there are changes, updates the summary and the 最終確認日 .

Usage

/update-reference              # 全ファイルを対象
/update-reference skills       # skills.md のみ更新
/update-reference hooks,mcp    # 複数指定（カンマ区切り）

If the argument is omitted, all reference/ under .md are targeted.

Flow

Step 1: List the target files and source URLs

If there is an argument, only the specified reference/<name>.md is targeted; if omitted, all are retrieved with the following.

ls skills/claude-code-reference/reference/*.md

Read the  と  from the first line of each file, and create a mapping of URLs and last-checked dates.

Excluded targets: sample/ and script/ is a collection of actual commands and is maintained manually, so it is out of scope for this skill.

Step 2: Delegate to the reference-researcher Agent to check for differences

Delegate to **reference-researcher (subagent_type: reference-researcher)** to execute the following.

Example delegation prompt:

subagent_type: reference-researcher
prompt: |
  目的: 以下の URL から公式ドキュメントを取得し、現行の reference/*.md と比較して差分を報告する。
  入力:
    - 対象 URL とファイルパスのマッピング（Step 1 で取得）
    - 各 reference/*.md の現行内容
  処理:
    1. 各 URL を WebFetch で取得する
    2. 現行要約と最新ドキュメントを比較して差分を特定する
    3. 変更があった項目の差分サマリーを返す
    4. 破壊的変更・削除された API・廃止予定機能を特に強調する
  出力フォーマット:
    - ファイルごとの差分サマリー（変更なし / 軽微な変更 / 重要な変更 / 破壊的変更 の4段階）
    - 変更が検出されたファイルの具体的な変更点リスト

Step 3: Update the reference/*.md files that have changes

Based on the results of Step 2, update only the files where changes were detected.

Update contents:

Rewrite the summary/description to match the content of the latest documentation
The  at the beginning of the file is updated to the execution date (e.g., 2026-06-06）
 If the comment exists, keep it as is

Files with no changes: 最終確認日 is updated only, and the body is not changed.

Step 4: Report the change summary

Report the results in Japanese in the following format.

## update-reference 実行結果

更新対象: N ファイル
更新済み: X ファイル
変更なし: Y ファイル

### 変更があったファイル

| ファイル | 変更の種類 | 主な変更点 |
|---------|----------|----------|
| reference/hooks.md | 重要な変更 | PreToolUse の新フィールド `decision` が追加 |
| reference/mcp.md   | 軽微な変更 | URL の記載を更新 |

### ⚠️ 破壊的変更・削除された API

（該当がある場合のみ記載）

### 変更なしのファイル

reference/skills.md, reference/settings.md, ...

Verification

Confirm that the  at the beginning of each updated file is today's date
If there are breaking changes in the change summary, check the impact on related skills (create-skill, create-agent, etc.)
git diff skills/claude-code-reference/reference/ Finally confirm the changes with

Notes

sample/ and script/ are out of scope: Maintained manually because it is a collection of actual commands
Handling of breaking changes: If deprecated APIs or settings are detected, emphasize the report and guide the correction of related skills
WebFetch failures: In case of network errors or 404, skip the relevant file and record it in the log
Last-checked date format: YYYY-MM-DD(ISO 8601 date format) is used
Partial execution: When updating only specific files via argument specification, the 最終確認日 of other files is not changed