Claude Code 日常开发工作流：从代码理解到 PR 提交的 10 个高效实践

# 第 1 步：获取高层概述
give me an overview of this codebase

# 第 2 步：了解架构模式
explain the main architecture patterns used here

# 第 3 步：深入关键模块
what are the key data models?
how is authentication handled?
explain the folder structure

find the files that handle user authentication
how do these authentication files work together?
trace the login process from front-end to database

# 步骤 1：分享错误信息（包含完整堆栈跟踪）
I'm seeing this error when I run npm test:
[粘贴错误信息]

# 步骤 2：请求修复建议
suggest a few ways to fix the @ts-ignore in user.ts

# 步骤 3：应用最佳方案
update user.ts to add the null check you suggested

# 启动时进入 Plan Mode
claude --permission-mode plan

# 会话中切换（Shift+Tab 循环切换模式）
# Normal → Auto-Accept → Plan Mode

# 无交互查询（非常适合自动化脚本）
claude --permission-mode plan -p "Analyze the authentication system and suggest improvements"

> I need to refactor the authentication system to use OAuth2. Create a detailed migration plan.

# 发现需要重构的代码
find deprecated API usage in our codebase

# 获取重构建议
suggest how to refactor utils.js to use modern JavaScript features

# 安全执行重构（保持向后兼容）
refactor utils.js to use ES2024 features while maintaining the same behavior

# 验证重构结果
run tests for the refactored code

# 为现有代码编写测试
write unit tests for the calculator functions in src/utils/calculator.ts

# 生成测试后运行
run the tests and fix any that are failing

# 提高覆盖率
identify untested code paths in auth.ts and write tests for them

# TDD 方式：先写测试
write failing tests for a new user registration feature,
then implement the feature to make them pass

# 查看变更状态
what files have I changed?
give me a summary of my uncommitted changes

# 生成有意义的提交信息
commit my changes with a descriptive message

# 分支管理
create a new branch called feature/user-auth-improvement

# 代码审查前的自检
review my changes and suggest improvements before I submit the PR

# 处理合并冲突
help me resolve the merge conflicts in src/auth.ts

# 查看提交历史
show me the last 5 commits and summarize what changed

# 更新 README
update the README with installation instructions based on our new setup process

# 生成 API 文档
generate API documentation for all exported functions in src/api/

# 添加内联注释
add JSDoc comments to the functions in user.ts that are missing documentation

# 生成 CHANGELOG
create a CHANGELOG entry for the features added in this PR

# 审查自己的改动
review my recent changes for security vulnerabilities

# 检查特定方面
check the authentication code for potential SQL injection vulnerabilities
review the error handling in the API endpoints

# 性能分析
identify performance bottlenecks in the database query functions

# 审查团队成员的代码（配合 GitHub Actions）
# 在 PR 中 @claude review this PR for:
# - Security issues
# - Performance concerns
# - Missing error handling

# 查看可用 Subagent
/agents

# 使用安全审查 Subagent
use the security-reviewer subagent to check the auth module

# 使用文档生成 Subagent
have the doc-writer subagent generate API docs for src/api/

# Claude 也会自动选择合适的 Subagent
review my recent code changes for security issues  # 自动调用安全 Subagent

# 会话 1：开发新功能（在 feature 分支）
cd project && git checkout -b feature/new-auth
claude  # 开始功能开发

# 会话 2：修复紧急 Bug（在 hotfix 分支）
# 打开新的 Desktop 会话，选择不同的工作目录

1. understand the current auth system architecture
2. plan the OAuth2 migration
3. implement the changes step by step
4. write tests for the new functionality
5. update the documentation
6. create a PR with a detailed description

1. [粘贴错误信息] help me diagnose this error
2. trace the root cause
3. implement a fix
4. run the test suite to ensure nothing is broken
5. commit with a descriptive message referencing the issue