Skip to content

考点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: forkallowed-toolsargument-hint
  • context: 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中记录测试标准和可用夹具以提高测试生成质量
  • 在生成新测试时将现有测试文件包含在上下文中,以避免重复并保持风格一致