Menü
docs-only の変更をレビューし、事実整合性・実装整合性・運用整合性の観点から判定する。
Mit Codex oder Claude installieren Kopieren Sie diesen Prompt, fügen Sie ihn in Codex, Claude oder einen anderen Assistant ein und lassen Sie die Skill-Seite prüfen und installieren.
Basierend auf der SOC-Berufsklassifikation
| description | docs-only の変更をレビューし、事実整合性・実装整合性・運用整合性の観点から判定する。 |
| name | i-doc-review |
重要: このスキルは更新を行ったセッションとは別のセッションで実行することを推奨します。
CRITICAL: このレビューの目的は文章を整えることではない。現行実装との差異、古い手順、誤誘導となる記述を発見すること。
docs-only の変更をレビューする。新規指摘を行ってよい。
| タイミング | このスキルを使用 |
|---|---|
i-doc-update 完了後 | ✅ 必須 |
ワークフロー内の位置: doc-update → doc-review → (doc-fix → doc-verify) → final-check → pr
| 変数 | 型 | 説明 |
|---|---|---|
issue_id | str | 正規化済み Issue ID（GitHub 数値または local ID） |
issue_ref | str | 人間可読の Issue 参照（GitHub では #<issue_id>、local では bare ID） |
step_id | str | 現在のステップ ID |
cycle_count | int | 現在のイテレーション |
max_iterations | int | サイクルの上限回数 |
$ARGUMENTS = <issue_id>
コンテキスト変数 issue_id が存在すればそちらを使用。
なければ $ARGUMENTS の第1引数を issue_id として使用。
issue_ref はハーネス経由ではプロンプトに自動注入される（harness 側で provider 別に整形される）。手動実行時は issue_id から導出する: GitHub 数値 ID なら #<issue_id>、local-* 形式なら bare ID（# を付けない）。
ls [worktree_dir]/draft/design/issue-[issue_id]-*.md >/dev/null 2>&1 \
&& cat [worktree_dir]/draft/design/issue-[issue_id]-*.md \
|| echo "(設計書なし: docs-only では任意)"
cd [worktree_dir] && git diff main...HEAD
docs/dev/documentation_update_criteria.md の 3 観点（事実整合性・実装整合性・運用整合性）で厳格にレビューする。
AGENTS.md / CLAUDE.md の運用方針と矛盾しないか変更された Markdown ファイルに絞って以下を実行する。
cd [worktree_dir] && python3 scripts/check_doc_links.py [changed-markdown-files...]
Must Fix / Should Fix を整理して Issue にコメントする。
---VERDICT---
status: RETRY
reason: |
docs の整合性レビューで修正事項が見つかった
evidence: |
実装との差異、運用方針との不一致、または読者を誤誘導する記述を確認した
suggestion: |
Issue コメントの指摘に従って `i-doc-fix` で修正すること
---END_VERDICT---
| status | 条件 |
|---|---|
| PASS | 修正不要で i-doc-final-check へ進める |
| RETRY | docs 修正で解決可能 |
| ABORT | docs-only の範囲を超える重大な問題 |
設計書（draft/design/）に基づき、TDD（テスト駆動開発）アプローチを用いて機能を実装する。
実装完了後の成果物に対し、設計整合性とコード品質の観点から厳格なレビューを実施する
Issue 作成後・workflow 起動前に人間が明示起動する要件 interview。one-way door を含みうる重要な Issue で、未決の decision tree を 1 問ずつ推奨案付きで確認し、決定事項と provenance を Issue に固定するときだけ使用する。軽微な Issue や workflow 実行中には自動起動しない。
Issue要件に基づき、draft/design/に設計書を作成する。worktree内での作業が前提。
Create a validated sequential Issue series plan from an explicitly ordered GitHub Issue list. Use when a maintainer wants to generate or update an ID-named YAML file under .kaji/series, select standard workflows from Issue type metadata and workflow descriptions, or preview a series without starting it.
dev workflow 向けの最終チェック。PR 前に品質ゲート、docs 整合、設計書昇格、Issue 更新をまとめて確認する。