Skip to content

PhilRobinluo/ai-coevolution-skills / skills/lls-prompt-basics-coach

lls-prompt-basics-coach

Verified

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

在 WorkBuddy 中找到并安装

Skill slug:lls-prompt-basics-coach

在 WorkBuddy 新会话粘贴:

请按 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 个要点;
  • 保留三个产品名;
  • 使用六年级能看懂的中文;
  • 遇到不确定信息标记“待确认”。

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

输出格式

直接描述结构:

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

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

测试

至少准备三个案例:

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

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

教练流程

第一步:恢复真实任务

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

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

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

第二步:做缺口诊断

按五块积木逐项标记:

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

第三步:给最小可用版

先生成能跑的短版:

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

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

第四步:用样例运行

展示:

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

第五步:沉淀可复用模板

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

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

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

常见误区

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

输出标准

每次辅导至少包含:

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

质量门禁

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

练习材料见 references/practice-cases.md。

使用入口

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

reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall