Explore-Plan-Code 工作流

使用 Claude Code 进行软件开发

Dani Zysman

AI Curriculum Manager @ DataCamp

"直接下水"的问题

冰山:水面上是提示,水面下是隐藏的复杂性

使用 Claude Code 进行软件开发

工作流

流程图:Init → Explore → Plan → Code

使用 Claude Code 进行软件开发

API 项目概览

music-analytics-api/
  app.py           # Application entry point
  routes.py        # API endpoints
  models.py        # Artist/Album models
  analytics.py     # Statistics functions
  middleware.py    # Request logging
  config.py        # Session settings

一个简单的 Music Analytics API,已有约定需要遵循。

使用 Claude Code 进行软件开发

CLAUDE.md:项目记忆

CLAUDE.md:

  • 为 Claude 提供项目的持久上下文
  • Claude 每次会话都会自动读取
  • 无需每次重复解释您的项目设置
使用 Claude Code 进行软件开发

从 /init 开始

> /init
Music Analytics API
A Flask-based REST API for music data analytics.

Project Structure
- app.py       Flask application entry point
- routes.py    API endpoint definitions
- analytics.py Statistical analysis functions

Coding Conventions
- Use type hints for function parameters
- Include docstrings for all public functions
- Follow PEP 8 style guidelines
使用 Claude Code 进行软件开发

Plan 模式

  • 用 Shift+Tab 切换,或输入 /plan
  • 生成计划后,按 Ctrl+G 可可视化、批准、审阅或编辑
使用 Claude Code 进行软件开发

跳过规划的后果

> Add a /api/login endpoint that creates a session for a user
from flask import jsonify, request
from flask_login import LoginManager, login_user
from app import app

login_manager = LoginManager(app)
@app.route('/api/login', methods=['POST'])
def login():
    """Handle user login and create session."""
    data = request.get_json()
    user = User.query.filter_by(username=data['username']).first()
    if user and user.password == data['password']:
        login_user(user)
        return jsonify({'status': 'success'})
    return jsonify({'error': 'Invalid credentials'}), 401
使用 Claude Code 进行软件开发

先规划,再编码

> /plan Add a /api/login endpoint that creates a session for a user
Plan: Add POST /api/login endpoint

Context
The music analytics API has session infrastructure in place
(flask_session, SECRET_KEY, session already imported in routes)
but no authentication.

Files to Modify
- models.py:  add User class, UserStore class, user_store singleton
- routes.py:  expand import, add login route

No changes needed to app.py, config.py, middleware.py, or analytics.py.
使用 Claude Code 进行软件开发

扩展思考

> think about how to add authentication to this API
使用 Claude Code 进行软件开发

思考层级

命令 推理深度
think 基础推理
think more 深入推理
think a lot 全面推理
think longer 延时推理
ultrathink 最大推理
使用 Claude Code 进行软件开发

管理上下文窗口与 Token

excalidraw:上下文窗口被提示与回复填充,展示 token 组成

  • 出现 "Context window exceeded" → 会话过长,使用 /clear
  • 当上下文满了时,Claude 会优先最近的对话
使用 Claude Code 进行软件开发

完整工作流

流程图:/init → Explore → Plan → Review → Code → Test

使用 Claude Code 进行软件开发

让我们一起练习吧!

使用 Claude Code 进行软件开发

Preparing Video For Download...