一键复制内容 · 书写格式约定

> 文件性质:全局重要 — 新建任何"粘进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| {时间} | {类型} | {内容} | |


规则四 · .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`(第零条"有问题不猜测"+三项分离)