用途
claude-code-docs 是一个本地镜像的 Anthropic Claude Code 产品文档技能,用于回答 Claude Code 特有的产品与配置问题。当你需要了解 Claude Code 的行为方式,或需要安装、配置 Claude Code,或想了解某个 Claude Code 标志、hook、斜杠命令、环境变量或功能的用途时,可以使用该技能。在处理 Claude Code 产品问题前,应先阅读此技能的 references/ 目录,而不是直接进行通用网络搜索。
主要能力
该技能镜像了以下 Claude Code 文档内容:CLI、hooks、skills、plugins、MCP、subagents、AGENTS.md、斜杠命令、output styles、sandboxing、permissions、Agent SDK(TypeScript 与 Python)、Claude Desktop、Slack、Chrome、Web、监控与用量、Claude Code changelog,以及每周的 "What's New" 摘要。
本地文档由上游 CI 每 3 小时刷新一次;若上游内容无法获取,刷新会失败而非提交冻结内容。清洗后的 Markdown 存放在 references/ 中,自动生成的主题列表位于 references/INDEX.md,逐文件清单(含上游 URL)位于 references/docs_manifest.json。
使用方式
工作流程如下:
- 若用户提供了主题,将其规范化为 slug:转为小写、去掉开头的
/docs/en/、去掉两侧斜杠,嵌套段落用__连接(例如agent sdk hooks->agent-sdk__hooks,whats new 2026 w19->whats-new__2026-w19)。 - 若
references/<slug>.md存在,直接读取该文件。不要先 grep 整个 references/ 目录——索引加定向读取更快且占用上下文更少。 - 若无精确匹配,读取 references/INDEX.md 并选择最接近的主题。若仍不明确,列出候选项并询问。
- 若用户未提供主题,读取 references/INDEX.md 并呈现可用主题。
回答格式:先基于所读文件给出对用户问题的直接回答;当文档中出现逐字内容时,引用简短片段(命令、配置键);结尾使用文件 frontmatter 或 references/docs_manifest.json 中的 original_url 给出 Source: <upstream URL>。
调用示例:$claude-code-docs hooks 读取 references/hooks.md;$claude-code-docs mcp 读取 references/mcp.md;$claude-code-docs agent sdk hooks 读取 references/agent-sdk__hooks.md;$claude-code-docs cli reference 读取 references/cli-reference.md;$claude-code-docs changelog 读取 references/changelog.md;$claude-code-docs(无参数)读取 references/INDEX.md。
适用场景
适用于 Claude Code 特定的产品与配置问题,包括 CLI 行为、设置、斜杠命令、hooks、skills、plugins、MCP、subagents、AGENTS.md、output styles、sandboxing、permissions、环境变量、监控与用量、Claude Desktop、Slack、Chrome、Web、Agent SDK,以及发布说明。
限制
若问题涉及 OpenAI Codex、Cursor、Claude.ai 消费者功能、通用 Anthropic API 或其他非 Claude Code 产品,此技能不适用。
若本地内容看起来过时、与用户说法矛盾或为空,可:建议用户运行 npx skills update claude-code-docs;检查 references/docs_manifest.json 中该文件的条目,status 为 stale 表示上次运行时无法访问上游;通过 references/docs_manifest.json 中的 original_url 核对规范 URL,并将其作为后续来源;若某一页面 MDX 清洗失败,未修改的源文件保存在 references/_raw/<slug>.md,可将其作为回退读取。