index

Files (1)

• SKILL.md

SKILL.md (first lines)

# 索引の同期

分割されたアウトラインの索引ファイルを、実ファイルの状態に合わせて同期します。

## 対象の指定

$ARGUMENTS

- 引数がある場合: 指定された層（`plots`、`outlines` など）または索引ファイルを対象とする。
- 引数がない場合: 分割されている層をすべて検出し、対象を提示する。複数ある場合はどれを同期するか確認する。

## 前提

**`${CLAUDE_PLUGIN_ROOT}/references/structure.md` を読み、作品構成の判別手順と索引の扱いを把握してから実行すること。**

分割ディレクトリはあるが索引ファイルがない場合、索引は自動では作らない。「索引を作成しますか」と確認する。

## 手順

1. 対象の分割ディレクトリのファイルを、連番順に列挙する。
2. 既存の索引ファイルがあれば読み込み、**書式を推定する**。
   - 1 行に含まれる要素（番号・タイトル・リンク・分割ファイルから抽出した項目）
   - 見出しによるグルーピング（幕・部・章など）
   - 冒頭の説明文・凡例
3. 各分割ファイルから、書式が要求する項目を読み取る。
4. 索引の各行を生成し、**既存の索引との差分**を作る。
5. あわせて次を点検する。
   - 連番の欠番・重複
   - 索引にあって実ファイルがない行／実ファイルがあって索引にない行
   - リンク切れ（リンク先パスが存在しない）
   - 各分割ファイル末尾の前後ナビゲーションリンクの誤り
   - 他の層との対応（`plots/03` に対応する `outlines/03` がない、など。欠落は情報として報告するだけで、作成はしない）
6. **差分と点検結果をユーザーに提示し、承認を待つ。**
7. 承認後に索引を更新し、ナビゲーションリンクを張り替える。

## 出力形式

```
## 索引の同期: plots.md ← plots/

### 差分

| 行 | 変更 |
|---|---|
| 07. 章タイトル | 〔目的〕欄の変更を反映 |
| 13. （新規） | `plots/13-章タイトル.md` を追加 |
| 09. 章タイトル | 実ファイルなし（削除された？） |

### 点検結果

- 欠番: なし
- リンク切れ: `plots/09-章タイトル.md`（索引にあるが実ファイルなし）
- ナビリンク: `plots/06-章タイトル.md` の「次へ」が 08 を指している（正しくは 07）
- 他層との対応: `plots/` 13 件に対し `outlines/` は 4 件（9 件が未着手）

---

この内容で同期してよろしいですか？
```

## 注意

- **索引の書式を勝手に変えない。** 既存の書式を推定して踏襲する。凡例や幕の見出しなど、手で書かれた要素は保持する。
- 抽出項目が空・欠落している分割ファイルは、行を捏造せず「要確認」として報告する。
- 実ファイルのない索引行は、**自動では削除しない**。削除か復元かをユーザーに確認する。
- ナビゲーションリンクの書式も既存を踏襲する（区切り文字・矢印・「目次」の表記など）。
- 索引はあくまで分割ファイルから生成されるもの。索引側の記述を分割ファイルへ書き戻さない。

From KazukiYunoue/claude-code-outline-driven-writing, MIT.

More from KazukiYunoue/claude-code-outline-driven-writing