I Doc Fix

---
description: docs review の指摘に対応し、ドキュメントのみを修正する。コードやテストは変更しない。
name: i-doc-fix
---

# I Doc Fix

docs review の指摘事項に対応する。このスキルでも **コード、設定、テストは変更しない**。

## いつ使うか

| タイミング | このスキルを使用 |
|-----------|-----------------|
| `i-doc-review` または `i-doc-verify` が RETRY のとき | ✅ 必須 |

**ワークフロー内の位置**: update-doc → review-doc → **fix-doc** → verify-doc

## 入力

### ハーネス経由（コンテキスト変数）

| 変数 | 型 | 説明 |
|------|-----|------|
| `issue_id` | str | 正規化済み Issue ID（GitHub 数値または local ID） |
| `issue_ref` | str | 人間可読の Issue 参照（GitHub では `#<issue_id>`、local では bare ID） |
| `step_id` | str | 現在のステップ ID |
| `previous_verdict` | str | 前ステップの verdict |

### 手動実行（スラッシュコマンド）

```
$ARGUMENTS = <issue_id>
```

### 解決ルール

コンテキスト変数 `issue_id` が存在すればそちらを使用。
なければ `$ARGUMENTS` の第1引数を `issue_id` として使用。

`issue_ref` はハーネス経由ではプロンプトに自動注入される（`prompt.py` 側で provider 別に整形）。手動実行時は `issue_id` から導出する: GitHub 数値 ID なら `#<issue_id>`、`local-*` 形式なら bare ID（`#` を付けない）。

## 前提知識の読み込み

1. [docs/dev/documentation_update_criteria.md](../../../docs/dev/documentation_update_criteria.md)
2. [docs/dev/shared_skill_rules.md](../../../docs/dev/shared_skill_rules.md)

## 実行手順

1. `previous_verdict` または Issue コメントから最新レビュー結果を取得
2. Must Fix を 1 件ずつ検討
3. docs のみ修正
4. 実装 / CLI / AGENTS.md / CLAUDE.md / 関連 docs との整合を再確認
5. 修正対象ファイルに絞って以下を実行:
   ```bash
   cd [worktree_dir] && python3 scripts/check_doc_links.py [changed-markdown-files...]
   ```
6. docs のみコミット
7. 対応内容を Issue にコメント

## Verdict 出力

```text
---VERDICT---
status: PASS
reason: |
  docs review の指摘に対応した
evidence: |
  Must Fix 項目を修正し、関連する docs と実装の整合を再確認した
suggestion: |
---END_VERDICT---
```

### status の選択基準

| status | 条件 |
|--------|------|
| PASS | 修正完了 |
| ABORT | docs 修正だけでは解決不能 |