context7

name	context7
description	调用 context7 (npx ctx7) 库文档解析工具. PACE plan / design / impl stage 在需要查第三方库 API / 用法 / 最佳实践时使用. 避免凭记忆瞎写库 API.

/context7 — 库文档解析 (v9.6.2)

何时用

场景	触发
plan stage	"我想用 X 库实现 Y, 它的 API 怎么样?"
design stage	"Z 库的最佳实践是什么?"
impl stage	写代码时遇到 API 不确定 → 先查 ctx7
review stage	reviewer 不确定某用法是否 idiomatic → 让 docs_researcher 用 ctx7

关键命令

# 解析库 (得到 ctx7 ID)
npx ctx7 resolve react           # → /facebook/react
npx ctx7 resolve "next.js"       # → /vercel/next.js

# 获取文档片段 (按 topic)
npx ctx7 get-docs /facebook/react --topic "hooks useEffect"
npx ctx7 get-docs /vercel/next.js --topic "app router"

# 列出已索引的库
npx ctx7 list

# Setup (一次性, 用户初装 Athena 后跑)
npx ctx7 setup --claude          # CC 端
npx ctx7 setup --gemini          # Gemini 端 (v9.6.2 新)
# Codex 通过 MCP 接入, 配置在 ~/.codex/config.toml [mcp_servers.context7]

工作流

在 PACE 中调用

plan stage:
  主 agent 识别需要查库 X
  → Bash `npx ctx7 resolve <X>` (拿到 ID)
  → Bash `npx ctx7 get-docs <ID> --topic <T>` (拿到片段)
  → 把结果写入 `.ai_state/sprints/{current_sprint_slug}/research.md`
  → 继续 plan

在 review passN 中

reviewer 提出疑虑 "这个用法对吗?"
  → 主 agent 不直接回答
  → 调用 docs_researcher subagent (cx) 或 Task subagent_type 调研
  → docs_researcher 用 ctx7 查官方文档
  → docs_researcher 返回证据链, 主 agent 写入 `sprints/{current_sprint_slug}/reviews/passN.md`