夜雨聆风学习资料网

ARTICLE · 1092353

AI 写的交付文档,甲方为什么一眼看出不像人写的?我给文档立了一份腔调禁词表(上)

AI 写的交付文档,甲方为什么一眼看出不像人写的?我给文档立了一份腔调禁词表(上)
用 AI 写交付文档写久了,最费工夫的是改口气:该讲做法的地方写成了提要求,该列范围的地方冒出一句“不含某某系统”,字都对,读着总差点意思。
这段时间我把改稿时反复碰到的问题攒成了一套规则,分三篇聊。
这篇先说问题:AI 味具体出在哪,我是按站位、腔调、禁词这个顺序一步步改的。
中篇说工具:这些规则怎么放进 AI 工具里,它什么时候读哪一条,哪些地方得我自己拍板。
下篇拿网上通用的去 AI 味技能来比一比,说说为什么还是得照着自己的活儿搭一套,以及从哪儿开始搭。
——

一、先定谁在说话

交付文档里说话的只有两方。
招标书、采购需求、技术需求表,是甲方在提要求,口气是“应建设”“应具备”“须提交”。有时我们也会代甲方起草建设方案,这时站的仍是甲方一侧,同样写要求。从投标开始,投标方案、实施方案、需规、设计、测试报告、汇报,都是我们交付方在说话,口气是“本项目采用”“系统提供”“按……推进”。
AI 最常出错就在这儿。它读过大量招标文件,一写实施方案就满篇“承建方应”“须”“不得”,像甲方在给我们派活;一写需规,干脆把招标条款原样搬进来,连“投标人须提供……”都没改。句子没毛病,身份错了。甲方读着会犯嘀咕:这是在给我提要求,还是在告诉我你们打算怎么做?
交付方这边还能再细分,每一类的语气也不一样:
  • 投标响应:对着评分条款写我方做法,附上证明材料;
  • 实施方案:写阶段、分工、进度,项目按什么节奏推进;
  • 需规、设计、测试类:写系统做成什么样,字段、状态、接口怎么对上;
  • 汇报:写我们的理解,以及拟定的推进路径。
需规要多说一句。它最终是给开发照着做的,“系统应支持……”本来就是需规的常见写法,这个“应”字没问题。需规跟招标书的差别在颗粒度:招标写一句“应具备统一身份认证能力”就够了,需规得写到用哪几类账号、登录走什么流程、认证失败怎么处理。只把招标那句抄过来,开发看完还是不知道该做什么。
甲方这边两类,交付方这边四类,我给每一类都写了一张卡片,一共六张,记下主语、语气和常见错法,自己管它叫“族卡”。动笔前先认清是哪一族,再往下写。
碰到标题含糊的,比如只叫“技术方案”“迁移方案”,它可能是代甲方起草的建设方案,也可能是我们自己的实施方案。这种情况不猜,先问清楚站在哪一方。

二、只有两种陈述

站位定下来以后,我给自己定了一条很硬的规矩:交付文档里只有两种说法。甲方那边只写要求,我们这边只写做法。写做法,就只写做了什么,不写没走的那条路。
这条规矩主要冲着一种句式:“不是 A,而是 B”。
AI 很爱用它,因为显得有观点。比如:“本方案不采用一次性切换,而是分批迁移。”甲方要的只是后半句。前半句等于先立个靶子再打掉,读的人要多绕一步,还可能被追问一次性切换为什么不行。改成“本项目分三批迁移,每批验证通过后再切下一批”,意思一样,信息还多了。
同一类的毛病还有几种:
  • “这样划分是为了便于……”,解释自己为什么这么写,删掉,直接写做法;
  • “本文件回答以下几个问题”,这种导读改成直接写本项目做什么;
  • 对话里临时起的缩写,没交代过就当专有名词用。
否定句也不用全删。规格里的状态约束、安全红线,本身就是要求,比如“部署失败时不覆盖已生效的模板”,这句要留着。它说的是做法的边界,跟“我们没走哪条路”是两回事。
说到这儿得交代一句:这个号的标题常用“不是……是……”。公众号要在列表里抢注意力,反差有用;交付文档要让甲方一眼看到做法,同样的句式就成了绕路。同一个句式,换个文体,加分就变成扣分。

