everything-ai-coding: Instructions file for Claude Code

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

项目概述

Everything AI Coding — 聚合 4000+ 精选 MCP / Skills / Rules / Prompts / Plugins 的开发资源索引。数据从 11+ 个上游源自动同步，支持 Claude Code、Opencode、Costrict、VSCode Costrict 四个平台。

提交规范

原子化提交，格式：[type] 中文描述

类型：[feat] [fix] [refactor] [docs] [ci] [chore]

规则：

• 每个提交只做一件事
• 描述用中文，简洁直白
• 不写 Co-Authored-By（除非协作场景）

测试

# 运行所有测试
python -m pytest tests/ -v

# 运行特定测试文件
python -m pytest tests/test_merge_index.py -v
python -m pytest tests/test_eval_bridge.py -v
python -m pytest tests/test_scoring_governor.py -v

开发命令

同步数据

# 同步各类型资源（需要 GITHUB_TOKEN 避免 rate limit）
GITHUB_TOKEN=xxx python scripts/sync_mcp.py
GITHUB_TOKEN=xxx python scripts/sync_mcp_registry.py # 接入 registry.modelcontextprotocol.io（active+isLatest，无需 token）
GITHUB_TOKEN=xxx python scripts/sync_rules.py
GITHUB_TOKEN=xxx python scripts/sync_windsurfrules.py # 接入 awesome-windsurfrules ×2 仓库（cross-repo dedup）
GITHUB_TOKEN=xxx python scripts/sync_skills.py    # Tier 2 评估需要 LLM_* 环境变量
GITHUB_TOKEN=xxx python scripts/sync_skills_sh.py # 接入 skills.sh（mastra JSON 主路径，install_count ≥ 1000）
GITHUB_TOKEN=xxx python scripts/sync_prompts.py

# 增量抓取 mcp.so（避免全量重抓）
python scripts/crawl_mcp_so.py --mode incremental

# 合并索引（包含去重、富化、评分、生命周期管理）
python scripts/merge_index.py

# 更新 README 中的资源统计数字（中英文 README 会同时更新）
python scripts/update_readme.py

评估引擎

# 安装本地评估包（首次 / 更新后）
pip install -e ai-resource-eval

# 用 CLI 直接跑全量评估（独立于 merge 管线）
ai-resource-eval run \
  --task all \
  --input catalog/index.json \
  --output .eval_cache/results.json \
  --judge openai_compat \
  --cache-dir .eval_cache \
  --concurrency 5 \
  --incremental \
  --no-interactive \
  --on-fail queue

# 环境变量：LLM_API_KEY / LLM_BASE_URL / LLM_MODEL（或 JUDGE_ 前缀）

本地验证

# 验证 JSON schema
python -c "import json; json.load(open('catalog/index.json'))"

# 检查索引完整性
python scripts/merge_index.py  # 会输出去重统计和完整性警告