考点3:Claude Code配置与工作流(20%)
3.1 配置具有层次结构、作用域和模块化组织的CLAUDE.md
关键知识:
- CLAUDE.md层次结构:用户(
~/.claude/CLAUDE.md)、项目(.claude/CLAUDE.md或根目录CLAUDE.md)和目录级(子目录中的CLAUDE.md) - 用户级设置仅适用于一个用户,不通过版本控制系统共享
- 引用外部文件的
@path语法(例如,@./standards/coding-style.md)用于模块化CLAUDE.md - 用于主题聚焦规则文件的
.claude/rules/目录,而非单一的CLAUDE.md
关键技能:
- 诊断层次结构问题(新团队成员因指令位于用户级而非项目级而遗漏了指令)
- 使用
@path(例如,@./standards/testing.md)在每个包的CLAUDE.md中有选择地包含标准 - 将大型CLAUDE.md拆分为多个
.claude/rules/文件(testing.md、api-conventions.md、deployment.md)
3.2 创建和配置自定义斜杠命令与技能
关键知识:
.claude/commands/中的项目命令(通过版本控制系统共享)vs~/.claude/commands/中的用户命令.claude/skills/中的技能,带有SKILL.md前置内容:context: fork、allowed-tools、argument-hintcontext: fork在隔离的子智能体上下文中运行技能,不污染主会话- 个人技能变体可以以不同名称存储在
~/.claude/skills/中
关键技能:
- 在
.claude/commands/中存储项目斜杠命令,以便整个团队都能使用 - 使用
context: fork隔离具有详细输出的技能 - 使用
allowed-tools限制技能可以使用的工具 - 使用
argument-hint提示开发者输入必要参数
3.3 使用路径特定规则进行条件约定加载
关键知识:
.claude/rules/文件可以包含YAML前置内容中的paths,以根据glob模式激活规则- 路径作用域规则仅在编辑匹配文件时加载,节省上下文和令牌
- 当约定跨越多个目录时(例如测试),基于glob的路径规则比目录级CLAUDE.md更优
关键技能:
- 创建带有
paths: ["terraform/**/*"]的.claude/rules/文件,仅在处理匹配文件时加载 - 使用glob模式(
**/*.test.tsx)按文件类型应用约定,不受位置限制 - 当约定跨越代码库时,优先使用路径特定规则而非目录级CLAUDE.md
3.4 决定何时使用规划模式vs直接执行
关键知识:
- 规划模式:用于变更量大、有多种可行方案和架构决策的复杂任务
- 直接执行:用于简单、易于理解的变更(例如,添加单个验证)
- 规划模式可在进行修改前安全探索代码库
- 探索子智能体隔离详细的发现输出
关键技能:
- 对具有架构影响的任务使用规划模式(微服务、涉及45+文件的迁移)
- 对有清晰堆栈跟踪和单个文件的修复使用直接执行
- 使用探索子智能体防止多阶段任务中的上下文窗口耗尽
- 结合两种方法:规划用于发现,执行用于实现
3.5 渐进式细化以持续改进
关键知识:
- 具体的输入/输出示例是传达期望最有效的方式
- 测试驱动迭代:先写测试,然后根据失败进行迭代
- "访谈"模式:Claude提问以发现非显而易见的设计考量
- 何时在一条消息中提供所有问题(相互依赖)vs 顺序提供(独立)
关键技能:
- 提供2-3个具体的输入/输出示例来阐明转换需求
- 在实现之前构建包含预期行为、边缘情况和性能要求的测试集
- 使用访谈模式发现设计方面(缓存失效、故障模式)
- 为边缘情况提供具体测试用例和样本输入及预期输出
3.6 将Claude Code集成到CI/CD管道
关键知识:
- 用于自动化管道非交互模式的
-p(或--print)标志 - CI中结构化输出的
--output-format json和--json-schema - CLAUDE.md为CI触发的Claude Code提供项目上下文(测试标准、审查标准)
- 会话上下文隔离:生成代码的同一会话在审查时比独立实例效果更差
关键技能:
- 在CI中使用
-p运行Claude Code以避免挂起在交互式输入上 - 使用
--output-format json+--json-schema获取结构化结果(例如,内联PR评论) - 在新提交后重新运行时包含之前的审查结果(仅报告新问题/未修复问题)
- 在CLAUDE.md中记录测试标准和可用夹具以提高测试生成质量
- 在生成新测试时将现有测试文件包含在上下文中,以避免重复并保持风格一致