doc-reviewlisted

# Document Review Skill ## Trigger - Keywords: review doc, document review, tech spec review, review-spec, doc-refactor, streamline doc ## When NOT to Use - Code review (use `codex-code-review`) - Test coverage review (use `test-review`) - Just want to read a document (use Read directly) ## Commands | Command | Description | Use Case | | ------------------- | ---------------------- | ----------------- | | `/codex-review-doc` | Codex reviews .md docs | Document changes | | `/review-spec` | Review tech spec | Spec confirmation | | `/doc-refactor` | Streamline documents | Doc too long | | `/update-docs` | Research & update docs | After code change | ## Workflow: `/codex-review-doc` ``` Determine target → Read content → Codex review (5 dimensions) → Rating table + Gate → Loop if Needs revision ``` ### Step 1: Determine Target File | Condition | Action | |-----------|--------| | Path specified | Use that path directly | | No path | Auto-detect: git modified `.md` → staged `.md` → new `.md` | | Multiple files | List and ask user which to review | ### Step 2: Read File Content Read target file, save as `FILE_CONTENT`. ### Step 3: Codex Review **First review**: `mcp__codex__codex` with doc review prompt. See `references/codex-prompt-doc.md`. Config: `sandbox: 'read-only'`, `approval-policy: 'never'` **Save the returned `threadId`.** **Loop review**: `mcp__codex__codex-reply` with re-review template. See `ref