三、五类腔调

站位对了,句子照样可能一股味。我把改稿时反复碰到的问题归成五类,每类举一两个例子。

1. 过程话混进正文

自己工作里说的话,写进了给甲方的文档。比如“源稿”“已冻结”,“待确认事项”当章节标题,还有“现网”。
“现网”单拎出来说,是因为嘴上天天挂着,AI 也就跟着写。现在的做法是落笔一律不用,按句子换成“在用系统”“现行系统”或“目前”,也不通篇换成同一个词。

2. 说明书腔

“本章说明……”“本方案规定……”,讲的是文件本身,甲方关心的是项目。
还有一种更隐蔽:范围里点名排除。“本期不含档案系统改造。”甲方读到会想,为什么要提它?范围那一章只列要做的对象和要做的事。

3. 站错位

第一节的问题落到句子上:实施方案里一连串“承建方应”“不得”“必须”;需规里出现“投标人须”“采购人应当”,或者只抄了招标那句“应具备……”,没往下落到字段和流程。

4. 空转结构

每节都套“目标:/主要工作:/输入:/输出:”,模板没要求也套;章标题底下先来一段什么都没说的总述;段末挂一串“见表 3、见图 5”,表却在两页之后。看着规整,内容一点没多。

5. AI 套话

“全方位赋能”“闭环落地”“显著提升用户体验”,还有“值得注意的是”后面跟一句常识。遇到就删,删完看这段还剩什么。剩不下东西,说明这段本来就是空的。
放一组改前改后:
改前:本章说明系统的数据迁移方案。本期不涉及档案系统。迁移工作将全方位保障数据安全,形成闭环管理。
改后:本项目把人员、组织、业务单据三类数据从现行系统迁到新平台,分三批执行。每批迁完按记录数和抽样字段核对,核对通过再开放使用。
改前那段三句话,分别踩了说明书腔、点名排除和套话,一件具体的事都没说。改后那段没有一个漂亮词,但甲方能看出迁什么、怎么迁、怎么算迁好了。

四、禁词放最后,而且分层放

一说去 AI 味,很多人第一反应是列一张禁词表。我一开始也这么干,后来碰到两个问题。
一是光查词,查不出站位错。“承建方应按期完成部署并提交验收材料”,每个词都干净,放进实施方案里,却成了甲方在给我们派活。换成“本项目第 6 周完成部署,随后提交验收材料”,说的是同一件事,站位就对了。所以禁词排在站位和腔调后面,当最后一道筛子。
二是表会越长越乱。某个客户不喜欢的叫法、某个项目的对外名称、金额口径,都往一张表里塞,换个项目就用不了,搞不好还会把上个客户的名字带进新文档。
现在我分三层放:
  • 全局层只放跨项目都成立的腔调,比如上面五类,一个客户名都不写;
  • 文档线这层:同一个项目里,实施方案、需规、测试报告各算一条文档线,每条线一份写作规范,放这份文档特有的禁词和写法;
  • 项目约定这层只记几条短的:对外怎么称呼、金额按什么口径。
换项目时,全局层原样带走,下面两层重新立。
——

带走清单

  • 动笔前先认:这份文档是甲方在提要求,还是我们在说做法
  • 标题含糊的(技术方案、迁移方案),先问清站在哪一方
  • 交付方只写做法;“不是 A 而是 B”只留 B
  • 需规里的“应”可以留,但要落到字段、流程和异常处理
  • 必要的否定留着:状态约束、安全红线
  • “现网”落笔不用,按句子换成在用系统、现行系统、目前
  • 范围里只写要做的,不点名不做的系统
  • 模板没要求,就不套“目标/输入/输出”标签
  • 禁词分三层放:全局腔调、文档线特例、项目短约定
——
站位、腔调、禁词,这篇说的是改什么、按什么顺序改。规则怎么分层才不会越写越乱,AI 又怎么知道这次该读哪一条,中篇接着说。
—— 明坤
明坤 ai产品协作笔记

相关学习资料