claude-code-mastery

Claude Code 精通指南

Claude Code CLI 专家技能——涵盖 CLAUDE.md 优化、技能编写、子 Agent 创建、钩子自动化和上下文工程。

关键词： claude-code、claude-cli、CLAUDE.md、技能编写、子 Agent、钩子、上下文窗口、令牌预算、MCP 服务、工作树、权限模式、提示词工程、上下文工程、斜杠命令

核心能力

• CLAUDE.md 优化——审查、重构、压缩配置文件并对其分层，以提高令牌使用效率。
• 技能编写——搭建并编写易于发现的技能包，采用正确的布局和 frontmatter。
• 子 Agent 创建——编写 .claude/agents/<name>.md 文件，其中包含 tools 允许列表和 Markdown 正文格式的系统提示词。
• 钩子自动化——通过 .claude/settings.json 配置 PreToolUse/PostToolUse/Stop 生命周期脚本。
• 上下文工程——衡量并管理整个代码库的上下文窗口令牌预算。

适用场景

• 为任何项目编写、组织或优化 CLAUDE.md 文件。
• 搭建新的技能包或创建 Claude Code 子 Agent。
• 配置钩子，以自动执行质量、安全或工作流步骤。
• 审查并减少上下文窗口用量。

请先确认

在搭建或优化之前，请确认以下信息。如果有任何信息未知或含糊不清，请先询问，不要自行假设：

• 要执行的任务——搭建新技能、优化 CLAUDE.md、创建子 Agent，还是分析上下文预算（决定使用 skill_scaffolder.py、claudemd_optimizer.py 还是 context_analyzer.py）
• 目标信息——对于新技能：名称、领域和一句话描述；对于优化：文件或项目路径（脚本所需的输入）
• 令牌预算——目标上限（用于设置 --token-limit 以及判断哪些内容超出预算）

停止规则：只询问对结果影响最大的 2-3 个问题。如果用户说“直接起草”，则继续操作，并在产物开头列出假设。

快速开始

# Scaffold a new skill package
python scripts/skill_scaffolder.py my-new-skill --domain engineering --description "Brief description"

# Analyze and optimize an existing CLAUDE.md
python scripts/claudemd_optimizer.py path/to/CLAUDE.md

# Estimate context window usage across a project
python scripts/context_analyzer.py /path/to/project

# All tools support JSON output
python scripts/claudemd_optimizer.py CLAUDE.md --json

工具

工具	用途	命令
skill_scaffolder.py	按正确结构和 frontmatter 搭建新的技能包	python scripts/skill_scaffolder.py my-skill -d engineering --description "Does X"
claudemd_optimizer.py	评估 CLAUDE.md 的结构、令牌用量和冗余，并提供改进建议	python scripts/claudemd_optimizer.py CLAUDE.md --token-limit 4000
context_analyzer.py	按文件类别估算上下文窗口用量，并分解预算	python scripts/context_analyzer.py /path/to/project --max-depth 4

所有工具均支持 --json。完整参数表和输出格式请参阅 references/tool-reference.md。

参考资料

加载与任务匹配的参考资料——保持此文件精简，按需查阅详情：

• references/workflows.md — 五个编号的操作指南：优化 CLAUDE.md、编写技能、创建子 Agent、配置钩子以及管理上下文预算。逐步执行这些任务时请阅读。
• references/quick-reference.md — 斜杠命令、权限模式、CLAUDE.md 加载顺序、MCP 服务、故障排查表和成功标准。需要快速查阅或调试配置时请阅读。
• references/tool-reference.md — 三种 Python 工具的完整参数表和输出格式。需要编写脚本调用这些工具或解读其 JSON 输出时请阅读。
• references/skill-authoring-guide.md — 编写有效技能的综合参考，从 YAML 前置元数据到结构设计。深入编写技能时请阅读。
• references/subagent-patterns.md — 创建和使用子 Agent 以执行并行工作和限定范围任务的指南。设计子 Agent 时请阅读。
• references/hooks-cookbook.md — 用于代码质量、安全强制执行和工作流自动化的实用钩子示例。构建钩子时请阅读。

模板： assets/skill-template.md、assets/agent-template.md

范围与限制

此技能涵盖：

• 为任何项目编写、组织和优化 CLAUDE.md 文件
• 按照正确的目录布局和前置元数据搭建新的技能包
• 创建和配置具有限定工具访问权限的 Claude Code 子 Agent
• 分析并管理代码库中的上下文窗口 Token 预算

此技能不涵盖：

• 编写应用程序源代码或实现业务逻辑（参见 senior-fullstack、senior-backend）
• MCP 服务开发或自定义传输协议（参见 mcp-server-builder）
• 面向大模型应用的高级提示词工程技术（参见 senior-prompt-engineer）
• CI/CD 流水线配置或部署自动化（参见 senior-devops、ci-cd-pipeline-builder）

集成点

技能	集成方式	数据流
senior-architect	架构决策决定 CLAUDE.md 结构章节的内容	架构图和模式汇入 CLAUDE.md 的“架构概览”章节
code-reviewer	创建用于自动化代码审查的子 Agent	Claude Code Mastery 创建 Agent .md 文件；Code Reviewer 提供审查逻辑
senior-prompt-engineer	优化技能描述和 Agent 指令中的提示词	提示词工程技术可改进 YAML 前置元数据中的触发短语和 Agent 系统提示词（即 Agent 文件正文）
doc-drift-detector	检测 CLAUDE.md 是否与代码库脱节	Context Analyzer 的输出用于检测文档漂移；发现漂移后会触发 CLAUDE.md 优化
context-engine	高级上下文管理策略	Context Analyzer 提供 Token 预算；Context Engine 执行压缩和优先级排序
senior-secops	安全钩子和权限模式配置	SecOps 策略定义要拒绝哪些工具；Claude Code Mastery 配置权限允许列表