Claude Code Master

Claude Code Master - 终极使用指南 核心理念

上下文工程 > 提示工程 > 靠感觉写代码

Claude Code 的成功不在于模型能力，而在于上下文的完整性。本 技能 提供系统化的方法，让 Claude Code 从"能用"变成"高效专业"。

一、上下文 Engineering（上下文工程） 1.1 什么是上下文工程？

上下文工程是传统提示工程的范式转变：

提示工程：关注措辞和句式，像给 AI 留便签 上下文工程：提供完整体系化上下文，像为 AI 写完整剧本 1.2 核心文件结构 project/ ├── .claude/ │ ├── commands/ # 自定义斜杠命令 │ ├── 设置tings.local.json # 本地权限设置 │ ├── 代理s/ # Sub 代理s 配置 │ └── 输出-styles/ # 输出 Styles 配置 ├── CLAUDE.md # 项目全局规则 ├── .AI-rules/ # 工具无关的全局上下文 │ ├── product.md # 项目愿景（"为什么"） │ ├── tech.md # 技术栈（"用什么"） │ └── structure.md # 文件结构（"在哪里"） ├── specs/ # 功能规范（Spec-driven） │ └── feature-name/ │ ├── requirements.md # 用户故事和验收标准 │ ├── de签名.md # 技术架构 │ └── tasks.md # 实现计划 ├── PRPs/ # 产品需求提示 │ └── templates/ │ └── prp_base.md └── examples/ # 代码示例

1.3 CLAUDE.md 模板 # 项目 AI 协作规则

项目感知

• 能理解规划文档、任务清单
• 自动读取 specs/ 目录下的规范文件

代码结构约束

• 文件大小：单文件 < 300 行
• 模块拆分：按功能域组织
• 命名规范：使用一致的命名模式

测试要求

• 单元测试：所有新功能必须有测试
• 覆盖率：最低 80%
• 测试框架：使用项目标准测试框架

编码风格

• 语言偏好：[指定语言]
• 格式规范：使用 代码检查工具 自动格式化
• 注释要求：复杂逻辑必须注释

文档规范

• API 文档：所有公开接口必须文档化
• README：保持更新
• 变更日志：记录重要变更

二、Spec-Driven Development（规范驱动开发） 2.1 两阶段工作流

Phase 1: Planning（规划模式）

AI 角色：初级架构师 任务：通过交互式问答创建技术规范 输出：requirements.md, de签名.md, tasks.md

Phase 2: Execution（执行模式）

AI 角色：细致的工程师 任务：严格按规范逐任务实现 特点：一次一个任务，外科手术般精确 2.2 PRP（产品需求提示）工作流

PRP = PRD + 精选代码库知识 + 智能体运行手册

生成 PRP：

/生成-prp INITIAL.md

执行 PRP：

/执行-prp PRPs/your-feature-name.md

2.3 INITIAL.md 模板

功能：

[具体描述你想实现什么功能，清晰明确地写出需求]

示例：

[列出 examples/ 文件夹中参考的代码，并说明它们的用途]

文档链接：

[加入相关文档、API 说明或 MCP 服务器资源链接]

其他注意事项：

[说明任何易错点、特别需求，或 AI 可能忽略的内容]

三、Hooks 回调机制（省 令牌 技巧） 3.1 核心思想

Dis补丁 模式：发射后不管，完成自动回报

传统方式（高 令牌 消耗）：

OpenClaw → 每隔几秒轮询 → Claude Code 状态 ↓ 重复轮询 = 令牌 爆炸

Hooks 方式（零轮询）：

OpenClaw → 下达任务 → Claude Code 独立运行 ↓ 完成后触发 Hook ↓ 自动通知 OpenClaw

3.2 配置示例

latest.json 输出格式：

{ "会话_id": "abc123", "timestamp": "2026-02-09T14:54:27+00:00", "cwd": "/home/ubuntu/projects/hn-抓取器", "event": "会话End", "输出": "Claude Code 的完整输出内容...", "状态": "done" }

Wake Event 调用：

curl -X POST "http://127.0.0.1:18789/API/cron/wake" \ -H "Authorization: Bearer $令牌" \ -d '{"text": "Claude Code 任务完成，读取 latest.json", "mode": "now"}'

