试试这个提示词,让大模型重写文档,让人看得懂

yidinghe 2026-09-13 12:47 1

重写设计文档,遵守下面的风格:
1. 禁止使用比喻性质的或肢体动作词,例如“接”、“跑”、“打”、“落”、“补”、“收”等等,除非是专业用语;
2. 主动使用逻辑衔接,用“但是”、“因此”、“那么”等连词来承接存在逻辑关系的上下句。
3. 逐句阅读文档内容并修改,不使用搜索和替换。
4. 按文件分配 sub agent ,避免多个 sub agent 写同一个文件。

对比效果如下(修改之前 vs 修改之后):


- 步骤应落在已登记的动作库上,由规划器组合
- 步骤应来自已登记的动作库,由规划器组合

- 每个步骤都能指回动作库中的登记动作。
- 每个步骤都能追溯到动作库中的登记动作。

- 样本库随仓库提交、启动不再灌数据,测试改回内存库
- 样本库随仓库提交、启动不再写入数据,测试改回内存库

- 取数通道收口这一意图不变。
- 取数通道只在本模块实现这一意图不变。

- 口径变化靠人看输出发现,执行一次真花一次 Provider 调用
- 口径变化需要由人阅读输出发现,执行一次会真实消耗一次 Provider 调用

- 工具落在 `hs-infra-access`,它是唯一持有数据库连接的模块
- 工具由 `hs-infra-access` 提供,它是唯一持有数据库连接的模块

- `roles` 为空就不写角色那半
- `roles` 为空就省略角色部分

- 模型可据此收紧查询
- 模型可据此缩小查询范围

- 不是模型能修的东西,如实冒泡。
- 不是模型能修的东西,如实向上抛出。

- 没有并发上限这个旋钮
- 没有控制并发上限的配置项

- 拼成给模型看的文本归本模块
- 本模块负责把它们拼成给模型看的文本

- 支持指标定义的注册与版本化(为审计留口)。
- 支持指标定义的注册与版本化(为审计预留位置)。

- 分账,防止一个人连点占满名额
- 按用户分摊,防止单个用户连续请求占满名额
最新回复 (13)
  • uh 09-13 14:08
    1
    我用的是这个 SKILL https://github.com/MrGeDiao/shuorenhua
  • QS0x01 09-13 14:39
    2
    别家的模型不知道,GPT 的模型写文档总是喜欢中英夹杂,然后使用极其罕见的自造词汇。由于没有上下文,你也不知道这个名词对应的是什么含义。
  • passive 09-13 14:48
    3
    AI 说的中文全是“爆内存”这样的网上口语,不加约束没法写进正式书面场合
  • netlous 09-13 15:11
    4
    @QS0x01 相比 Claude ,GPT 已经是在说很优美的人话了,比如 opus:

    “一个前置观察供你参考:这个窗口里既有种子入账 + 真跑开发,也可能夹着探针复测的尾巴”

    “判语:三连里只要 P0a 空转,P0c 的"没拦到"就不是"纪律好",而是"守卫瞎了"”

    “对照 §10 的赌注清单”

    “真正的深度审计是改完 .toml 之后的"postpatch 审计",那才有真东西可咬。”

    “树只能给它拆出来的维度上牙齿,没被结构化成节点的维度就是裸的。”

    还好现在已经不用 Claude 了,之前每天感觉像是在和古人说话(或者我才是古人),有 70%的脑细胞消耗在了理解中文上。

    而 GPT 的问题可能是太多废话和职场黑话。。。
  • seven777 09-13 18:03
    5
    中文"说人话"真的是个明确的需求.
    目前来说,我用过的 skill 都没有明显的效果, 基本上和 IDE/AGENT 不用 skill 时返回的内容质量相当.
    我的需求是说人话+少废话+文字最少+篇幅最短+顺序正确.
  • lujiaosama 09-13 18:16
    6
    @netlous 这啥呀,翻译成英文也看不懂啊
  • 383394544 09-13 18:54
    7
    这个不错,提供一些我的作法。需要严格告诉 AI 哪些词能用(不能用),不能直接说“禁黑话”。

    - 禁抬价词:赋能、抓手、颗粒度、沉淀、打法、势能、生态位、顶层设计、全链路、底层逻辑、
    拉齐、打通、对标、勾兑、倒逼、引爆点
    - 「颗粒度」按上下文换:单位、层级、精度、拆分口径。
    - 禁代指词:东西、那一套、一个形状、这种感觉、那么回事;换成它实际指的那个词:产物、改动、材料、问题、来源。
    - 禁万能动词:走、打。
    - 禁止对比句「不是 A 而是 B 」,除非 A 有明确出处。

    把这些原则告诉 Agents ,让它自己生成写作规范文档,再在 AGENTS.md 规定每次写技术文档前都要先看规范。
  • 383394544 09-13 18:57
    8
    @seven777 我和 AI 讨论过,AI 体的废话来源是 “AI 写作时倾向填满模版”,所以信息量不够时,它就会往里填废话。有没有发现几乎从来没人说 agents 干活时的终端机输出有废话?只有让它们写文档时会冒出一堆废话来。所以需要规定 AI 在写作前就“不产废话”,比事后删废话有用。
  • JasonYip 09-13 23:04
    9
    最近用 glm 各种奇怪的黑话 什么兑底、辅助武装、派发守卫、清空弹药 太难崩了
  • leonleung 09-13 23:08
    10
    @netlous #4 GPT Astra 也不少黑话。头疼
  • liuliuliuliu 09-13 23:13
    11
    哈哈哈,其实很搞笑
  • Jooooooooo 09-13 23:26
    12
    现在看起来,如果一个文章是要给人看的,人要看这个文章获得信息,那就不应该由 AI 写。AI 写不出给人看的文章。

    AI 只适合写给 AI 看的文章,比如代码库的 agents.md
  • tianhehechu 09-14 00:24
    13
    @seven777 最好的提示词,是要求仿照史记和汉书写成文言文,会马上抛弃那些现代汉语污染。
* 帖子来源V2EX
返回