02-任务描述设计

// src/services/prompt/chat-summary.ts
const CHAT_SUMMARY_PROMPT = `
请总结以下客服对话。
`

const CHAT_SUMMARY_PROMPT = `
你是一个客服对话摘要助手。
 
输入：一段客服和用户的对话记录。
 
任务：用一句话总结用户的核心诉求和处理结果。
 
要求：
- 长度不超过 50 字
- 格式：「用户反馈{问题}，{处理结果}」
- 如果问题未解决，处理结果写「待处理」
- 不要包含客服的寒暄和流程性话语
`

// 模糊 ❌ — 「优化」是什么意思？
const prompt = '优化这段产品描述'
 
// 可执行 ✅ — 模型知道该做什么
const prompt = '将以下产品描述精简到 100 字以内，保留核心卖点，去掉修饰性形容词。'

// 对象不明确 ❌ — 「关键字段」是哪些？
const prompt = '提取订单中的关键字段'
 
// 对象明确 ✅ — 字段列表固定，模型不会自由发挥
const prompt = `
从以下 JSON 订单数据中提取这些字段：
- orderId：订单号
- userId：用户 ID
- totalAmount：总金额（分）
- status：订单状态
- createdAt：创建时间
 
以 JSON 对象输出，只包含以上五个字段。
`

// 不可验证 ❌ — 「合适」是什么标准？
const prompt = '给这段代码起一个合适的函数名'
 
// 可验证 ✅ — 有明确的命名规范可以对照
const prompt = `
根据以下命名规范，给函数起名：
- 动词开头（get/set/create/delete/update/check）
- camelCase 格式
- 名字要体现输入和输出
 
输入：一个用户 ID，查询该用户的所有订单
输出：订单数组
 
函数名：
`

// src/services/prompt/article-writer.ts
const ARTICLE_WRITER_PROMPT = `
根据用户提供的主题，撰写一篇技术博客。按以下步骤执行：
 
步骤 1：列出 3-5 个候选标题
步骤 2：从候选标题中选择最适合的一个
步骤 3：根据选定的标题，写出文章大纲（3-5 个章节）
步骤 4：根据大纲，撰写每个章节的内容
步骤 5：检查全文，修正语法错误和不连贯的地方
 
每个步骤的输出格式：
步骤 1 输出：标题列表，每行一个
步骤 2 输出：选定的标题
步骤 3 输出：大纲，用 - 列出章节
步骤 4 输出：完整文章内容（Markdown 格式）
步骤 5 输出：修正后的完整文章内容
 
最终只输出步骤 5 的结果。
`

// src/services/prompt/article-writer-pipeline.ts
import { callModelAPI } from '@/lib/llm'
 
// 每个步骤一个独立的 Prompt 函数
async function generateTitles(topic: string): Promise<string[]> {
  const response = await callModelAPI({
    model: 'gpt-4o',
    messages: [
      {
        role: 'system',
        content: '根据用户提供的主题，生成 5 个技术博客标题。每行一个标题。',
      },
      { role: 'user', content: topic },
    ],
    temperature: 0.8,
  })
  return response.choices[0].message.content.split('\n').filter(Boolean)
}
 
async function selectBestTitle(titles: string[]): Promise<string> {
  const response = await callModelAPI({
    model: 'gpt-4o',
    messages: [
      {
        role: 'system',
        content: '从以下标题中选择最适合技术博客的一个。只输出标题文本，不要解释。',
      },
      { role: 'user', content: titles.join('\n') },
    ],
    temperature: 0,
  })
  return response.choices[0].message.content.trim()
}
 
async function generateOutline(title: string): Promise<string[]> {
  const response = await callModelAPI({
    model: 'gpt-4o',
    messages: [
      {
        role: 'system',
        content: '根据文章标题，生成 3-5 个章节标题。每行一个章节。',
      },
      { role: 'user', content: title },
    ],
    temperature: 0.3,
  })
  return response.choices[0].message.content.split('\n').filter(Boolean)
}
 
async function writeSection(title: string, section: string): Promise<string> {
  const response = await callModelAPI({
    model: 'gpt-4o',
    messages: [
      {
        role: 'system',
        content: `你正在撰写一篇标题为「${title}」的技术博客。请撰写「${section}」章节的内容。800-1200 字，包含代码示例。Markdown 格式。`,
      },
      { role: 'user', content: `请撰写「${section}」章节` },
    ],
    temperature: 0.5,
  })
  return response.choices[0].message.content
}
 
// Pipeline 编排
export async function writeArticle(topic: string): Promise<string> {
  const titles = await generateTitles(topic)
  const bestTitle = await selectBestTitle(titles)
  const outline = await generateOutline(bestTitle)
 
  // 每个章节可以并行写
  const sections = await Promise.all(
    outline.map((section) => writeSection(bestTitle, section))
  )
 
  return `# ${bestTitle}\n\n${sections.join('\n\n---\n\n')}`
}

// 两件事混在一个 Prompt 里 ❌
const prompt = `
分析这段代码的性能问题，并且生成对应的单元测试。
`
 
// 拆成两个独立的 Prompt ✅
const perfPrompt = '分析这段代码的性能问题，列出 top 3 瓶颈。'
const testPrompt = '根据以下代码和性能分析结果，生成单元测试。'

// 混用近义词 ❌ — 模型可能理解为不同的操作
const prompt = `
1. 检查代码中的类型问题
2. 检测性能瓶颈
3. 审查安全漏洞
4. 校验命名规范
`
 
// 统一动词 ✅ — 模型知道这四个都是「找问题」
const prompt = `
检查以下代码，按类别报告问题：
1. 类型安全：any 滥用、未标注类型、不安全断言
2. 性能问题：不必要的循环、内存泄漏、重复计算
3. 安全风险：SQL 注入、XSS、硬编码密钥
4. 命名违规：不符合项目命名规范的标识符
`

// src/services/prompt/data-extractor.ts
 
// ❌ 模糊版本
const vaguePrompt = '从用户输入中提取订单信息'
 
// ✅ 具体版本
const EXTRACT_ORDER_PROMPT = `你是一个订单信息提取助手。
 
## 任务
从用户的自然语言输入中，提取订单相关字段。
 
## 需要提取的字段
| 字段名 | 类型 | 说明 |
|---|---|---|
| product_name | string | 商品名称 |
| quantity | number | 数量，默认为 1 |
| unit_price | number | 单价，单位：分 |
| delivery_date | string | 期望配送日期，格式 YYYY-MM-DD |
| address | string | 收货地址 |
 
## 处理规则
- 数量用中文数字表示时，转成阿拉伯数字（「三个」→ 3）
- 金额用元表示时，转成分（「100 元」→ 10000）
- 日期用相对时间表示时，基于今天计算绝对日期
- 缺少的字段填 null
- 如果输入完全不包含订单信息，返回空对象 {}
 
## 输出格式
JSON 对象，只包含以上字段。不要输出其他说明文字。`
 
// Hono 路由
const app = new Hono()
 
app.post('/extract-order', async (c) => {
  const { text } = await c.req.json()
 
  const response = await callModelAPI({
    model: 'gpt-4o',
    messages: [
      { role: 'system', content: EXTRACT_ORDER_PROMPT },
      { role: 'user', content: text },
    ],
    temperature: 0,
    response_format: { type: 'json_object' },
  })
 
  return c.json({ order: JSON.parse(response.choices[0].message.content) })
})
 
export default app