tsaol/awesome-claude/product-review

/product-review <project_path> [options]

/product-review .
/product-review ~/codes/my-project
/product-review . --quick
/product-review . --focus=ux --lang=en
/product-review ~/codes/my-project --quick --focus=dx

.product-review/
├── raw/snapshot.md                   # Phase 0: project snapshot
├── analysis/
│   ├── discovery.md                  # Agent 1 output
│   ├── goal-alignment.md             # Agent 2 output
│   ├── ux-dx-audit.md                # Agent 3 output
│   └── competitive-analysis.md       # Agent 4 output (Full mode only)
├── output/
│   └── pm-review.md                  # Final review report
└── process/
    └── pipeline.log                  # Execution log

Phase 0: Project Snapshot (bash, no LLM)
    ↓ raw/snapshot.md
Agent 1: pr-discovery (Product Discovery)
    ↓ analysis/discovery.md
Agent 2: pr-goal-alignment  ←──┐ Parallel
Agent 3: pr-ux-dx-audit     ←──┘
    ↓ analysis/goal-alignment.md + analysis/ux-dx-audit.md
Agent 4: pr-competitive-analysis
    ↓ analysis/competitive-analysis.md
Agent 5: pr-roadmap-planner (Synthesize all)
    ↓ output/pm-review.md

Phase 0 → Agent 1 → Agent 2 + Agent 3 (parallel) → Agent 5

PROJECT_PATH="<user_provided_path>"
cd "$PROJECT_PATH"
mkdir -p .product-review/{raw,analysis,output,process}

# 1. README content
cat README.md 2>/dev/null || echo "No README.md found"
 
# 2. Directory structure (2 levels deep)
find . -maxdepth 2 -not -path '*/\.*' -not -path '*/node_modules/*' -not -path '*/vendor/*' -not -path '*/__pycache__/*' -not -path '*/dist/*' -not -path '*/build/*' | head -100
 
# 3. Config files
for f in package.json pyproject.toml Cargo.toml go.mod composer.json Gemfile pom.xml build.gradle; do
  [ -f "$f" ] && echo "=== $f ===" && cat "$f"
done
 
# 4. Git log (last 20 commits)
git log --oneline -20 2>/dev/null || echo "Not a git repo"
 
# 5. GitHub stats (if remote exists)
REMOTE=$(git remote get-url origin 2>/dev/null)
if [ -n "$REMOTE" ]; then
  REPO=$(echo "$REMOTE" | sed 's/.*github.com[:/]\(.*\)\.git/\1/' | sed 's/.*github.com[:/]\(.*\)/\1/')
  gh api "repos/$REPO" --jq '{stars: .stargazers_count, forks: .forks_count, open_issues: .open_issues_count, language: .language, license: .license.spdx_id, created: .created_at, updated: .pushed_at}' 2>/dev/null
  gh api "repos/$REPO/pulls?state=open&per_page=1" --jq 'length' 2>/dev/null
fi
 
# 6. File type statistics
find . -type f -not -path '*/\.*' -not -path '*/node_modules/*' -not -path '*/vendor/*' | sed 's/.*\.//' | sort | uniq -c | sort -rn | head -20

# Project Snapshot: {project_name}
 
> Generated: {timestamp}
 
## README
{readme_content}
 
## Directory Structure
{tree_output}
 
## Config Files
{config_content}
 
## Git History (Last 20 Commits)
{git_log}
 
## GitHub Stats
{github_stats}
 
## File Type Statistics
{file_stats}

[HH:MM] phase-0    | ✓ snapshot collected | → raw/snapshot.md

[HH:MM] pr-discovery | ▶ started | raw/snapshot.md → analysis/discovery.md
[HH:MM] pr-discovery | ✓ done    | analysis/discovery.md

[HH:MM] pr-goal-alignment | ▶ started | snapshot.md + discovery.md → goal-alignment.md
[HH:MM] pr-ux-dx-audit    | ▶ started | snapshot.md + discovery.md → ux-dx-audit.md
[HH:MM] pr-goal-alignment | ✓ done    | analysis/goal-alignment.md
[HH:MM] pr-ux-dx-audit    | ✓ done    | analysis/ux-dx-audit.md

[HH:MM] pr-competitive-analysis | ▶ started | snapshot.md + discovery.md → competitive-analysis.md
[HH:MM] pr-competitive-analysis | ✓ done    | analysis/competitive-analysis.md

[HH:MM] pr-roadmap-planner | ▶ started | analysis/*.md → output/pm-review.md
[HH:MM] pr-roadmap-planner | ✓ done    | output/pm-review.md

✅ Product review complete!
 
📄 Report: .product-review/output/pm-review.md
📊 Analysis files: .product-review/analysis/
📋 Log: .product-review/process/pipeline.log

> **Review Focus:** {focus_area}

> **Output Language:** {zh|en}

[HH:MM] agent-name | status | description

# 产品评审报告: {project_name}
 
> 评审时间: {timestamp}
> 评审模式: Full / Quick
> 聚焦领域: {focus_area or "全面评审"}
 
## 执行摘要
> [1 段话核心结论]
 
## 评分卡
| 维度 | 得分 | 说明 |
|------|------|------|
| 产品力 | /10 | |
| 用户体验 | /10 | |
| 目标对齐 | /10 | |
| 竞争力 | /10 | |
| **综合** | **/10** | |
 
## 产品发现
[来自 Agent 1: pr-discovery]
 
## 目标对齐分析
[来自 Agent 2: pr-goal-alignment]
 
## 体验审计
[来自 Agent 3: pr-ux-dx-audit]
 
## 竞品分析
[来自 Agent 4: pr-competitive-analysis，Quick 模式标注"已跳过"]
 
## 改进路线图
### 🔴 立即修复 (P0, 1-2 周)
### 🟡 短期改进 (P1, 1-3 个月)
### 🟢 长期演进 (P2, 3-6 个月)
 
## 里程碑
| 阶段 | 目标 | 关键交付物 | 预计周期 |
|------|------|-----------|---------|
| M1 | | | 2 周 |
| M2 | | | 1-3 月 |
| M3 | | | 3-6 月 |
 
## 关键指标
-**北极星指标**: [建议的核心指标]
-**辅助指标**: [2-3 个辅助指标]