メニュー
Use when the user wants to review documentation changes, audit entry files or standards docs, check changelog quality, inspect concept drift in docs, or says "review docs" / "review documentation". Do not use for source-code implementation review.
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
Use when the user wants to classify dirty changes, create serial commits, split work into one or more PRs, or publish the current flow without merging it.
Use when the user wants to resume work on an existing branch or flow. Reads context, executes the next step, reviews the result, and reports to the user before proceeding. Equivalent to superpowers:executing-plans, using vibe3 as the execution backend.
Use when you need an overview of the Vibe Center project, its implementations (vibe2 shell and vibe3 python), the available commands, and the standard development workflow. This is the meta-skill that orients any agent to the project.
Use when starting or switching to a new human-collaboration task. Confirm the target issue, bootstrap the corresponding dev/issue flow scene, and hand off to the chosen implementation workflow. Do not use for resuming an existing branch; use vibe-continue instead.
Use after `scripts/install.sh` to guide users through machine-level setup, dependency checks, Claude/Codex toolchain readiness, and core feature introduction. Interactive onboarding for new users. Delegates diagnostics to `vibe doctor` and `vibe keys check`. Do not use for project-level configuration (use vibe-project-check instead).
Use after `vibe init` to verify target-project configuration completeness, tool availability, and environment readiness. Interactively prompts user to fill missing items. Orchestrates existing commands without adding Python code. Supports cross-project vibe3 readiness verification (Phase 5-8). Do not use for system-level installation issues (use vibe-onboard instead).
| name | vibe-review-docs |
| description | Use when the user wants to review documentation changes, audit entry files or standards docs, check changelog quality, inspect concept drift in docs, or says "review docs" / "review documentation". Do not use for source-code implementation review. |
本 Skill 只负责：
语义边界：
vibe-review-docs 负责 docs、standards、task/readme、changelog 与入口文件的概念和表达审查vibe-review-code启动时创建 task 跟踪进度（使用 TaskCreate tool）：
TaskCreate(
title: "Doc Review",
description: "文档审查：检查概念对齐和引用正确性"
)
PR_BASE=$(gh pr view <number> --json baseRefName -q .baseRefName)
PR_BRANCH=$(gh pr view <number> --json headRefName -q .headRefName)
git fetch origin "$PR_BASE" "$PR_BRANCH" --quiet
git diff --name-only "origin/$PR_BASE...origin/$PR_BRANCH" -- '*.md'
git diff "origin/$PR_BASE...origin/$PR_BRANCH" -- '*.md'
git diff main...HEAD --name-only | grep '\.md$'
git diff main...HEAD -- '*.md'
关键区分：本地开发 vs 远程审查
uv run python src/vibe3/cli.py handoff status $(git branch --show-current)
PR_BRANCH=$(gh pr view <number> --json headRefName -q .headRefName)
gh pr view <number> --comments
检查以下维度：
| 维度 | 检查项 |
|---|---|
| Completeness | PRD 是否遵循标准格式（Background, Goals, Acceptance Criteria） |
| Language & Clarity | 是否简洁，去除泛化 AI 语言 |
| Accuracy | CLI 命令和架构描述是否与当前 V3 状态一致 |
| References | 引用的文件是否存在，路径是否正确 |
| Deprecation | 废弃文件是否有明确的 deprecation notice |
# 检查引用文件是否存在
ls -la docs/standards/v3/command-standard.md
# 检查废弃文件状态
head -10 docs/standards/vibe3-state-sync-standard.md
运行相关检查：
# CLI 命令验证
uv run python src/vibe3/cli.py --help
# 特定命令验证
uv run python src/vibe3/cli.py <command> --help
## Findings
- [Blocking] path:line
- Issue:
- Failure mode:
- Minimal fix:
## Verification
- Passed:
- Not run:
## Verdict
PASS | MAJOR | BLOCK
| 级别 | 定义 |
|---|---|
| Blocking | 错误概念、指向不存在文件的引用、缺失 deprecation notice |
| Major | 应在合并前修复；描述与代码不一致、缺失关键文档 |
| Minor | 有限影响的问题；格式、措辞优化 |
| Nit | 小的清晰度问题 |
完成审查后，更新 handoff：
uv run python src/vibe3/cli.py handoff append "vibe-review-docs: Documentation review completed" --actor vibe-review-docs --kind milestone
| 文件 | 职责 |
|---|---|
skills/vibe-review-docs/SKILL.md | 本文件：文档审查流程 |
skills/vibe-review-code/SKILL.md | 代码审查流程 |
docs/standards/quality-control-standard.md | QC 标准 |
/vibe-review-docs
/vibe-review-docs 637
或
用 vibe-review-docs 审查 PR #637