doc-reviewlisted
Install: claude install-skill Forest-Project-Lab/doctrine
# doc-review
## 役割
文章規範と位置づけを見直す。用語チェッカーを併走させ、辞書外のカルク(訳語臭)を逆翻訳テルで判定する。満たす要求は §2 の `R6`・`R10`(要求番号は §2 の登録簿で定める)。
**著述・編集のたびに走らせる**。起動口は三つある。(1) doc-author の最後の手順がこのスキルを回す(手順 11)。(2) doc-author を介さない手編集には、PostToolUse の `review-nudge.py` がこのスキルを促す(§4.2。Level 3 以上)。(3) 定例は `gov-heartbeat.py` が周期超過を報せて促す。記載されれば動く、を既定にする。定例は、それでも残る `canonical_for` 未付与・辞書外の訳語臭・意味的重複の点検に充てる。
**指摘は定義の在処へ書き戻す**。一覧外のカルクは、導入先の用語辞書の運用正本(`_system/glossary.md` のカルク表)へ一行足す。用語チェッカーが読むのはこの運用正本であり、spec §1 は初期シードである。新しい承認語は ADR と用語辞書の更新をもって加える。型コードは登録簿(§3.2)、要求タグ(`[R番号]`)は §2 で既に定義済みとして扱い、辞書に二重定義しない。これにより、同じ指摘が次から機械的���閉じる。
## 委ねる先(決定論は scripts へ)
- `${CLAUDE_PLUGIN_ROOT}/scripts/term-check.py`(リンタの一機能)— 禁止同義語・禁止表現(カルク辞書)・未定義語を機械的に照合する。このスキルはその傍らで走る(用語チェッカーを併走)。
- 用語辞書の正本(§1)— 語彙を二重定義しない。強制する(`R6`)。
- `${CLAUDE_PLUGIN_ROOT}/scripts/term-extract.py` の候補 — 新しい承認語を提案するときの助言に使う。採否は人間。
## 手順
1. 対象文書に用語チェッカーをかけ、機械的な指摘を集める(禁止同義語・一覧のカルク・未定義語)。
2. 文章の規則を当てる(§1)。一文一義。サ変名詞+「を行う」を動詞にする。「することができる」を「でき��」にする。専門語・略語を初出で定義する。抽象語を具体語・数値・固有名に置き換える。同じ概念は同じ語で書く。
3. カルクは逆翻訳テルで判定する(§1)。怪しい箇所を英語に戻し、英語の慣用句・固定表現にそのまま戻るなら、それはカルクである。��すときは英語を捨て、日本語で選び直す。擬陽性を避ける。定着した借用語(`データ`・`リスク`)と普通の否定文はカルクではない。
4. 位置づけを点検する。型は正しいか。置き場所は正しいか。`llm_context` は正しいか。正本か投影か。よそが正本である事実を二重に書いていないか。
5. 定例でだけ閉じる点検(運用契約、§7)。`canonical_for` 未付与・辞書外の訳語臭・意味的重複。周期の実体は `references/cadence-review.md` に定める(`_system/.governance-state` の実施記録と `gov-heartbeat.py` の督促で回す)。手動の依頼だけに頼らない。
6. 本当に新しい承認語が要るなら、`term-extract.py` の候補を証跡にして提案する。ただし `ADR` と用語辞書の更新を必須にする(§1)。自分で