メニュー
src/ の実装変更を README.md / README.ja.md / docs/dev/ / CLAUDE.md / AGENTS.md に同期する。コード変更後やドキュメントの陳腐化が疑われるとき、user が「/update-docs」と言ったときに発動する。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
| name | update-docs |
| description | src/ の実装変更を README.md / README.ja.md / docs/dev/ / CLAUDE.md / AGENTS.md に同期する。コード変更後やドキュメントの陳腐化が疑われるとき、user が「/update-docs」と言ったときに発動する。 |
chokkin の進化するソースコードと陳腐化しがちなドキュメントの差分を体系的に埋める スキル。5 フェーズで実施する。
実装の現状を把握する:
src/lib.rs の public API（モジュール階層 cli/config/manifest/parser/resolver/
graph/rules/reporters/fix/plugins のうち実装済みのもの）src/main.rs の CLI 挙動（引数ディスパッチ、ExitStatus → 終了コード）Cargo.toml / pyproject.toml のメタデータ（バージョン、edition、maturin bin 設定）docs/dev/spec.ja.md（§1–§21）を実装と突き合わせる:
README.md（英）と README.ja.md（日）の両方に以下が含まれるか確認・更新する:
make ターゲット）make ターゲット一覧全 Markdown 間で次を揃える:
README.md と CLAUDE.md / AGENTS.md は英語、README.ja.md と
docs/dev/ 配下（spec.ja.md 等）は日本語構造化レポートを出す:
docs/dev/spec.ja.md の設計書を 5 カテゴリ×20点で評価・改善し、ソースコードとの齟齬を双方向で検出する。設計レビューや実装着手前の品質確認、user が「/update-design」と言ったときに発動する。
タスク完了時に simplify と update-docs を順に実行し、最後に /compact のリマインドを出す。Stop hook の block reason から起動されるか、user が「タスク完了」「/wrapup」と言ったときに発動する。
プランや設計について、共通理解に達するまで user を徹底的に問い詰める。決定木の各分岐を 1 つずつ解消する。プランをストレステストしたいとき、設計をレビューさせたいとき、user が「grill me」と言ったときに発動する。
プランモード完了直前に、プランファイルの品質を update-design 同等の基準で検証・改善し、合格してから ExitPlanMode を呼ぶ統合スキル。プラン確定前、user が「/update-plan」と言ったときに発動する。