Trigpoint

本页由繁体中文版自动转换

Collections 书架 › 方法解说

prompt-architect

先定方法,再写提示词

版本:v0.3.x · 文章版本 1.4

手写的提示词,常在两处出问题。第一处是写了角色和任务,却没写任务该怎样做:要经过哪些判断、怎样才算做好、答案分成哪些栏位。这些空位由模型自己补上,每次补法都不一样。

第二处是沿用为旧模型写的写法。厂商的提示词指南随模型改版,页面本身也会搬动。我们在其中一轮测试里就遇到两处:一份 Gemini 指南页自标已弃用(deprecated),Codex 的文件页则转址到新网域。凭记忆写下的「某家要用某种格式」,很可能已经过时。

本文介绍一套把这两件事分开处理的程序:先把任务方法定好,再按目标平台的现行官方指南写成提示词;以及执行它的 agent skill。

程序

程序分两层。第 1 至第 4 步与平台无关,各步的组成沿用各家官方指南;把它们排成这个顺序、并与平台惯例分开,出处是 Trigpoint(2026)。这是一套工作方法,不是研究结果,未与其他提示词写法比较过。第 5 步每次执行时重新查。

1. 判定任务类型。常见的有:摘要或撷取、生成或写作、审查或评估、分类或分派、对话或支援、转换或翻译。类型决定后面三步怎样写。用途混合几类时,定一个主类型,并记下次类型。

2. 拆解任务。写明任务由哪些子任务组成、途中要作哪些决定、每个决定依据什么,按任务类型而定。审查型:要评估哪些维度;每个维度以什么为证据、什么算反证;最后要下哪个判断,例如每项条款的风险等级。摘要型:要找出什么(核心论点、各部分的关系),要挑出什么、按什么准则挑(最有价值、最能直接用上的几点)。子任务有先后时,例如判断要建立在证据之上,写明次序。这一步只写任务本身;模型怎样思考,不在这里规定。要不要在提示词里另外要求逐步推理或末段自我检查,要看目标模型会不会自行推理,属平台问题,留待第 5 步按官方页决定。

3. 订下可以核对的成功标准。写别人可以逐项检查的标准,不写形容词。以摘要为例:每一点都写出支持它的论证与适用范围;数字与公式照录;核心主张没有遗漏。「高品质」「清楚」「吸引人」这类词,除非说明什么现象能证明它,否则不用。

4. 固定输出栏位。定下答案有哪些栏位、次序如何、每栏放什么。以摘要为例:原则,接两至三项支持细节,再写怎样应用,最后列出要点。

5. 读目标平台的现行官方指南。从厂商的通用提示词指南与最新模型(或模型总览)页读起,有该型号的专页再往下读。要找的是:建议的提示词结构、推理或 effort 设定(包括提示词该不该要求逐步推理或自我检查)、该模型建议删去或避免的指示、输出格式惯例,以及模型是否标为 preview、beta 或 legacy。每一点记下网址与读取日期。页面没有写的,就不写进提示词,也不用记忆中的技巧填补。

只给产品名时,要多做一步。聊天产品不等于 API,产品背后用哪个模型,可能取决于方案、用户端与设定。这时先写明假设哪个模型,并引一页支持这个假设;读过的页面都定不了,就写「模型未知」,只采用不依赖型号的建议。

6. 合写成一份可直接贴上的提示词。方法决定内容,平台决定写法。只用目标平台一家的惯例;写出实际的任务拆解、标准与栏位,不只列「角色/任务/限制/输出」几个标题;限制尽量写成有量度的目标,例如「最多 200 字」;提示词单独贴上即可运作,不带来源编号,也不提及本方法;除非用途本身是闲聊或社交,不以 emoji 或装饰符号作段落记号。

交出的结果分三部分:一行摘要,写明用途、平台与模型、任务类型;提示词本身,只贴这部分;使用说明,列出假设的模型与理由、采用的厂商惯例、须在提示词以外调整的设定,每项附来源网址与读取日期,并写明页面没有涵盖的地方。

为什么不附各家写法表

厂商的提示词写法随每次模型发布而变。预先整理好的写法表,下一次发布就可能过时;厂商自己的页面才是权威,而且本来就公开。所以 skill 不附这样一张表。

skill 只带一份来源清单,记录各厂商在哪里发布提示词指南,由执行的 agent 每次去读原页。清单本身也会老化。遇到打不开的连结,skill 要求先分辨页面已消失,还是只有读取工具被拒;页面消失,就找厂商现行的对应页,并在使用说明写明。

读不到网页时,skill 会先说明,请你贴上相关指南的原文;你也可以让它只按第 1 至第 4 步,用通用结构(角色、背景、任务、限制、输出格式)写,并在使用说明注明未查官方指南。没有官方提示词指南的平台,例如建在别家模型之上的工具:知道底层模型,就读该模型厂商的指南;不知道,就用通用结构。根据你上传的文件作答的工具,提示词会要求答案引用那些文件,并在文件没有涵盖时直说。

笔记本与 skill 的分别