3.3 双通道设计 通道 作用 为什么需要 latest.json 数据通道（存结果） 持久化，不依赖服务在线 wake event 信号通道（通知到达） 实时响应，秒级通知

容错设计： 即使 wake event 失败，latest.json 依然存在，AGI 最迟在下次 heartbeat 时也能发现。

四、Sub 代理s（子智能体） 4.1 核心优势 上下文保护：独立上下文窗口，避免主对话污染 专业化提升：针对特定领域深度定制 可重用性：跨项目复用，团队共享 权限管理：不同 Sub 代理 不同工具访问级别 4.2 配置位置 项目级别：.claude/代理s/（高优先级） 用户级别：~/.claude/代理s/ 4.3 内置 Sub 代理s

代码审查专家：

---

name: code-reviewer description: 专业代码审查专家。在编写或修改代码后必须立即使用。 工具s: file_搜索, bash, file_edit

---

你是一位资深代码审查专家，致力于确保代码质量和安全性。

审查清单：

• 代码简洁易读
• 函数和变量命名清晰
• 无重复代码
• 适当的错误处理
• 无暴露的密钥或API密钥
• 实现了输入验证
• 良好的测试覆盖率
• 考虑了性能因素

调试专家：

---

name: 调试器 description: 错误调试和问题排查专家。当遇到任何技术问题必须主动使用。 工具s: file_搜索, file_edit, bash

---

你是一位专业的调试专家，专精于根因分析和问题解决。

调试流程：

• 分析错误信息和日志
• 检查最近的代码更改
• 形成并测试假设
• 添加策略性调试日志
• 检查变量状态

4.4 Kiro 工作流 Sub 代理s

实现 AWS Kiro 风格的 spec-driven 开发：

steering-architect - 项目分析师，创建 .AI-rules/ strategic-planner - 规划师，创建 specs/feature/ task-executor - 执行器，逐任务实现

使用方式：

# 1. 项目初始化 "@steering-architect 分析现有代码库并创建项目指导文件"

# 2. 功能规划 "@strategic-planner 规划用户认证功能"

# 3. 逐步实现 "@task-executor 执行 specs/user-authentication/tasks.md 中的任务"

五、输出 Styles（输出风格） 5.1 内置风格 Default - 面向高效软件工程协作 Explanatory - 讲解型，插入 Insights 解释实现选择 Learning - 学习型，边做边教，插入 TODO(human) 5.2 切换方式 # 交互式切换 /输出-style

# 直接切换 /输出-style explanatory /输出-style learning

5.3 自定义风格

创建新风格：

/输出-style:new 我想要一个安全审计风格：偏严格、先 threat 模型ing、产出修复建议

手动创建文件：

---

name: Code Reviewer description: 自动化代码审查和优化

---

You are a specialized code review 助手...

Core 工作流 Process

...

响应 Structure

...

存储位置：

用户级：~/.claude/输出-styles/ 项目级：.claude/输出-styles/（团队共享） 5.4 实用风格示例

PRD Writer：

---

name: PRD Writer description: "标准化 PRD 输出：背景、目标、指标、scope、用户故事、验收标准"

---

# Product Requirement Document - {title}

1. 概要

2. 背景与问题陈述

3. 目标（3-5个，可量化）

4. 成功衡量（KPI）

5. Scope（包含/不包含）

6. 用户画像与使用场景

7. UX / Flow

8. API / 数据需求

9. 非功能性需求

10. Risks & Mitigations

11. Rollout & 回滚 Plan

12. Open Questions

13. Acceptance Criteria

六、SuperClaude 框架 6.1 安装 # 克隆项目 git clone https://github.com/NomenAK/SuperClaude.git cd SuperClaude

# 执行安装 ./安装.sh

# 验证 ls -la ~/.claude/ ls -la ~/.claude/commands/

6.2 核心命令

开发构建类：

/build --react --magic --tdd - React 项目开发 /build --API --tdd --coverage - API 后端开发 /build --init --magic --c7 --plan - 项目初始化

分析类：

/analyze --architecture --persona-architect - 架构分析 /troubleshoot --investigate --prod - 问题排查

设计类：

/de签名 --API --ddd "功能描述" - 领域驱动设计 /de签名 --prd "产品描述" - 生成 PRD