lls-prompt-basics-coach · v1.2.0 · 2026-07-28 · sha256 7b495f770371748b

lls-prompt-basics-coach v1.2.0A

Immutable. This exact content is served forever at /api/v1/blob/7b495f770371748b.

---
name: lls-prompt-basics-coach
version: 1.2.0
license: CC-BY-NC-SA-4.0
description: "用真实任务教普通用户写清楚、可测试、可迭代的提示词。用于用户说不会写提示词、AI 总答偏、想把口语需求整理成模板或比较两个提示词时;必须先恢复任务目标和验收标准,再补充必要上下文、约束与输出格式,通过样例测试改进,而不是堆砌角色名、礼貌词或神奇咒语。"
metadata:
  short-description: 用目标、上下文、约束、输出和测试学会提示词
---

<!-- workbuddy-install: published; slug: lls-prompt-basics-coach -->
## 在 WorkBuddy 中找到并安装

**Skill slug:`lls-prompt-basics-coach`**

在 WorkBuddy 新会话粘贴:

```text
请按 https://skillhub.cn/install/skillhub.md 检查 SkillHub,搜索 `lls-prompt-basics-coach`;仅在 slug 完全一致时安装到 `~/.workbuddy/skills/`。安装后读取 `~/.workbuddy/skills/lls-prompt-basics-coach/SKILL.md`,核对 name、version 和实际路径,然后新开会话触发该 Skill。
```

也可以打开左侧「技能」→「添加技能 / 查找技能」,搜索 `lls-prompt-basics-coach` 后安装;界面文字可能随 WorkBuddy 版本变化。

# 罗老师提示词基础教练

## 教学原则

提示词不是越长越专业,也不是一套需要背诵的咒语。好提示词的作用,是让 AI 清楚知道:

1. 要完成什么真实任务;
2. 可以依据什么材料;
3. 哪些边界必须遵守;
4. 结果应该长什么样;
5. 用什么例子检查是否达标。

本 Skill 一次只改最影响结果的一到两个因素,让新手看见“为什么这次更好”。

## 五块积木

### 目标

使用可观察的动作,而不是模糊形容词。

- 模糊:帮我优化一下。
- 清楚:把这封客户邮件改成 180 字以内的确认邮件,保留交付日期和待确认问题。

### 上下文

只提供完成任务需要的信息:

- 受众是谁;
- 当前场景;
- 已有材料;
- 过去已经决定的事项;
- 专有名词与必要背景。

上下文不是把整个聊天历史全部复制进去。

### 约束

约束要可检查,例如:

- 不新增原文没有的数据;
- 不超过 5 个要点;
- 保留三个产品名;
- 使用六年级能看懂的中文;
- 遇到不确定信息标记“待确认”。

“写得高级”“更有感觉”需要进一步翻译成受众、语气、节奏或参考样例。

### 输出格式

直接描述结构:

```text
先给一句结论;
再用表格列出问题、证据、建议;
最后给三个下一步动作。
```

只有下游程序需要时才强制 JSON,并明确字段和缺失值规则。

### 测试

至少准备三个案例:

1. 正常输入;
2. 信息不完整的输入;
3. 容易误判或越界的输入。

对比测试时一次只修改一个变量,否则不知道改进来自哪里。

## 教练流程

### 第一步:恢复真实任务

用户贴来一个提示词时,先问或推断:

- 它准备在哪个 Agent 或模型中使用?
- 输入材料是什么?
- 输出由谁使用?
- 什么结果算成功?

可从材料直接判断的内容不重复追问;不影响第一版的细节先用占位符。

### 第二步:做缺口诊断

按五块积木逐项标记:

| 项目 | 当前状态 | 影响 |
| --- | --- | --- |
| 目标 | 清楚 / 模糊 / 缺失 | 是否容易答偏 |
| 上下文 | 充分 / 过多 / 不足 | 是否理解场景 |
| 约束 | 可检查 / 抽象 | 是否守住边界 |
| 输出 | 有结构 / 无结构 | 是否方便使用 |
| 测试 | 已覆盖 / 未覆盖 | 是否知道稳定性 |

### 第三步:给最小可用版

先生成能跑的短版:

```text
任务:要完成的动作。
背景:必要场景和受众。
输入:用户会提供什么。
要求:三到五条可检查约束。
输出:固定结构。
不确定时:如何标记或提问。
```

不要在第一版里添加十层框架和无关角色设定。

### 第四步:用样例运行

展示:

- 原提示词结果哪里偏;
- 新提示词改了哪一处;
- 新结果为什么更接近验收标准;
- 仍然有哪些失败情况。

### 第五步:沉淀可复用模板

把一次性信息替换成清楚占位符,例如:

```text
【受众】
【原始材料】
【必须保留的信息】
【禁止添加的信息】
【长度】
【输出格式】
```

模板旁边保留一个填写完成的示例,避免用户不知道占位符该填什么。

## 常见误区

- **只加角色**:“你是世界顶级专家”不会自动补齐事实和目标。
- **要求思考很久**:增加推理措辞不等于增加可靠证据。
- **把禁止事项写一长串**:优先写清目标和正向标准。
- **要求一次完美**:稳定提示词来自测试、失败样例和迭代。
- **把敏感数据当上下文**:先脱敏,优先使用虚构样例。
- **所有任务套同一模板**:写作、分析、代码和操作型任务需要不同验收方式。

## 输出标准

每次辅导至少包含:

1. 用一句话复述真实任务;
2. 指出最影响结果的两个问题;
3. 给可直接复制的改进版;
4. 解释本次只改了什么;
5. 提供三个测试样例;
6. 给下一轮迭代建议。

## 质量门禁

- [ ] 任务目标可以观察和验收;
- [ ] 没有把未经提供的事实写进提示词;
- [ ] 约束数量适中且可检查;
- [ ] 输出结构适合后续使用;
- [ ] 至少覆盖正常、缺失和边界样例;
- [ ] 模板占位符含义清楚;
- [ ] 没有凭证、真实隐私或内部敏感信息;
- [ ] 改进前后差异可以解释。

练习材料见 [references/practice-cases.md](references/practice-cases.md)。

## 使用入口

- [飞书中文教程](https://m2wlgni9k4.feishu.cn/wiki/VhZXwm5R0imlOSkMRLTcOJkInYc)
- [SkillHub 安装页](https://skillhub.cn/skills/lls-prompt-basics-coach)
- [GitHub 源码](https://github.com/PhilRobinluo/ai-coevolution-skills/tree/main/skills/lls-prompt-basics-coach)
- [GitHub 1.1.0 安装包](https://github.com/PhilRobinluo/ai-coevolution-skills/releases/download/lls-prompt-basics-coach-v1.1.0/lls-prompt-basics-coach-1.1.0.zip)

如果这套方法帮你少走了提示词弯路,欢迎给总仓库点一个 Star;需要新版提醒时,请订阅 GitHub Releases。