本站另有一本公开的 NotebookLM 笔记本「全动态提示词引擎」,列在笔记本页。它同样是写明用途与目标平台,就产出一份可直接贴用的提示词。两者出自同一套方法,但不是同一件东西:

  • 笔记本在 NotebookLM 里使用,不用安装。它依据笔记本内汇入的厂商官方文件作答,这些来源在笔记本改版时更新。笔记本有自己的版本号,与 skill 的版本无关。
  • skill 装进你自己的 agent 使用。它不带预先整理的厂商规则,每次执行都去读厂商的现行官方页,并在使用说明逐点附上网址与读取日期。

只想先试这套方法,用笔记本较方便;要在自己的 agent 工作流里反复使用,并要求每项平台建议都有当日可查的出处,用 skill。

这套方法早前在 Substack 以「全动态提示词基建法」为题,分两篇介绍过:2026 年 3 月的首篇,以及 6 月的 2.0 版。两篇所附的设定指令与笔记本,现已由本站的笔记本与 skill 取代,不再另行提供。

目前的成效

skill 的首个公开候选版(0.1.0)用六个练习请求测试:四类任务、三家厂商,另加一个没给平台、一个没有官方指南的工具。检查的是:提示词含实际的推理步骤、可核对的标准与输出栏位;可以单独贴用;每项平台设定都能追溯到当次读过、附网址与日期的官方页;官方页说要删的指示没有出现;没给平台时,只回一个问题。

  • 第一轮在 Codex 桌面版上跑,六个中四个通过。两个失败:一个为假设的模型引了一页根本没写那个模型的页面;一个在没给平台时问了问题,却多加解释。修改 skill 后重跑其中三个,全部通过。
  • 第二轮在另一台主机(Claude Code)上,没有安装,直接指定 skill 的路径:三个请求通过。另造一条失效连结,agent 指出失效、改读厂商现行页,并在使用说明写明。
  • 来源清单更新后,回到 Codex 主机再跑三个请求,全部通过。另一个读取被拒的情况(指定先用一般 HTTP 请求),agent 改用其他工具读到同一页,并写明是被拒,不是页面消失。清单 28 条连结当日全部可开。
  • 0.2.0 同样在 Codex 桌面版上测:原有六个请求,加上三个写明模型的新请求,全部通过,包括新增的一项检查:每次只打开目标厂商的来源档。请求只写产品、没写模型时,skill 回答「模型未知」,只用不依模型而定的建议;要得到针对某个模型的建议,请写明模型。
  • 0.3.0 把第 2 步由「写出推理步骤」改为「拆解任务」,第一项检查随之改为「提示词含实际的任务拆解」。改版后在 Claude Code 上重跑同样九个请求,没有安装,直接指定 skill 的路径:八个通过。失败的一个是 Codex 上的摘要请求:一条使用说明挂在 Codex 的官方提示词页名下,该页并没有这句;这句来自测试主机自己存的笔记,skill 与厂商页都没有。产出的提示词都没有替模型写推理脚本;要不要求逐步推理或末段自我检查,都按目标模型的官方页决定。0.2.0 答「模型未知」的两个只写产品的请求,这次都写明了假设的模型并附出处,第 5 步容许这样做;只写产品时得到哪一种回答,可能随轮次与主机而不同。

这些检查看的是提示词有没有照方法写成、平台建议能不能追溯到官方页,没有看提示词实际用起来的效果。产生的提示词尚未在目标平台上以真实资料试跑;Codex 以外的宿主未测安装;没有网路、同一请求重复执行,都未测。每次测试都是一个请求跑一次,由协调测试的 agent 评分,不是盲测。测 0.1.0 时,每个请求耗时 13 至 344 秒;有读数的两轮中,每个请求约用 8.4 万至 40.7 万个 tokens(Codex 主机的数字含重复计入的快取输入)。

适用时机

适用于要反复使用的提示词:系统提示、custom instructions、会在同一平台长期跑的任务。提示词的质素取决于用途写得多清楚;用途越具体,第 1 至第 4 步越有东西可定。用途还说不清时,先写下三件事再交给 skill:结果要帮你做什么判断或行动;什么必须保留、什么不准出现;结果不可变成什么。一次性的简单提问直接问就好,为它读几家厂商的官方页并不划算。skill 也不会测试它写出的提示词:正式依赖之前,先在目标平台用真实输入试几次。

取得 skill

skill 放在 GitHub:github.com/trigpoint-pub/agent-skills 的 skills/prompt-architect。目前版本 0.3.0,2026-11-07 以 experimental prerelease 发布(Release 页)。使用前提:一个能载入 SKILL.md 格式 skill 的 agent,以及可以上网读厂商页面。安装只在 0.2.0 时于 macOS 上的 Codex 桌面版验证过,skill 资料夹结构其后未变;0.3.0 在 Claude Code 上以直接指定 skill 路径的方式测过,未测安装。

装好之后,可以这样开始:

用 prompt-architect:写一份审查供应商合约、标出风险条款的提示词,在 Claude 上用。

回复应分三部分:摘要、提示词、使用说明。先看使用说明:每一项平台建议都应附有官方页网址与读取日期,没有出处的平台建议不应出现。完整的第一次使用教学(中英对照,以一份合成的会议纪录为例)见 FIRST-USE.md。

测试纪录在 VALIDATION.md,方法来源与清单维护方式在 docs/prompt-architect/SOURCES.md,两者都不随 skill 安装。官方来源清单按厂商分档,入口是 references/official-sources.md:档中写明该开哪一档,档首记有最近一次核对日期。问题回报请用 GitHub Issues,不承诺回复时限。