> 文件性质:全局重要 — 新建任何"粘进AI对话框即可执行"的内容时必须遵守
> 适用对象:workflows/ 下的 .md 工作流 · method/ 下的分享页 · automation 计划 prompt
> 版本:v1.0 | 创建:2026-07-21 | 状态:生效中
每条可执行指令 = 动作词 + 对象(WHAT) + 方法(HOW) + 位置(WHERE)
缺任何一个字段 → 视为"规格描述",非"操作指令"。AI 不会执行模糊指令——它会把它写到报告里。
| ❌ 歧义写法 | ✅ 可执行写法 | 说明 |
|-----------|------------|------|
| "帮我分析这段文本" | "从以下三个维度逐段分析:①句式规整度 ②词汇重复率 ③逻辑排布。对每个可疑段落标注位置和原因。" | 补维度 + 补输出格式 |
| "帮我搭建一个智能体" | "通过三步流程搭建:第一步判断平台 → 第二步写角色描述 → 第三步发布测试。每次只问我一个问题。" | 补方法 + 补步骤 |
| "把问题分成三档" | "按以下标准分成三档:必须马上动(安全/合规/客户流失)、观察一周再定(流程优化/效率提升)、暂时别碰(人事敏感/历史遗留/信息不足)" | 补分类标准 |
| "帮我写" | "输出格式:| 标题 | 正文 | 标签 |。每段正文150字以内。平台:小红书风格。" | 补输出格式 + 平台约束 |
| ❌ 歧义写法 | ✅ 可执行写法 |
|-----------|------------|
| "修改文件" | 用 Edit 工具,目标文件=D:/path/to/file.html,old_string=精确锚点文本,new_string=替换后文本 |
| "追加一行" | 用 Edit 工具,目标文件=D:/path/to/file.html,old_string=插入位置上方的唯一文本,new_string=old_string + \n新行内容 |
| "更新状态" | 用 Write 工具,写入 D:/path/to/state.json,内容={"status":"completed","updated_at":"..."} |
| "注册到列表" | 用 Edit 工具,目标文件=D:/path/to/file.html,old_string=// 新增项↓在此追加,new_string= {新条目},\n // 新增项↓在此追加 |
判断标准:如果一句话出现"修改/更新/追加/注册/写入"但没有出现文件路径和工具名 → 歧义。
| ❌ 歧义写法 | ✅ 可执行写法 |
|-----------|------------|
| "报警" | 在聊天框中输出:⚠️ 阶段X超时:{描述}。同时用 cat >> 追加 ERROR 行到 D:/path/pipeline-log.md |
| "提醒用户" | 在聊天框中输出:⚠️ 发现{问题},建议{动作} |
| "通知" | 追加到 D:/path/notifications.md:| {时间} | {类型} | {内容} | |
每个面向用户的一键复制内容必须包含以下五段:
``
① 角色定义 — "你是XX助手。你的任务:..."
② 输入说明 — "请提供以下信息:〔参数1〕〔参数2〕"
③ 执行方法 — "按以下步骤/维度执行:①... ②... ③..."
④ 输出格式 — "输出格式:| 列1 | 列2 |..."
⑤ 约束条件 — "不要/禁止/不允许..."
`
特别关注第③段——这是"描述vs执行"分歧最高发区域。 方法步骤必须有可量化的判断标准,不能仅靠"帮我分析""帮我判断"这类开放动词。
规则五 · 自动化计划 prompt 的致命陷阱
在 WorkBuddy 自动化计划的 prompt 中,以下写法会直接导致操作不被执行(AI 写进报告而非执行文件修改):
| ❌ 致命写法 | ✅ 正确写法 |
|----------|----------|
| "在 AD_REGISTRY 追加一行" | 用 Edit 工具,目标文件=
D:/path/tools/ad-to-video.html,old_string=// 新增↓在此追加,new_string= { name: '标题', url: '...' },\n // 新增↓在此追加 |
| "必须给每个 .slide 添加 data-duration 属性" | 用 Edit 工具,目标文件=
D:/path/method/xxx-ad.html,old_string=<div class="slide s1">,new_string=<div class="slide s1" data-duration="3.2" data-beats="2">。按此模式逐 slide s2-s10 执行。 |
| "更新 sitemap" | 用 Edit 工具,目标文件=
D:/path/sitemap.xml,old_string=<!-- 电子书 -->,new_string= <url>...</url>\n <!-- 电子书 --> |
规则:自动化 prompt 中任何涉及文件修改的操作,必须以
工具名,目标文件=绝对路径,old_string=...,new_string=... 的完整格式书写。不满足此格式的 → 识别为歧义,必须补全。
修订记录
| 时间 | 版本 | 修改内容 | 修改人 |
|------|:---:|------|------|
| 2026-07-21 13:50 | v1.0 | 创建全局书写格式约定。来源:SEO/GEO 全站诊断发现(同一根因在3个位置重复:AD_REGISTRY/data-duration/og:image) + 组织路由引擎文档5处歧义 + 用户.md 3中2低。五条规则覆盖用户内容、自动化计划、工程组文档三类场景。 | AI-Logic |
参考资料
修复案例: 组织路由引擎/tmp/2026-07-21_SEO-GEO修复清单.md(A-E 五项修复的正确模板范例)
诊断报告: D:/LobsterPlayPool/.workbuddy/memory/2026-07-21.md(SEO/GEO 全站审计 + 组织路由引擎文档审计 + 用户.md 审计)
开发规范: 组织路由引擎/开发规范.md`(第零条"有问题不猜测"+三项分离)