• 请不要在回答技术问题时复制粘贴 AI 生成的内容
yidinghe
V2EX  ›  程序员

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

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

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

    - 步骤应落在已登记的动作库上,由规划器组合
    - 步骤应来自已登记的动作库,由规划器组合
    
    - 每个步骤都能指回动作库中的登记动作。
    - 每个步骤都能追溯到动作库中的登记动作。
    
    - 样本库随仓库提交、启动不再灌数据,测试改回内存库
    - 样本库随仓库提交、启动不再写入数据,测试改回内存库
    
    - 取数通道收口这一意图不变。
    - 取数通道只在本模块实现这一意图不变。
    
    - 口径变化靠人看输出发现,执行一次真花一次 Provider 调用
    - 口径变化需要由人阅读输出发现,执行一次会真实消耗一次 Provider 调用
    
    - 工具落在 `hs-infra-access`,它是唯一持有数据库连接的模块
    - 工具由 `hs-infra-access` 提供,它是唯一持有数据库连接的模块
    
    - `roles` 为空就不写角色那半
    - `roles` 为空就省略角色部分
    
    - 模型可据此收紧查询
    - 模型可据此缩小查询范围
    
    - 不是模型能修的东西,如实冒泡。
    - 不是模型能修的东西,如实向上抛出。
    
    - 没有并发上限这个旋钮
    - 没有控制并发上限的配置项
    
    - 拼成给模型看的文本归本模块
    - 本模块负责把它们拼成给模型看的文本
    
    - 支持指标定义的注册与版本化(为审计留口)。
    - 支持指标定义的注册与版本化(为审计预留位置)。
    
    - 分账,防止一个人连点占满名额
    - 按用户分摊,防止单个用户连续请求占满名额
    
    13 replies    2026-09-14 00:24:46 +08:00
    uh
        1
    uh  
       22h 15m ago
    QS0x01
        2
    QS0x01  
       21h 44m ago
    别家的模型不知道,GPT 的模型写文档总是喜欢中英夹杂,然后使用极其罕见的自造词汇。由于没有上下文,你也不知道这个名词对应的是什么含义。
    passive
        3
    passive  
       21h 34m ago via Android
    AI 说的中文全是“爆内存”这样的网上口语,不加约束没法写进正式书面场合
    netlous
        4
    netlous  
       21h 11m ago   ❤️ 1
    @QS0x01 相比 Claude ,GPT 已经是在说很优美的人话了,比如 opus:

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

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

    “对照 §10 的赌注清单”

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

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

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

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

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

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

    AI 只适合写给 AI 看的文章,比如代码库的 agents.md
    tianhehechu
        13
    tianhehechu  
       11h 58m ago
    @seven777 最好的提示词,是要求仿照史记和汉书写成文言文,会马上抛弃那些现代汉语污染。
    About   ·   Help   ·   Advertise   ·   Blog   ·   API   ·   FAQ   ·   Privacy   ·   Solana   ·   3744 Online   Highest 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 96ms · UTC 04:23 · PVG 12:23 · LAX 21:23 · JFK 00:23
    ♥ Do have faith in what you're doing.