feat(docs): 添加技能/团队命令对比表和代码审查报告

Author: catlog22

ccw/src/tools/read-many-files.ts

@@ -96,7 +96,30 @@ export async function handler(params: Record<string, unknown>): Promise<ToolResu
   const cwd = getProjectRoot();
 
   // Normalize paths to array
-  const inputPaths = Array.isArray(paths) ? paths : [paths];
+  // Handle case where paths might be passed as JSON-encoded string (MCP client bug)
+  let inputPaths: string[];
+  if (Array.isArray(paths)) {
+    inputPaths = paths;
+  } else if (typeof paths === 'string') {
+    // Check if it's a JSON-encoded array
+    const trimmed = paths.trim();
+    if (trimmed.startsWith('[') && trimmed.endsWith(']')) {
+      try {
+        const parsed = JSON.parse(trimmed);
+        if (Array.isArray(parsed)) {
+          inputPaths = parsed;
+        } else {
+          inputPaths = [paths];
+        }
+      } catch {
+        inputPaths = [paths];
+      }
+    } else {
+      inputPaths = [paths];
+    }
+  } else {
+    inputPaths = [String(paths)];
+  }
 
   // Collect all files to read
   const allFiles: string[] = [];

docs/.review/skill-team-comparison-review.md

@@ -0,0 +1,161 @@
+# Code Review Report
+
+**Target**: D:\Claude_dms3\docs\skill-team-comparison.md
+**Date**: 2026-03-01
+**Dimensions**: Correctness, Readability (Maintainability)
+
+---
+
+## Summary
+
+| Dimension | Critical | High | Medium | Low | Info |
+|-----------|----------|------|--------|-----|------|
+| **Correctness** | 0 | 1 | 2 | 1 | 0 |
+| **Readability** | 0 | 0 | 1 | 2 | 1 |
+
+**Quality Gate**: ⚠️ WARN (1 High issue found)
+
+---
+
+## Findings
+
+### Correctness Issues
+
+#### CORR-001 [High] team-issue 角色任务前缀描述不准确
+
+**Location**: 行 71, 288
+
+**Issue**: 文档中 team-issue 的角色描述为 `explorer, planner, reviewer, integrator, implementer`，但未说明对应的任务前缀 (EXPLORE-*, SOLVE-*, AUDIT-*, MARSHAL-*, BUILD-*)。
+
+**Current**:
+```
+| **team-issue** | explorer, planner, reviewer, integrator, implementer | general-purpose agents | Issue处理流程 | 探索→规划→审查→集成→实现 |
+```
+
+**Expected**: 添加任务前缀说明以提高准确性
+
+**Fix**:
+```markdown
+| **team-issue** | explorer (EXPLORE-*), planner (SOLVE-*), reviewer (AUDIT-*), integrator (MARSHAL-*), implementer (BUILD-*) | general-purpose agents | Issue处理流程 | 探索→规划→审查→集成→实现 |
+```
+
+---
+
+#### CORR-002 [Medium] team-executor-v2 前置条件描述不完整
+
+**Location**: 行 70, 84
+
+**Issue**: 文档说 team-executor-v2 需要"现有team-coordinate会话"，但实际它可以恢复任何 team-* 会话。
+
+**Current**:
+```
+| **team-executor-v2** | (动态角色) | team-worker agents | 恢复执行 | 纯执行，无分析，需现有会话 |
+```
+
+**Expected**: 更准确的描述
+
+**Fix**:
+```markdown
+| **team-executor-v2** | (继承会话角色) | team-worker agents | 恢复执行 | 纯执行，无分析，需现有team会话 |
+```
+
+---
+
+#### CORR-003 [Medium] 遗漏 workflow-wave-plan 命令
+
+**Location**: 规划类命令对比表
+
+**Issue**: 系统中存在 `workflow-wave-plan` 命令，但未在对比表中列出。
+
+**Recommendation**: 在规划类命令中添加此命令
+
+---
+
+#### CORR-004 [Low] team-planex 角色描述
+
+**Location**: 行 34, 294
+
+**Issue**: team-planex 角色描述为 `planner, executor`，但实际实现可能有更多细节。
+
+**Recommendation**: 验证并补充详细角色信息
+
+---
+
+### Readability Issues
+
+#### READ-001 [Medium] 决策流程图格式
+
+**Location**: 行 226-249
+
+**Issue**: ASCII 决策流程图在某些 Markdown 渲染器中可能显示不正确。
+
+**Recommendation**: 考虑使用 Mermaid 图表或添加渲染说明
+
+---
+
+#### READ-002 [Low] 表格宽度
+
+**Location**: 多处表格
+
+**Issue**: 部分表格列内容较长，在窄屏设备上可能需要水平滚动。
+
+**Recommendation**: 可接受，但可考虑在未来版本中优化
+
+---
+
+#### READ-003 [Low] 命令调用方式一致性
+
+**Location**: 命令速查表部分
+
+**Issue**: 部分命令同时列出了 `Skill()` 和 `/command` 两种调用方式，部分只有一种。
+
+**Recommendation**: 保持一致的格式
+
+---
+
+#### READ-004 [Info] 文档版本管理建议
+
+**Location**: 文档末尾
+
+**Suggestion**: 建议添加文档变更历史或链接到 CHANGELOG
+
+---
+
+## Recommended Actions
+
+### Must Fix (Before Final)
+
+1. **CORR-001**: 修复 team-issue 角色前缀描述
+
+### Should Fix (Next Iteration)
+
+2. **CORR-002**: 更新 team-executor-v2 描述
+3. **CORR-003**: 添加遗漏的命令
+
+### Nice to Have
+
+4. **READ-001**: 考虑图表格式优化
+5. **READ-004**: 添加版本管理
+
+---
+
+## Fixed Issues
+
+以下问题已在审查后立即修复：
+
+### FIX-001: team-issue 角色前缀
+
+**Before**:
+```
+| **team-issue** | explorer, planner, reviewer, integrator, implementer |
+```
+
+**After**:
+```
+| **team-issue** | explorer (EXPLORE), planner (SOLVE), reviewer (AUDIT), integrator (MARSHAL), implementer (BUILD) |
+```
+
+---
+
+*Review completed: 2026-03-01*
+*Reviewer: Claude Code (team-coordinate-v2)*