一、结构化提示词基础

1.1 为什么结构化很重要

在实际使用Claude Code时，你是否遇到过这些情况？

• 说了半天需求，CC生成的代码却不是你想要的
• 修改了好几次，CC还是理解不了你的意图
• 同样的需求，不同时候问得到完全不同的结果

核心原因：提示词缺乏清晰的结构

graph LR
    A[非结构化提示词] --> B[模糊]
    A --> C[不完整]
    A --> D[依赖猜测]
    B --> E[结果不符合预期]
    C --> E
    D --> E

    F[结构化提示词] --> G[清晰]
    F --> H[完整]
    F --> I[可验证]
    G --> J[精准匹配需求]
    H --> J
    I --> J

    style A fill:#ffcdd2
    style F fill:#c8e6c9
    style E fill:#ffcdd2
    style J fill:#c8e6c9

结构化提示词的好处：

1.2 CC中如何写结构化提示词

在Claude Code中，结构化提示词有三个层次：

层次1：基本对话式

# 直接输入
帮我分析这个文件的问题

层次2：分段式

# 分段描述
需求：分析代码问题
文件：src/utils.js
重点：性能和可读性

层次3：完整结构式（推荐）

## 任务类型
代码审查与分析

## 目标文件
src/utils.js

## 分析重点
- 性能问题
- 可读性问题
- 潜在Bug

## 输出要求
1. 列出发现的问题
2. 按严重程度排序
3. 给出修复建议

1.3 四要素框架

经过大量实践，我们总结出CC提示词的四要素框架：

graph TD
    A[CC提示词四要素] --> B[Context<br/>上下文]
    A --> C[Task<br/>任务]
    A --> D[Requirements<br/>要求]
    A --> E[Format<br/>格式]

    B --> B1[项目背景]
    B --> B2[技术栈]
    B --> B3[相关文件]

    C --> C1[动作动词]
    C --> C2[对象]
    C --> C3[目标]

    D --> D1[功能要求]
    D --> D2[约束条件]
    D --> D3[边界情况]

    E --> E1[代码语言]
    E --> E2[文件结构]
    E --> E3[命名规范]

    style A fill:#4CAF50,color:#fff
    style B fill:#e8f5e9
    style C fill:#e8f5e9
    style D fill:#e8f5e9
    style E fill:#e8f5e9

要素1：Context（上下文）

上下文帮助CC理解你的项目环境：

❌ 缺少上下文：
"帮我优化这个函数"

 包含上下文：
"这是一个React项目的工具函数，
使用TypeScript编写，
主要用于处理用户输入的表单数据。
帮我优化这个函数。"

上下文包含的关键信息：

要素2：Task（任务）

任务要明确、具体：

❌ 模糊任务：
"处理一下这个文件"

 明确任务：
"重构src/components/UserForm.tsx文件，
将表单验证逻辑抽取为独立的hook"

任务描述的3个关键：

1. 动作动词：重构、创建、优化、修复
2. 对象：哪个文件/功能/模块
3. 目标：达到什么效果

要素3：Requirements（要求）

要求要具体、可验证：

❌ 空泛要求：
"代码要好"

 具体要求：
"代码需要满足：
1. 遵循Airbnb TypeScript规范
2. 添加完整的JSDoc注释
3. 单元测试覆盖率>80%
4. 处理所有可能的错误情况"

要求的SMART原则：