reflect

Files (1)

• SKILL.md

SKILL.md (first lines)

# アイディアの反映

`ideas/` 配下のアイディアファイルを読み取り、適切なファイルへの反映を計画してください。

## 対象ファイルの指定

$ARGUMENTS

- 引数がある場合: 指定されたファイルのみを対象とする。
- 引数がない場合: `status: new` のアイディアファイルをすべて対象とする。

## 前提

**`${CLAUDE_PLUGIN_ROOT}/references/structure.md` を読み、作品構成を判別してから実行すること。**

反映先は作品の構成によって変わる。アウトラインが分割されている場合、また上位に構成層（`plots/` など）がある場合は、**どの層のどのファイルに反映するか**まで特定する。

## 手順

1. 対象のアイディアファイルを読み込む。
2. 作品構成を判別する（→ `references/structure.md`）。
3. アイディアの内容を分析し、反映先を分類する。
   - タイトル・概要・ログライン・作品全体の方針 → `project.md`
   - 構成・展開の変更 → アウトライン層、または上位の構成層（後述「反映先の層を決める」）
   - 調査が必要な事項 → `research/` に新規ファイル、または `/writing:research` での委譲
   - 人物・舞台設定（フィクション） → `settings/` 配下
   - `@claude` で始まる行 → Claude への指示として解釈し、内容に応じた処理を反映計画に含める
4. 反映によって生じる**波及先**を洗い出す（→ `references/structure.md`「上位層を変更したときの波及」）。
5. **反映計画をユーザーに提示し、承認を待つ。**
6. 承認後に反映を実行し、アイディアファイルの `status` を `reflected` に更新する。
7. 分割ファイルの追加・削除・改題を伴った場合は、`/writing:index` での索引同期を促す。

## 反映先の層を決める

多層構成では、**どこまで上流へ遡るか**の判断が反映の質を決める。原稿へのフィードバックであっても、
反映先が原稿とは限らない。次の観点で分類する。

| 内容 | 反映先 |
|---|---|
| 語の選び方、言い回し、リズム、描写の濃さ | 原稿層のみ |
| 場面の順序・構成、何を書くか／書かないか、演出の方針 | アウトライン層（＋必要なら原稿） |
| 人物の設定・言動の原理、世界観のルール、固有名詞 | `settings/`（＋波及する全ファイル） |
| シーン・章の目的、前後の接続、伏線、時系列 | 上位の構成層（＋下流の層） |
| 作品のテーマ、あらすじ、人物配置 | `project.md` |

判断の指針:

- **同じ指摘が他の箇所でも起きるなら、上流へ**。一箇所限りの直しなら、その場で閉じる。
- 上流へ反映したものは、下流の既存ファイルにも齟齬が出ていないか確認する。原稿を書き直すかどうかは、反映計画の中でユーザーに諮る。
- 固有名詞の変更のような**横断的な変更**は、実行前に影響を受けるファイルを列挙して示す。

## フィードバックファイル（`type: feedback`）の扱い

frontmatter に `type: feedback` と `source:` を持つファイルは、`/writing:feedback` が作成したもの。
引用行に追記されたコメントを読み取り、反映先を決める。

**`source:` の元ファイルが唯一の反映先とは限らない。** 1 つのフィードバックファイルの中に、
原稿限りの直しと、上流へ遡るべき指摘が混在するのが普通。上表に沿って**コメントごとに層を判定**し、
反映計画では層ごとに分けて提示する。

## `@claude` 行の処理

- 時間のかかる作業（リサーチなど）は researcher サブエージェントへ委譲し、完了を待たない。
- 質問・相談は反映計画の中で回答する。アイディアファイルには書き戻さない。
- `@claude` 行は処理後も削除せず、履歴として残す。

## 出力形式

```
## 反映計画

### [アイディアファイル名]

**要約**: （アイディアの要点）

**反映先**:

#### 上位の構成層
1. `plots/05-章タイトル.md` - 〔展開〕再会の場面を職場から自宅へ変更

#### アウトライン層
2. `outlines/05-章タイトル.md` - 移動の描写を削り、会話から始める旨を追記

#### 設定
3. `settings/characters/*.md` - 呼称の表記を統一（波及: `plots/` 4 件、`drafts/` 1 件）

#### 原稿層のみ
4. `drafts/05-章タイトル.md` - 冒頭一文の誇張を抑える

**波及**: 上記 1 により `plots.md` の索引行が変わるため、反映後に `/writing:index` を実行する

---

この計画で反映してよろしいですか？
```

層が 1 つしかない構成では、層による見出し分けは不要。

## 注意

- 必ずユーザーの承認を得てから反映する。文体・トーンを尊重し、既存の内容を勝手に削除・大幅変更しない。
- 反映先が不明確な場合、また上流へ遡るべきか判断がつかない場合は、ユーザーに確認する。
- 下流（原稿）の記述が上流より良いと判断した場合も、勝手に上流を書き換えない。**上流を更新する提案として**示す。

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

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