pm-selfcheck

Preamble

bash "$(dirname "${BASH_SOURCE[0]}")/../../check-update.sh" 2>/dev/null || true
# selfcheck 检查项 1/2/3/5 均需 PKG_ROOT 定位技能包根目录
SKILL_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")" 2>/dev/null && pwd)" || true
PKG_ROOT="$(cd "$SKILL_ROOT" && while [ "$PWD" != "/" ]; do [ -f VERSION ] && { pwd; break; }; cd ..; done)"
echo "🔍 pm-selfcheck v1.0"
echo "正在扫描 super-pm 健康状态..."
echo ""

---

检查项

1. 元数据完整性

扫描所有 SKILL.md，检查：

• name: 字段是否缺失
• description: 字段是否缺失
• allowed-tools: 字段是否缺失
• VERSION 文件是否存在且格式正确

2. 体积检查

评级	范围	状态
⚠️ 超大	> 600行	需要拆分
✅ 标准	200-600行	健康
⚠️ 薄弱	< 100行	需要补充

3. 文档路径一致性

扫描所有 docs/ 引用，检查：

• 中文路径：docs/01-需求调研/、docs/02-方案设计/ 等
• 英文路径：docs/01-demand-insight/ 等
• 是否存在引用异常（如根目录 docs/xxx.md）

4. 搜索依赖检测

检查搜索增强工具是否可用：

echo "=== 4. 搜索依赖检测 ==="

# AnySearch skill 检测
ANYSEARCH_FOUND=false
for candidate in \
  "$HOME/.claude/skills/anysearch/scripts/anysearch_cli.py" \
  "$HOME/.opencode/skills/anysearch/scripts/anysearch_cli.py" \
  "$HOME/.openclaw/skills/anysearch/scripts/anysearch_cli.py" \
  "$HOME/.cursor/skills/anysearch/scripts/anysearch_cli.py" \
  "$HOME/.anysearch/scripts/anysearch_cli.py"; do
  if [ -f "$candidate" ]; then
    ANYSEARCH_FOUND=true
    echo "✅ AnySearch: 已安装 ($candidate)"
    break
  fi
done
if [ "$ANYSEARCH_FOUND" = false ]; then
  echo "❌ AnySearch: 未安装（搜索将降级到 Exa MCP / WebSearch）"
  echo "   安装: git clone https://github.com/konglong87/anysearch.git ~/.claude/skills/anysearch"
fi

# Exa MCP 检测（检查 settings.json 中是否配置了 mcpServers.exa）
EXA_FOUND=false
for settings_file in \
  ".claude/settings.json" \
  "$HOME/.claude/settings.json"; do
  if [ -f "$settings_file" ] && grep -q '"exa"' "$settings_file" 2>/dev/null; then
    EXA_FOUND=true
    echo "✅ Exa MCP: 已配置 ($settings_file)"
    break
  fi
done
if [ "$EXA_FOUND" = false ]; then
  echo "❌ Exa MCP: 未配置（搜索将降级到 WebSearch）"
  echo "   配置: 在 .claude/settings.json 中添加 mcpServers.exa"
fi

# WebSearch 始终可用
echo "✅ WebSearch: 内置兜底，始终可用"