实战最佳实践 - 个人运维平台

一、如何写出高质量的 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 助手

💡 实际使用场景

场景一：新人写第一个功能

新入职的小陈要写用户列表导出功能。他写了一段 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 分钟。