撰写石墨AI人物动作提示词时，有一个关键点常常被忽略：你必须明确告诉AI，这个动作具体发生在哪个业务环节、由谁执行、在文档的哪个位置触发。否则，生成的描述就会脱离实际协作流程，变成孤立的动作描写——比如把“同步风险”简单写成“在飞书群发消息”，而实际上你需要的是“在石墨文档《Q3风控看板》评论区@运维负责人并粘贴日志截图”。

先锁定动作发生的石墨文档场景

打开石墨文档，进入目标文档，点击右上角「AI助手」图标，然后在对话框里第一句就写清楚：“本动作描述用于【项目复盘文档】第3节‘关键节点回溯’区块，需嵌入到‘责任人动作’表格第三行。”这一步如果不写，AI默认按通用场景生成，结果往往与实际需求南辕北辙。

如果文档有命名规范，一定要带入其中。例如：“所有动作描述须匹配我司石墨文档命名规则：【复盘】+项目名+日期，如【复盘】CRM权限迁移-0610”。这样AI才能在正确的语境中生成符合预期的动作描述。

明确动作执行者身份与权限边界

如何让AI理解角色和权限？以下两种方法非常实用。

方法一：用岗位+权限组合定义角色
“前端开发组长（拥有石墨空间‘技术文档’编辑权限，无‘客户资料’查看权限）在评审通过后，将接口变更说明复制进《API对接清单》文档第4.1节，并设置仅‘后端组’可见。” —— 这样AI就能明确谁执行什么操作、能做什么、不能做什么。

方法二：用操作路径反推权限前提
“当用户点击文档右上角【分享】→【复制链接】→粘贴至飞书群时，该动作隐含前提：当前文档已开启‘允许他人复制链接’开关（设置→文档权限→链接访问权限）。” 反过来思考，如果权限没有写清楚，AI会默认用户拥有全部权限，从而生成“直接导出PDF”这类实际不可行的动作描述。

未声明权限状态时，AI会默认用户拥有全部权限，导致生成“直接导出PDF”等实际不可行动作——这是最常踩的坑之一。

绑定真实协作摩擦点来校验动作合理性

仅有动作描述还不够，必须让它经得起实际协作的检验。方法是将真实发生过的问题写进提示词。

第一步：写出最近一次因动作模糊引发的阻塞事件
“6月8日14:22，测试同学在《UAT用例库》文档评论区留言：‘第5条用例没写预期结果，没法执行’——当时我们临时补填了3处，但未更新文档标题版本号。” 这个真实案例能让AI明白：动作描述里必须包含预期结果和版本同步的考虑。

第二步：把该事件作为判断标尺写入提示词末尾
“若生成的动作描述中未体现‘预期结果填写位置’或‘版本号同步机制’，则整条重写。” —— 这样AI就有了明确的校验标准。

第三步：强制加入时间戳锚点
“所有动作描述中必须包含一个精确到分钟的时间标记，例如‘6月12日15:17，在文档末尾新增【预期结果】字段并置顶’。” 时间戳让动作描述更加具体，也便于后续追溯。