Agent_claude_code代码架构设计

项目不存在

有明确的需求，又有真实的环境，有真实的用户
1.在开始之前，如果你对项目的框架或技术栈不是那么清楚，
你可以先和Claude Code聊一聊你的想法/问题
询问框架
2.Claude Code基于我的需求来采访自己，通过一轮轮的对话来完善初期的需求
❯ 我需要创建一个python项目，项目采用fastapi + celery + uvicorn + pydantic，celeryde broker使用redis，
项目的目录结构及分层遵循基础项目规范。现在请采访我，补充完善这个基础的脚手架项目。

3.针对项目整体架构的，最好持久化到文档中，后续任何时候都可以基于文档而不是上下文来开始工作
先把设计方案写到当前目录下以便后续参考

4.让Claude Code根据文档中的要求来规划和生成项目

5.启动验证

项目已经存在，升级和迭代

项目已经存在，让Claude Code生成CLAUDE.md文件，指导后续工作
初始化一个本项目的CLAUDE.md文件
执行/init命令，Claude Code会根据当前项目的架构和现状，生成一份CLAUDE.md文
尽量明确拆分任务，细化任务
测试与验证。在开发的过程中，一般会在任务中会进行Code Review保证设计的合理性，在最后环节进行单元测试，验证功能是否正确

做选择和确认

执行任务时，可以做一个简单的分层：
日常任务：写测试、简单改代码、解释逻辑、常规重构
复杂任务：多文件架构设计、棘手 bug 排查、跨系统分析
轻量任务：查找、格式化、重命名、重复性操作

示例

❯ 我需要创建一个python项目，项目采用fastapi + celery + uvicorn + pydantic，
celeryde broker和Backend使用redis，日志记录请求和任务的执行过程
项目的目录结构及分层遵循基础项目规范。
主要流程和架构如下
Client → FastAPI → Redis (Broker) → Celery Worker → Redis (Backend) → FastAPI → Client
app/
├── core/
│ ├── config.py
│ ├── logging.py
│ └── celery_app.py
├── tasks/
│ └── example_task.py
├── schemas/
│ └── example.py
├── api/
│ └── routes.py
└── main.py
docker-compose.yml
requirements.txt
现在请采访我，补充完善这个基础的脚手架项目。
reids 采用本地账户和密码，celery任务的具体业务场景是处理ETL，API有2个，请求和查询 日志debug

增加对任务状态记录的持久化--可以持久化到mysql或者postgresql

浏览器自动化

--网页自动化
现代网站动态的，而且严重依赖 JavaScript。内容会在你滚动时才加载，按钮会展开隐藏信息
Playwright 用合适的浏览器自动化工具，为你的业务加速
Playwright 的 playwright install 命令，本质是调用 playwright-core 包里的 download_browser.py 脚本

https://cdn.playwright.dev/chrome-for-testing-public/145.0.7632.6/linux64/chrome-linux64.zip
https://cdn.playwright.dev/builds/firefox/1509/firefox-ubuntu-22.04.zip
https://cdn.playwright.dev/builds/ffmpeg/1011/ffmpeg-linux.zip

参考

Claude Code实践：从零开始，一行代码不写生成一个项目 https://hello.blog.csdn.net/article/details/160610319