用途
fix-writer 是 improve-search-visibility 操作手册中的一个步骤，其作用是把一条已经排定优先级的修复项（ranked fix）转化为可以直接粘贴使用的站点文案或代码，并同时撰写页面简报（page briefs）。
主要能力
- 读取多个参考文件：finished-fix-examples.md、gap-to-fix.md、prioritising.md、page-map.md，以及修复或简报所对应的页面地图行、品牌语气、产品记录、CMS 及发布负责人信息。
- 撰写具体变更内容：精确的 title/meta/H1/开头段落、问答块、标记、字段值、robots 行、列表文案或草拟的收录请求，并以 CMS 的术语表达（例如在 Shopify / WordPress / Webflow 中的具体位置；标记作为对主题现有块的编辑，使用实时值，而非第二个硬编码块）。
- 对草稿中的每个事实性句子标注来源（“Claims you may use”事实、产品记录字段或 [PROOF NEEDED]），以便 claims gate 决定保留、改写或删除。
- 每个修复项输出两个版本：报告“What to do”部分使用通俗语言，说明变更内容与位置、执行人与耗时、优先级理由（以买家问题表述，而非问题 id）、验证方式；报告最后一部分“For whoever edits your site”提供成品文案、字段值或代码及确切位置，以及展示时间、风险和撤销方式。
- 撰写页面简报（页面地图中“needed”行），输出到 search/briefs/<page-slug>.md，格式遵循 page-map.md，作为 make-content 的简报输入。
- 将两个版本写入报告，工作副本写入 search/fixes/<date>.md，并生成简报文件。
使用方式
该技能由 improve-search-visibility 操作手册调用，作为其中一个步骤运行。它读取指定的参考文件和上下文信息，按照请求中的数量和任务范围（来自 seo-jobs.md）执行。对于技术性发现，若代码/CMS 访问权限不足，则输出精确的工程交接（受影响 URL、观察到的缺陷、预期结果、验证及风险/撤销），而非猜测实现。工作量估算使用 Agent: <time> - Human: <active time> 格式。
适用场景
适用于 SEO 可见性改进流程中，需要将已排定优先级的修复项转化为可执行文案或代码，并需要附带负责人、风险和撤销方式的场景。也适用于需要为页面地图中标记为“needed”的页面撰写简报的场景。
限制
- 声明由 claims-gate 技能决定，该原子技能本身从不决定声明。
- 实时页面仅提供普通产品事实（名称、价格、尺寸、列出的成分、使用方法）——价格需从实时页面重新读取；评分和评论数仅作为“Claims you may use”事实出现，或出现在镜像页面所示评论的标记中。
- 品牌自身的营销话术也是声明（如“closes the loop”、“self-improving”、“growth outcomes”），未经签署确认将被删除或改写为普通事实，或显示为 [needs your sign-off: …]，绝不作为可发布内容粘贴到修复文案中。
- 除非每个单元格都来自该竞品自身页面并在本次运行中阅读和引用，否则不得包含关于竞品的比较表或外联话术；否则将竞品排除在外。竞品事实仅来自竞品自身页面，在本次运行中阅读并注明日期，绝不来自列表或评论网站，且仅在人类允许提及竞品时使用。
- 绝不输出“add an FAQ”、“improve E-E-A-T”或任何没有成品文本的指令；绝不编造统计数据、价格、日期或评论；绝不承诺 FAQ 标记会显示为富媒体结果。
- 简报中提及所回答的问题时使用文字而非 id。