☰
👁️ 预览
取消
💾 保存
C
Claude
▾
C
Claude
claude@note.center
🔔
消息通知
🔄
账号切换
⚙️
设置
🚪
退出登录
Markdown
富文本
## 一、如何写出高质量的 Prompt ### 黄金公式 ``` 背景 + 目标 + 约束 = 好的 Prompt ``` **背景**：告诉 Claude 相关的上下文 **目标**：明确你要什么结果 **约束**：限制范围和方式 ### 实际对比 ``` ❌ 差的 Prompt： "帮我写个登录功能" ✅ 好的 Prompt： "在 Express 项目中添加邮箱登录功能 - 使用 Prisma 查询用户 - 密码用 bcrypt 验证 - 返回 JWT token（过期时间 7 天） - 添加输入验证和错误处理 - 遵循现有的代码风格 " ``` ### 常见场景的 Prompt 模板 **场景一：实现新功能** ``` 在 [项目名] 中实现 [功能名称] 技术栈：[框架/库/数据库] 需要支持： 1. [功能点 1] 2. [功能点 2] 约束： - 遵循现有的代码风格 - 添加单元测试 - 错误处理完善 ``` **场景二：修复 Bug** ``` [描述 Bug 现象] 复现步骤： 1. [步骤 1] 2. [步骤 2] 报错信息： ``` [粘贴错误日志] ``` 相关文件：[文件路径] ``` **场景三：代码重构** ``` 重构 [文件/模块] 目标：[重构目标，如"提升性能"、"提高可读性"] 约束： - 不改变对外接口 - 测试全部通过 - 保持现有风格 ``` ## 二、项目管理实战 ### 新项目上手流程 ```bash # 1. 启动 Claude claude # 2. 先了解项目 "分析这个项目的整体架构" # 3. 生成项目文档（如果没有） /init # 4. 开始开发 "实现第一个功能模块" ``` ### 日常开发流程 ``` 1. 拉取最新代码 → 2. 用 Claude 开发 → 3. 审查改动 → 4. 提交代码 ``` 每次用 Claude 开发新功能后，用 `/code-review` 审查一遍再提交。 ### 代码提交前检查清单 ``` □ 用 /code-review 审查了所有改动 □ 运行测试全部通过 □ 没有遗留的调试代码 □ 错误处理完善 □ 新功能有对应的测试 ``` ## 三、调试技巧 ### 当 Claude 的修复不理想时 ``` 问题：修复方案不对 解决：提供更多上下文 "看一下 src/auth.ts:45 附近的代码，这个 validate 函数的预期行为是什么" 问题：改错了文件 解决：明确约束 "不要修改 database.ts，只修改 auth.ts" 问题：理解有偏差 解决：重新描述 "我说的是当用户不存在时返回 404，不是返回 500" ``` ### 复杂 Bug 排查流程 ``` 1. "运行测试，把所有失败结果给我看" 2. "分析第一个失败的原因" 3. "修复它" 4. "重新运行测试验证" 5. 重复直到全部通过 ``` ## 四、Prompt 书写技巧 ### 技巧 1：具体比抽象好 ``` ❌ "优化这段代码" ✅ "这段代码在数据量大时很慢，分析瓶颈并优化查询逻辑" ``` ### 技巧 2：给例子 ``` ❌ "用合适的格式输出" ✅ "输出格式：名称 | 版本 | 描述" ``` ### 技巧 3：一次性说清楚 ``` ❌ "加个按钮" → "加个删除按钮" → "红色的删除按钮" ✅ "在用户列表每行末尾加一个红色的删除按钮，点击后弹出确认框" ``` ### 技巧 4：使用术语 ``` ❌ "把数据存起来" ✅ "用 Prisma ORM 写入 PostgreSQL，表名 users" ``` ## 五、安全须知 ### 务必注意 | 风险 | 说明 | 预防措施 | |------|------|---------| | 敏感信息泄露 | API 密钥、密码出现在对话中 | 使用环境变量，不要硬编码 | | 危险命令 | rm -rf、DROP TABLE 等 | 执行前仔细确认命令内容 | | 未审查代码 | AI 生成的代码直接上生产 | 用 /code-review 审查 | | 依赖风险 | 安装不安全的第三方包 | 检查包的来源和版本 | ### 安全配置建议 ```json { "permissions": { "block": ["rm -rf", "DROP DATABASE", "DROP TABLE"] } } ``` ## 六、常见场景速查 | 需求 | 最佳做法 | |------|---------| | 学习新项目 | "分析项目架构" → /init → 逐个模块阅读 | | 实现功能 | 先给需求 → 讨论方案 → 分步实现 → 测试 | | 修复 Bug | 给错误信息 → 定位问题 → 修复 → 验证 | | 代码审查 | /code-review high | | 重构代码 | 说明重构目标 → 明确不改的接口 → 逐步重构 | | 编写测试 | "为 xxx 编写单元测试，覆盖正常/异常/边界" | | 生成文档 | "为 xxx 生成 API 文档" | | 性能优化 | "分析 xxx 的性能瓶颈" → 给出优化方案 | | 数据库操作 | 给 schema → 说明操作需求 → 预览 SQL → 执行 | | 部署脚本 | 给部署环境 → 说明步骤 → 生成脚本 → 测试 | ## 七、进阶学习路径 掌握了以上内容后，可以继续深入： ``` 1. 学习 Workflow 系统 → 编排多代理完成复杂任务 2. 学习 MCP 协议 → 连接外部工具和数据源 3. 编写自定义 Skill → 固化你的工作流 4. 探索 Claude API → 构建自己的 AI 应用 5. 研究 Memory 机制 → 打造个性化的 AI 助手 ``` ### 推荐练习 1. 用一个真实项目练习：让 Claude 分析、修改、测试 2. 编写 3 个自己常用的 Skill 3. 用 `/loop` 自动化一个重复性任务 4. 尝试用 Workflow 并行处理多个任务 --- > Claude Code 是一个强大的工具，但真正的价值来自于**你如何使用它**。多练习、多尝试，找到最适合你工作流的用法。 ## 💡 实际使用场景 ### 场景一：新人写第一个功能 新入职的小陈要写用户列表导出功能。他写了一段 Prompt： ``` 在管理后台的用户管理模块中，添加一个"导出 CSV"按钮 - 点击后导出当前筛选条件下的用户数据 - 包含：用户名、邮箱、注册时间、最后登录时间 - 导出后自动下载 - 数据超过 1 万条时分批处理 ``` Claude 实现了功能、添加了测试、通过了 lint。小陈用 `/code-review` 审查了一遍，确认没问题后提交了。 ### 场景二：重构历史遗留代码 老周维护的一个模块超过了 2000 行，他分步推进： ``` 第 1 步：帮我分析这个模块的职责，建议拆分方案 第 2 步：按方案把数据处理逻辑抽离到独立的 service 文件 第 3 步：把 UI 部分拆成 3 个独立组件 第 4 步：为抽离后的代码补充单元测试 ``` 每步 Claude 都先说明要做什么、改了哪些文件，老周确认后再继续。最终 2000 行的文件变成了 5 个文件，每个 300~400 行。 ### 场景三：紧急线上问题排查 凌晨 2 点，告警响了——支付接口超时。值班的小张打开电脑连上环境，输入： ``` 查看近 1 小时的错误日志，分析支付超时的原因，优先检查最近 3 天的代码变更 ``` Claude 读取了错误日志 → 发现大量数据库连接超时 → 检查最近代码变更 → 定位到是连接池配置被误改 → 自动修复并重启验证。整个过程 15 分钟。
预览
编辑内容后实时预览...